Page Comparison

Starting with version 2.0 you can display user profile fields in JIRA issues. This will at the same time allow you to search for these fields in the JIRA search. Below you will find the necessary configuration steps.

1. Create a Custom Field

First you will need to create a custom field in JIRA, which will be mapped to a user profile field.

1. Go to the Administration (cog icon) >Issues > Custom fields (under the heading Fields).
2. Click "Add custom field" at the top right.
3. Click "Advanced" on the left and search for "User Profile Field". (see image 1 below)
   
4. Choose "User Profile Field" and click "Next". 
5. Enter a name and a description (optional) (see Best Practice)
   
6. Click "Create".
7. Choose a screen/screens where the field should be displayed and confirm with "Update" (see Best Practice)

Image 1: Create a Custom Field (click to enlarge)

Best Practice

Anchor
best best

• Choose a name which is self-explanatory in the context of the purpose of this field. The name you choose for the custom field will be used in the JIRA search.
  
• It is not recommended to display the field on an edit screen. Changes to the field value can only be made in the corresponding user profile. Putting the field on an edit screen might raise confusion why the value cannot be edited.
  

2. Map the Custom Field to a Profile Field

Now that you have set up a custom field, you can map it to a user profile field an choose a search template.

1. Go to the Administration (cog icon) > Add-ons > User Profile Fields (under the heading User Profile Settings).
2. Click "Configure" next to the field you created in the previous step.
3. Choose a Reference User Field. (see image 2 below)
   
4. Choose a Profile Element.
5. Choose a Search Template (what works best with the chosen field type in 4. will be displayed as recommendation).
6. Confirm with "Update".

Image 2: Configure User Profile Field (click to enlarge)

3. Perform a Re-index

When changes are made to a custom user field in JIRA, it is necessary to perform a reindex so the changes are reflected in the issues.

1. Go to the Administration (cog icon) > System > Indexing (under the heading Advanced) or search by entering "." and typing "indexing" into the search box that opens.
2. Choose a re-index option and confirm with "Re-Index".
   

Now you can display user profile fields in JIRA issues.

Further Information

• Configuring a custom field in JIRA

User Profile Field Re-Indexer Job

You can find the job responsible for updating the values in the JIRA Administration > System > Scheduler Details under "User Profiles for JIRA Job Runner". When you click "Show more" you'll see #2 "User Profile Field Re-Indexer", which runs once per minute by default.

Image 3: User Profiles for JIRA Job Runner (click to enlarge)

Back to Top