Mapping Azure Active Directory data to a custom field

Learn how to configure a custom field in order to display information from Azure Active Directory

Start mapping

Here is how to start mapping to a custom field:

Steps

1. Open the global Settings from the top right menu.
2. Select Apps from the drop down list.
3. Select Synchronization from the left hand side menu.
4. Click Map new field.

Result

You will be brought to a configuration screen where you can choose the custom field type, select Azure Active Directory attributes to be mapped, and decide whose data should be displayed.

Select field

The first drop-down menu lets you choose a custom field to display Azure Active Directory information. You can either select an existing custom field or create a new one.

Use an existing custom field

Existing custom fields of the types listed below will work with Azure AD Attributes Sync for Jira:

• Text Field (multi-line)
• Text Field (single-line)
• Text Field (read-only)
• User Picker (single user)
• User Picker (multiple users)
• Select List (single choice)

Steps

To choose an existing custom field:

1. Expand the Select field options.
2. Select the first tab, Existing fields.
3. Search for the custom field you’d like to use.

Clicking on the selected custom field will save your choice.

Tip

If you choose the Select List (single choice) field type, you’ll see a toggle. If you enable it, each individual synchronization will add one option to the single select list based on the chosen attribute’s value from Azure AD.

Create a new field

You can create a new custom field directly from the mapping screen.

Steps

To create a new custom field:

1. Expand the Select field options.

2. Go to the second tab, Create new.

3. Select the Custom field type. There are six types available:

   • Text Field (multi-line)
   • Text Field (single-line)
   • Text Field (read-only)
   • User Picker (single user)
   • User Picker (multiple users)
   • Select List (single choice)

4. Give the custom field a name under the Field label.

5. Add a description (optional).

6. Click Create.

Select attributes

In the next step, you can choose the Azure Active Directory attributes that should be displayed in the custom field. You may select as many as you need.

Steps

To select Azure Active Directory attributes:

1. Click Select attributes.
2. Click on the arrow to expand the drop-down list.
3. Select the attributes to be displayed in the custom field.

Select user

In the last configuration step, you can choose whose data will be displayed in the issue. You can only choose one user for one custom field.

Steps

To select a user whose attributes will be displayed in the custom field:

1. Click Select user.
2. Click on the arrow to expand the drop-down list.
3. Select one of those three options:

• Assignee
• Reporter
• User Picker (single user)

Remember to save the settings:

Result

You’ll see a success notification, and the mapping will be added to the list of mappings under its target view. To trigger a synchronization, create an issue or make an update on a chosen issue.

By choosing the Select list (single choice) custom field type and turning on the toggle, you’ll see an icon. The icon appears to inform you that a value from Azure AD is added to the single select list if it doesn’t already exist on it.

Guick guide

Click through the live demo to see how to create a mapping to a new custom field.

Mapping options

You can edit custom fields, see issue screen configuration, or delete field mapping by clicking the three dots menu next to the selected mapping. Also, you can enable/disable the synchronization using the toggle button.