10.5 Configuring User Names

The Dashboard and the User Application allow you to configure the format of displayed user names in your environment based on the user’s current locale. To simply name entry, the identity applications attempt to complete the names as you type them based on the information in the database.

10.5.1 Configuring the Format of Displayed User Names

The Dashboard and the User Application allow you to configure the format of displayed user names in your environment based on the user’s current locale.

You can then use localized user names in Approval forms, using the literal %LocaleFormattedFullName% for forms with the User entity definition key. For more information about creating or configuring forms in Designer, see “Creating Forms for a Provisioning Request Definition”, in the NetIQ Identity Manager - Administrator’s Guide to Designing the Identity Applications.

  1. Start Designer.

  2. Open your current project and click the project name in the Outline view.

  3. In the Provisioning view, right-click Full Name and select Edit.

  4. In the Directory Abstraction Layer editor, expand Entities > Full Name.

  5. Select the locale name pattern that you want to modify.

  6. Modify the Calculated Attribute expression to specify the format you want to use for the locale. For example, if you want to display the user’s surname first and given name second, modify the expression as follows:

    attr.getValue("Surname") + " " + attr.getValue("Given Name")

    You can either modify the expression manually in the Expression field or click the Build ECMAScript Expression icon and use the ECMA Expression Builder to modify the expression. For more information about modifying ECMAScript expressions, see “Working with ECMA Expressions” in the NetIQ Identity Manager - Administrator’s Guide to Designing the Identity Applications.

  7. Save your changes to the locale name pattern.

  8. Repeat Step 5 through Step 7 for each name pattern you want to configure.

  9. When finished, close the Directory Abstraction Layer editor.

  10. In the Modeler, right-click the User Application driver and select Driver > Deploy.

  11. Click Deploy, then click Yes to restart the driver.

  12. Click OK.

10.5.2 Enabling Localized User Names in Typeahead Fields

After you configure the Full Name entity in the Directory Abstraction Layer, the identity applications automatically display user names formatted by locale.

However, to use user names with localized name formatting in typeahead fields within the identity applications, you must create one or more custom registry entries. The identity applications use typeahead controls when a supervisor wants to manage a specific or team, and the typeahead controls do not use the %LocaleFormattedFullName% literal.

  1. In the conf directory of your application server installation, create an empty file with the file name UIControlRegistry_CustomProps.xml.

  2. Open the User Application WAR, IDMProv.war by default, and extract the contents.

  3. Locate the UIControlRegistry.xml file in the WAR’s WEB-INF directory.

  4. In the UIControlRegistry.xml file, locate the entries for the UserDNLookup and UserInTeamDNLookup keys.

  5. Copy the <registry> element, <ctrls> element, and both keys to the UIControlRegistry_CustomProps.xml file.

  6. Modify the display-exp property of each of the copied keys as follows:

    <prop name="display-exp" type="string">
        <value>FirstName LastName</value>
        <value xml:lang="en">LastName FirstName</value>
    </prop>
  7. Create an xml:lang value for each localized name format you want to use. You can include a value for each language supported by the User Application.

  8. Save and close the UIControlRegistry_CustomProps.xml file.

  9. Restart Tomcat.