- Get started
- Installation Info
- Connecting app to Azure AD
- Matching users
- Azure AD permissions
- Data collection
- Synchronization
- Mapping Azure AD data to a custom field
- Displaying Azure AD data in a custom field
- Displaying Azure AD data in the Issue View and Request Details View
- Supported Azure AD attributes
- Custom user attributes
- Mail notifications
- Post functions
- Copying Azure AD data to Jira workflow
- Updating user's attributes in Azure AD using Jira workflow
Displaying Azure Active Directory data in a custom field
Learn more about displaying and updating Azure Active Directory attributes in Jira custom fields
Azure AD Attributes Sync for Jira allows you to synchronize user details from Azure Active Directory with Jira custom fields. This way, you can display Azure Active Directory information on the Issue View and build further processes based on that data.
What is more, the synchronization allows you to copy the user’s line manager from Azure Active Directory into a custom field, for example as the request approver, or display the Manager attribute in our Azure Active Directory Panel on the Issue Context. In order to make use of those features, you’ll need to map Azure Active Directory attributes to a custom field.
Azure AD Attributes Sync for Jira displays Azure Active Directory user data in a custom field in several formats, depending on your synchronization settings. Here is what they look like in the issue view (scroll down to read the descriptions):
- Text Field (multi-line) generates a table with all mapped Azure Active Directory attributes. We recommend it for displaying multiple attributes in one data set.
- Text Field (single-line) displays the data in a one-line field where different attributes are divided with semicolons. We recommend it only for displaying single attributes.
- Text Field (read only) displays the data that won’t be editable manually.
- User Picker (single user) displays the line manager of the issue Assignee or Reporter, depending on your configuration. You can also set it up as a classic User Picker (single user) that lets you choose whose data to display.
- User Picker (multiple users) displays several roles (for example, Managers or Sponsors) in one field.
- Select List (single choice) displays a drop-down list of options for users to select from.
In order to display the data in a proper table you need to change the field’s format to Wiki Style Renderer. Here is a short guide on how to change it:
- Navigate to the global Settings > Issues > Field configurations.
- Choose a field configuration scheme.
- Find the right configuration and the custom field that holds the Azure AD attribute value.
- Select the text field and go to Renderers.
- Select the Wiki Style Renderer from the list and click Update.
Remember to always add the custom field to both the Create issue and the Edit issue screen. Otherwise, the synchronization won’t work.
Manage data updates
The data from Azure Active Directory is getting synchronized after following events:
- Issue Creation - every newly created issue contains the latest Azure Active Directory information.
- Issue Update - in order to update an existing issue, change the value of any field within it, like summary, description, and other fields.
- Status change - by setting up the post function in your project’s workflow you can define upon which status change the data should be synchronized. Learn more about it in the Updating Azure AD data in the workflow chapter.
Refresh the browser session to make sure that the synchronization took place.
Not every change made to an issue results in Azure Active Directory synchronization. For example, there will be no data updates after adding comments or attachments. Only changing values of the fields triggers an update.
If you can’t find the answer you need in our documentation, raise a support request.
