Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Configuration Overview
Note

For the following steps you need Confluence Administrator permissions.

Configuration Overview

Warning

With version 2.0, the configuration has moved from "User Management" to "Add-ons" in the Administration.

You can access the configuration via the menu item User Profile Settings > Profile Elements in the panel on the left side of the administration console in the JIRA Administration (choose Cog icon > User Management at > Add-ons at top right of the screen or use the keyboard shortcut: press 'g g' "gg" then type '"Profile Elements').Image Removed") via the menu item User Profile Settings > Profile Elements in the panel on the left side.

Image Added

Image 1: Profile Elements Overview (click to enlarge)

 

On this screen you have the Personal and Company sections as are displayed by default. The full name and email are taken from JIRA itself , and cannot be edited. Below these elements, you’ll see

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.

Note

Please note, that the fields 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 where you’ll be able to create your own which allows you to configure a new profile element.

Image Removed

There are a few options here:

  • The Title – This is where you choose the name of the element.
  • Help Text –

    Image AddedImage 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 field means or a hint as to what’s expected in this field.

    Field Type Configuration

    – This allows you to choose the type of input the user has for this element. The options are a text field, a text area, a user field, single select (radio buttons), or multiple select (checkboxes). There’s also the option here to set up the

    Field Type

    Status
    colourGreen
    titlesince version 2.0

    The following options are available as field 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 field, 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.
  • Visibility – This enables the profile element to be seen on a user’s Hover Profile
  • Once you have some elements set up then you can rearrange the order on these elements with the up and down arrows on the Profile Elements main page. You can also edit each element or delete the elements you no longer want.

    Please , that the fields are only visible at the profile, if they contain any information. Otherwise they are hidden!
    Info
    Note

     

    Synchronize User Profile Pictures

    The synchronization of user pictures is supported from a central storage. You can find the configuration under “Special Elements” in the User Profile Settings > Profile Elements (choose Cog icon > User Management at top right of the screen or use the keyboard shortcut: press 'g g' then type 'Profile Elements').

    Start Synchronization of User Pictures

    Click "Edit" to open the configuration dialog for the picture synchronisation.

    Image Removed

    To synchronize user pictures from a central user directory you have to enter the attribute name where the picture is stored. The name of the attribute is typically “thumbnailPhoto” for Active Directory and “jpegPhoto” for OpenLDAP. You may set multiple attributes separated by a comma, i.e. “thumbnailPhoto,jpegPhoto”. This is useful, if you have configured multiple directories of different types.

    The synchronization is based on the following features

    • While the synchronization process is running a picture of a user is read out, cropped to a square format and if necessary scaled-down.
    • Pictures are stored in standard size used in JIRA.
    • If a picture is updated in the picture storage, the user picture will be overwritten in JIRA during the next synchronization.
    • Users can upload own pictures, but after a new synchronization the picture from the picture storage is displayed again.
      • (info) If there is no picture for the user in the external repository defined, the users uploaded image will be preserved through synchronization tasks.

    Stop Synchronization of User Pictures

    Leave the field “Attribute Name” blank if no synchronization is required or if you want to stop the synchronization.

     

    On systems with many users (1000+) the first synchronization may take very long (several hours) and can impact your systems performance. To improve the process or in case of synchronization errors it is recommended to enable “Login Synchronization” for a couple of days.  
    Note
    titleInformation about Performance

    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.

     


    Back to Top

    Include Page
    _Version Switch
    _Version Switch