Customizing Users' Display Name 

Use

A user’s display name is the name displayed for a user in the UME user interface, for example in list of results when you search for a user in Identity Management. (See User Administration Console.) It is the name that is returned by the method IUser.getDisplayName().

By default the display name is the user’s last name followed by the first name. You can customize the display name, for example the user’s salutation followed by first name and then last name.

This name does not apply to all user interfaces, for example, the portal masthead.

Procedure

The name returned by the method IUser.getDisplayName() is calculated by the user attributes specified in the user management property ume.users.displayname_template.

The default value is ume.users.displayname_template={lastname}, {firstname}

To change the display name, change the value of this property. It can be a combination of:

·        User attributes: The available user attributes are: {firstname}, {lastname}, {salutation}, {title}, {jobtitle}, {company}, {department}, {currency}, {email}, {telephone}, {mobile}, {fax}, {streetaddress}, {city}, {zip}, {country}, {state}, {locale}, {timezone}, {j_user}

·        Characters: Most characters whose unicode lies between \u0020 and \u007E can be written as they are. These are characters such as A-Z, a-z, comma (,), semicolon (;), and so on.

·        Unicode characters: Characters whose unicode does not lie between \u0020 and \u007E, must be written in the form \uXXXX

Example

If the UME property is set as follows:

ume.users.displayname_template={salutation} {firstname} {lastname}

For a user whose first name is ‘Peter’, second name is ‘Miller’ and salutation is ‘Mr’, the display name is ‘Mr Peter Miller’.

This display name appears on all user interfaces that use the method IUser.getDisplayName().