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

Create the backup copy of original files and then replace the customized labels or text.

About this task

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.

You can customize labels that exist at the following locations:
  • .../itim/custom/ui/original/nls folder
  • ISIM_HOME/data/CustomLabels.properties
  • I18NMESSAGES schema table

If the labels do not exist at these specified locations, they cannot be customized.

Procedure

  1. In the .../itim/custom/ui/original/nls folder, locate the label or text that you want to replace from one or more property files.
    For example, viewProfile=View Profile from the .../itim/custom/ui/original/nls/headerLabel.properties.
  2. Create your custom label or text.
    For example, viewProfile=View User Profile.
  3. Copy the custom label or text to the .../itim/custom/ui/nls folder. Use the same relative path and file name as the file that IBM® provides in the .../itim/custom/ui/original/ folder.
    For example, viewProfile=View User Profile in the .../itim/custom/ui/nls/headerLabel.properties.
  4. Customize labels in the ISIM_HOME/data/CustomLabels.properties file.
    1. Edit the CustomLabels.properties file.
    2. Change the value of the property to the text that you want to display for the label.
    3. Restart the IBM Security Identity Manager application server after you modify the CustomLabels.properties file.
  5. 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 Manager Service Center in a browser to verify that the customized label is being used.