Microsoft Entra ID Governance
Governance

Lifecycle Workflow Sync Attributes

In brief

The Workday attribute table now consistently formats all example rows with the required delimiters.

What Entra admins need to know

Admins can read the synchronization mapping examples more clearly; no action is required.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Workflows contain specific tasks, which can run automatically against users based on the specified execution conditions. Automatic workflow scheduling is supported based on the employeeHireDate and employeeLeaveDateTime user attributes in Microsoft Entra ID.

To take full advantage of Lifecycle Workflows, user provisioning should be automated, and the relevant scheduling attributes should be synchronized.

Scheduling relevant attributes

The following table shows the relevant scheduling (trigger) attributes and the methods of synchronization that are supported.

Attribute Type Supported in HR Inbound Provisioning Supported in Microsoft Entra Connect cloud sync Supported in Microsoft Entra Connect Sync
employeeHireDate DateTimeOffset Yes Yes Yes
employeeLeaveDateTime DateTimeOffset Yes Yes Yes

The expression examples in the table use endDate for SAP and StatusHireDate for Workday. However, you can opt to use different attributes.

For example, you might use StatusContinuousFirstDayOfWork instead of StatusHireDate for Workday. In this instance your expression would be:

FormatDateTime([StatusContinuousFirstDayOfWork], , "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")

HR Attribute HR System Scenario Microsoft Entra attribute
StatusHireDate Workday Joiner EmployeeHireDate
StatusContinuousFirstDayOfWork Workday Joiner EmployeeHireDate
StatusDateEnteredWorkforce Workday Joiner EmployeeHireDate
StatusOriginalHireDate Workday Joiner EmployeeHireDate
StatusEndEmploymentDate Workday Leaver EmployeeLeaveDateTime
StatusResignationDate Workday Leaver EmployeeLeaveDateTime
StatusRetirementDate Workday Leaver EmployeeLeaveDateTime
  1. Under Configuration, select your configuration.
  2. Select Click to edit mappings. This link opens the Attribute mappings screen.
  3. Select Add attribute.
  4. Fill in the following information:
    • Mapping Type: Direct
    • Source attribute: msDS-cloudExtensionAttribute1
    • Default value: Leave blank
    • Apply this mapping: Always :::image type="content" source="media/how-to-lifecycle-workflow-sync-attributes/edit-cloud-attribute-mapping.png" alt-text="Screenshot of the cloud attribute mapping.":::
  5. Select Apply.
  6. Back on the Attribute mappings screen, you should see your new attribute mapping.
  7. Select Save schema.

For more information on attributes, see Attribute mapping in Microsoft Entra Connect cloud sync. Screenshot of creating inbound synchronization rule transformations.

  1. Select Add.
  2. In the Synchronization Rules Editor, ensure the direction at the top is set to Outbound.
  3. Select Add Rule.
  4. On the Create Outbound synchronization rule screen, enter the following information and select Next.
    • Name: Out to Microsoft Entra ID - EmployeeHireDate
    • Connected System: <your tenant>

Edit attribute mapping in the provisioning application

After you set up your provisioning application, you can edit its attribute mapping. When the app is created, you get a list of default mappings between your HRM and Active Directory. From there, you can either edit the existing mapping or add a new mapping.

To update this mapping, follow these steps:

:::image type="content" source="media/how-to-lifecycle-workflow-sync-attributes/edit-attribute-list.png" alt-text="Screenshot of source API list.":::
  1. Select Save.

  2. From there, you must map the HRM attributes to the added Active Directory attributes. To do this, Add New Mapping using an Expression.

  3. Your expression must match the formatting found in the Understanding EmployeeHireDate and EmployeeLeaveDateTime formatting section. :::image type="content" source="media/how-to-lifecycle-workflow-sync-attributes/attribute-formatting-expression.png" alt-text="Screenshot of setting attribute format.":::

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…