Customizing Users' Display Name

Use

A user’s display name is the friendly name that is displayed for a user in most user interfaces, for example in list of results when you search for a user in the UME administration console. Programmatically, 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. It is possible to customize it, to display a different friendly name, for example the users salutation followed by first name and then last name.

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, commas, semicolons, and so on.

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

Example

You change the value to:

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 would be ‘Mr Peter Miller’.

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