App page
Azure AD Attributes for Jira
Azure AD Attributes for Jira
Documentation
FAQ
Release notes
Last updated Oct 28, 2024

Copying Azure Active Directory data in the workflow

Discover the Azure AD Sync-Copy data from Azure AD post function

You can choose to copy Azure Active Directory attributes upon a certain workflow transition.

Example

If a request requires an approval, you can set up the post function to automatically populate the name of the requestor’s line manager in the ticket.

Tip

The Manager attribute can be mapped to the User Picker (multiple users) and the User Picker (single user) Jira custom fields.

Configure post function

Steps

Here is how to configure the Azure AD Sync-Copy data from Azure AD post function:

  1. Navigate to Project settings > Workflows.
  2. Select the workflow you’d like to use and click Edit > Diagram.
  3. Click on the transition upon which the Azure AD data should be updated.
  4. Open the Post functions settings and click Add post function.
  5. Select the Azure AD Sync-Copy data from Azure AD post function.
  6. Click Add.
    Jira Active Directory integration with Azure AD Attributes - Updating Azure AD data in the workflow: Add post function
    Azure AD Attributes for Jira - Updating Azure AD data in the workflow: Add post function
  7. Select whose data should be updated.

Supported user fields:

  • Assignee
  • Reporter
  • User picker
  1. Select Azure AD attributes to copy data from.
Tip

Apart from mapping attributes from the User properties group, you can also map custom user attributes to:

  • Text Field (multi-line)
  • Text Field (single-line)
  • Text Field (read-only)
  • Select List (single choice)

To learn more about the types of available custom fields, see the Displaying Azure AD Data in a custom field chapter.

  1. Select the custom field that should be updated.
    Supported Jira custom fields:
  • Text field (single-line)
  • Text field (multi-line)
  • Text field (read-only)
  • User picker (single user)
  • User picker (multiple users)
  • Select List (single choice)
Note

Below, you’ll find which Azure AD attributes can be copied to the Select List (single choice) custom field:

  • Business phone
  • City
  • Company name
  • Country
  • Department
  • Display name
  • Employee ID
  • First name
  • Job title
  • Last name
  • Mail
  • Mobile phone
  • Office location
  • Street address

    Additional information:
  • Only one attribute can be used with the Select List (single choice) custom field. After selecting an attribute, you’ll see a notification One option allowed for this field type, and you won’t be able to select another attribute.
Tip

If you choose the Select List (single choice) custom field, a toggle will appear. When enabled, each individual post function configuration will add one option to the single select list (if it doesn’t already exist on the list) based on the chosen attribute’s value from Azure AD.

Jira Active Directory integration with Azure AD Attributes - Updating Azure AD data in the workflow: Adding attributes to single select field type
Azure AD Attributes for Jira - Updating Azure AD data in the workflow: Adding attributes to single select field type
  1. Click Add.
    Jira Active Directory integration with Azure AD Attributes - Updating Azure AD data in the workflow: Configure post function
    Azure AD Attributes for Jira - Updating Azure AD data in the workflow: Configure post function
  2. Click Publish Draft.
    Note that the post function configuration details are visible on the post functions list.
    Jira Active Directory integration with Azure AD Attributes - Updating Azure AD data in the workflow: Publish draft
    Azure AD Attributes for Jira - Updating Azure AD data in the workflow: Publish draft
Note

You can select multiple attributes for Text Field (single line) and Text Field (multi line), User Picker (multiple users), and Text Field (read only) but only one attribute for a User Picker (single user).

Warning

Remember to always add the custom field to both the Create issue and the Edit issue screen. Otherwise, the synchronization won’t work.

Result

Post functions activate during an issue status change, so to trigger the Copy data post function, change the status of a task according to your post function configuration.

Note

When multiple attributes are copied to the Text Field (single-line), Text Field (multi line), or Text Field (read only), they’ll be displayed separated by a semicolon.
However, if the total character count exceeds 255 for the Text Field (single-line) and Text Field (read only) and 32767 for the Text Field (multi line), then any additional attributes beyond that count won’t be displayed.

Quick Guide

Click through the live demo to see how to set up the post function.

Need help?

If you can’t find the answer you need in our documentation, raise a support request.