Customizing labels

Labels and text that are displayed in the IVIG 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 Verify Identity Governance.

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 Verify Identity Governance server.

You can customize labels that exist at the following locations:
  • .../itim/custom/ui/original/nls folder
  • IM_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 IM_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 Verify Identity Governance 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, isvgimdb.
    2. Go to DB_name > Schemas > ITIMUSER (your IM 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 IVIG Service Center. The updated label is displayed with the customization.
    7. Restart the IBM Verify Identity Governance application server for the changes to take effect.

What to do next

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