For the following steps you need Jira Administrator permissions. |
Configuration Overview
With version 2.0, the configuration has moved from "User Management" to "Add-ons" in the Administration. |
You can access the configuration in the JIRA Administration (choose Cog icon > Add-ons at top right of the screen or use the keyboard shortcut: press "gg" then type "Profile Elements") via the menu item User Profile Settings > Profile Elements in the panel on the left side.
Image 1: Profile Elements Overview (click to enlarge)
On this screen the Personal and Company sections are displayed by default. The full name and email are taken from JIRA itself and cannot be edited.
Once you have some elements set up, you can rearrange the order on these elements with the up and down arrows in the Order column. You can also edit each element or delete the elements you no longer want.
Please note, that the elements are only visible at the profile, if they contain any information. Otherwise they are hidden! |
See the next section for information on setting up a new profile element.
Create a new Profile Element
Below the displayed elements, you can find the option to add a new element (“Add Element”). Once you click on this button, a new window will pop up which allows you to configure a new profile element.
Image 2: Create new Profile Element (click to enlarge)
You can configure the following options:
Title for this Element
Title (Default): Define a default title for the element which will be English in most systems.
- Title (German): Optionally define a German title for the element. It will be displayed when the language setting is changed to German.
Help Text for this Element
You also have the option to add a help text. This will give a description of what this element means or a hint as to what’s expected in this element.
Field Type Configuration
Field Type
The following options are available as element types:
- Textfield
- Userfield
- Phone Number
- Single Select (Radiobuttons)
- Multiple Select (Checkboxes).
You can set up the profile element to synchronize with configured LDAP directories.
For the synchronization to work, you have to provide a mapping of LDAP attributes to standard or additional user profile elements. It is possible to relate more than one LDAP attribute to one user profile element. The mapping has to be provided at “Mapping for LDAP Attribute(s)” by using the following syntax:
- Any LDAP attribute has to be given as %%LDAP_ATTRIBUTE%% (i.e. name of an LDAP attribute enclosed in two percent signs (%%)).
- Multiple LDAP attributes with the same name are supported. If there are such attributes they will be mapped to the same profile element, separated by comma.
- You can also specify static text (e.g. %%street%% %%number%% in %%city%%)
- Use %%upp_delete_value%% as a placeholder to delete the data for previously synchronized profile element.
Synchronized user profile elements cannot be edited by JIRA users. |
Visibility
If you check this box, the profile element will be displayed in the user profile which pops up when hovering over a user name.