Customizing labels

Labels and text that are displayed in the Identity Service Center user interface are customizable. The label and text customization task involves providing replacements for one or more of the customizable files that are provided by IBM Security Identity Manager.

Before you begin

Labels that do not exist in the ui/nls folder, cannot be customized.

About this task

You must perform customization tasks on a primary node.

This procedure describes how to replace the customizable labels or text and where to place the customized file so that it can be used by the IBM Security Identity Manager server.

Procedure

  1. From the top level of the Appliance Dashboard, click Configure > Advanced Configuration > Custom File Management.
  2. From the All Files tab, click directories > ui > nls.
  3. In the ui/nls folder, locate the property file that contains the label or text that you want to replace.
    For example, the headerLabel.properties file that contains the viewProfile=View Profile label.
    You can use the search option to locate the headerLabel.properties file.
    1. Click Download.
    2. Create the backup copy of original files and then replace the customized labels or text.
      For example, viewProfile=View User Profile.
    3. Click Upload to load the custom file to the ui/nls folder.
  4. Restart the IBM Security Identity Manager application server.
  5. Customize labels in the CustomLabels.properties file.
    1. From the top level of the Appliance Dashboard, click Configure > Advanced Configuration > Update Property.
    2. Edit the CustomLabels.properties file.
    3. Change the value of the property to the text that you want to display for the label.
    4. Restart the IBM Security Identity Manager application server after you modify the CustomLabels.properties file.
  6. Customize labels in the I18NMESSAGES schema tables.
    1. Connect to the IBM Security Identity Manager DB2 database.
      For example, isimdb.
    2. Go to DB_name > Schemas > ITIMUSER (your ISIM DB user name) > Tables > I18NMESSAGES.
    3. Open the table in edit mode.
    4. Locate the label that you want to customize under the Message column and update the attribute.
      For example, you can edit Gecos (comments) label to TestLinux Gecos (comments) for Linux Profile.
    5. Save the changes.
    6. Open the account form of Linux in the Identity Service Center.
      The updated label is displayed with the customization.
    7. Restart the IBM Security Identity Manager application server for the changes to take effect.

What to do next

Start the Identity Service Center in a browser to verify that the customized label is being used.