Human resource assistant, Human resource manager, Payroll administrator
Business process
Develop people strategy
Menu item
HcmUnionAgreement
Main table
HcmUnionAgreement
Data entity
HcmLaborUnionAgreementEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone
1What it is and why
What it is
A setup page where you record union agreements, which link positions to the labor unions that negotiated them, with contract periods.
What you do here
Use this page to record each agreement with a labor union, the legal entity that holds the contract, and the periods the contract is valid for.
Example
For example, BEAT records the agreement UCA - Consultants for legal entity BEAT with union UCA, signed 15 December 2025 and effective 1 January 2026 to 31 December 2028; the 15 consultant positions are linked to it on their Labor union FastTab.
The page in Dynamics 365. page title tab to open what to set or check
About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.
Setup steps on this page
Set up Union agreement
Use this page to record each agreement with a labor union, the legal entity that holds the contract, and the periods the contract is valid for.
Steps from Microsoft
Go to Human resources > Setup > Union agreement.
Pick the Legal entity above the list and use the Filter box to find an agreement.
Select New and enter the Union agreement and Labor union, and type the Agreement description.
Expand Agreement Detail and Notes for the terms of the agreement.
Select Save; select Delete to remove a selected agreement.
One agreement per contract and legal entity, naming the labor union, with Date signed and the effective and expiration period of the contractPositions link to the agreement for a legal entity, and the position union agreement carries the agreement's validity dates to payroll.
Human resource assistant maintains the agreements; Human resource manager and Payroll administrator view them. No Feature management feature is needed for this page.
Shared table with a legal entity on each agreement: Data management lists the Labor union agreement entity as shared, and each agreement names the legal entity that holds the contract. Checked in Dynamics 365
Can it be undone
Hard to reverse: Agreements are linked to positions with validity dates, so changes need to be carried through to the positions that use them.
If you change it later
Position union agreements carry the agreement name, labor union, legal entity and valid from and to dates, and are passed to payroll through the Position Union Agreement entity, so changing an agreement's dates or union reaches the positions and payroll. Microsoft Learn
Technical architect
6Technical
Menu item
HcmUnionAgreementChecked in Dynamics 365
Form
HcmUnionAgreementChecked in Dynamics 365
Table
HcmUnionAgreementShown as “UNION AGREEMENT” in Record infoKey field: LaborUnion_UnionID, AgreementName, LegalEntity_DataAreaChecked in Dynamics 365
Data entities
HcmLaborUnionAgreementEntityLabor union agreement Checked in Dynamics 365HcmUnionAgreementDurationEntityUnion agreement duration (The effective and expiration periods of an agreement.)
Who can open it
PrivilegesMaintain union agreements HcmUnionAgreementMaintainView union agreements HcmUnionAgreementViewDutiesEnable maintenance of labor union position and employee relationships HcmLaborUnionProcessEnableInquire into labor union position and employee relationships HcmLaborUnionProcessInquireEnable maintenance of labor unions and labor union agreements HcmLaborUnionSetupEnableInquire into labor union position and employee relationships HcmLaborUnionSetupInquire3 security rolesHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorChecked in Dynamics 365
Roles to set it up and use it
To set it up or change itHuman resource assistant HcmHumanResourceAssistantTo use itHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer
7Developer
Open it by URL
https://<your-environment>/?mi=HcmUnionAgreement
Integrate with
HcmLaborUnionAgreementEntity data entity Checked in Dynamics 365
Data migration
HcmLaborUnionAgreementEntity Labor union agreement. Shared table; each agreement names its legal entity.HcmUnionAgreementDurationEntity Union agreement duration: the contract periods.Load order: Load with the Jobs and positions template after Labor unions and before Position union agreement.Load first: HcmLaborUnionEntityMicrosoft Learn