logoBack to App page
Entra ID (Azure AD) Attributes Sync for Jira
Documentation
FAQ
Release notes
logoBack to App page
Entra ID (Azure AD) Attributes Sync 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

Info

Deviniti’s Rovo Assistant provides access to a virtual assistant that helps you with configuration, installation, and troubleshooting, enabling quicker and faster navigation through documentation. See Deviniti’s Rovo Assistant documentation or find it on the Atlassian Marketplace for more information.

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.

Quick Guide

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

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.
To learn about attribute types supported by the Copy data post function, see the App feature overview and functionality guide chapter.

  1. Select the custom field that should be updated.
    Supported Jira custom fields:
  • Text field (single-line)
  • Text field (multi-line)
Note

Go to the Displaying Azure AD data in a custom field to see how to configure a generated table.

  • Text field (read-only)
  • User picker (single user)
  • User picker (multiple users)
  • Select List (single choice)
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. If the user selected in the issue can’t be found in Azure AD, decide whether the fields filled by the post function should keep their current values or be cleared when the user can’t be retrieved from the directory.
Jira Active Directory integration with Azure AD Attributes - Updating Azure AD data in the workflow: Choose how to handle users not found in Azure AD
Azure AD Attributes for Jira - Updating Azure AD data in the workflow: Choose how to handle users not found in Azure AD
  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.

Need help?

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

ON THIS PAGE

    Back to top