Mapping Azure AD data to a custom field

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

Start mapping

Here is how to start mapping 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 AD attributes to be mapped, and decide whose data should be displayed.

Select field

First drop down lets you choose a custom field to be used for displaying Azure AD 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 Sync:

• Text Field (multi-line)
• Text Field (single-line)
• Text Field (read-only)
• User Picker (single user)

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.

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 four types available:

   • Text Field (multi-line)
   • Text Field (single-line)
   • Text Field (read-only)
   • User Picker (single user)

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 AD attributes that should be displayed in the custom field. You may select as many as you need.

Steps

To select Azure AD 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. For one custom field you can only choose one user.

Steps

To select 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: