10.3 Localizing the Text in the Interfaces

The text displayed in the identity applications is stored in either a set of language-based JSON files, language-based JAR files, or properties files located in the User Application WAR and User Application driver. In general, the file name includes a reference to the language. For example, the English language strings for the identity applications are stored in the UserAppStrings_en.JAR.

NOTE:The labels and string text typically change between versions. This means that you have to apply your string changes or customizations to each new release.

You can also translate or localize the names and descriptions of provisioning objects in the Directory Abstraction Layer, Provisioning Request Definition, and Role Catalog. For more information, see Localizing Provisioning Objects.

10.3.1 Localizing the Labels in the Dashboard

Some organizations might want to customize the default names for the fields and navigation items in the Dashboard. This procedure describes the process for updating the downloadable .properties files.

WARNING:Do not modify any text in the code string before the = sign. For example, category-featured-47-name =. The Dashboard might not function appropriately if you change the code string incorrectly.

  1. Log in to the Identity Manager Dashboard.

  2. Select Applications > .

  3. On the Manage Applications page, select the Localization icon.

    The Dashboard lists the .properties files by language.

    Language

    Locale Designation

    Chinese (China)

    zh_CN

    Chinese (Taiwan)

    zh_TW

    Czech

    cs

    Danish

    da

    Dutch

    nl

    English

    en

    French

    fr

    German

    de

    Hebrew*

    iw

    Italian

    it

    Japanese

    ja

    Polish*

    pl

    Norwegian

    nb

    Portuguese

    pt

    Russian

    ru

    Spanish

    es

    Swedish

    sv

    * Supported from Identity Manager 4.8.1.

  4. In the Languages window, download the .properties file for each language that you want to localize.

    Depending on your browser settings, you might be prompted for the download path.

    NOTE:If prompted, do not rename the .properties file. The Dashboard cannot upload a file that does not match the expected name.

  5. In a text editor, customize the displayed text for the attributes that you want to change.

    For example, if you download the sv.properties file to localize the Dashboard in Swedish, modify the properties file as follows:

    # English value: My Category
    category-featured-47-name = Min kategori

    NOTE:If you want to use double-byte or extended characters in the properties file, ensure that you save the file using the correct encoding.

  6. Save and close the file.

  7. In the Languages window, upload the modified file to the appropriate language.

  8. Close the Languages window, then select Edit Done.

  9. Refresh the browser window to view the changes.

    NOTE:Depending on the browser settings, you might need to log out of the Dashboard, clear the cache in the browser, then log in again.

10.3.2 Modifying the Text of the Application Tab

You can modify the menu text and the header on the Application tab.

To change the Application menu text:

  1. Log in to the Identity Manager Dashboard.

  2. Select Applications > .

  3. On the Manage Applications page, select .

  4. On the Languages page, click next to the language file you want to download. For example, English.

  5. Modify the following line in the downloaded file. For example en.properties.

    label-menu-main = Application

    For example, you can modify the above line to:

    label-menu-main = Applications Menu

  6. Save the en.properties file.

  7. Click next to English to upload the en.properties file.

  8. Refresh the browser.

To change the header on the Applications Page:

  1. Navigate to the /opt/netiq/idm/apps/tomcat/webapps/idmdash/i18n/json/ directory.

  2. Edit the DashStringsRsrc_<language>.json file, where <language> is the language file that you want to modify. For example, DashStringsRsrc_en.json.

  3. Modify the following line:

    "Applications": "Applications",

    For example, you can modify the above line to:

    "Applications": Applications List",

  4. Refresh the browser.

10.3.3 Localizing Text Stored in the JAR Files

The text strings stored in the WAR files are found in a language-based .jar file. These .jar files include various .properties files, which you can customize for the RBPM Configuration Utility as well as most of the Dashboard and identity applications interfaces. You can also customize the labels for One SSO Provider (OSP).

WARNING:Do not modify any text in the code string before the = sign. For example, category-featured-47-name =. The identity applications might not function appropriately if you change the code string incorrectly.

The .jar files are located by default in the following directories.

  • Identity applications: /opt/netiq/idm/apps/UserApplication/l10n-resources/userapp

    For example, UserAppStrings_<locale>.jar.

  • OSP: /opt/netiq/idm/apps/osp/osp-extras/l10n-resources

    For example, osp-custom-resource.jar.

Customizing Strings for Identity Applications

To customize strings for identity applications:

  1. Log in to the server where you installed the identity applications.

  2. Identify the WAR file for the identity application that you want to modify.

  3. In the WAR file, locate the .jar file(s) that you want to update.

  4. Copy the .jar files that you want to update to a temporary directory.

    WARNING:Do not change the file names or directory structure of the .jar files.

  5. To access the .properties files in each .jar file in the temporary directory, complete one of the following actions:

    • Extract the .properties files

    • Use WinRAR to open each .properties file

    For example, access the OAuthManagerRsrc_en.properties file in the UserAppStrings_en.JAR.

  6. Browse the file directory to the .properties file that you want to edit.

    For example, UserAppStrings_fr.properties.

  7. In a text editor, customize the displayed text for the content that you want to change.

    WARNING:Do not modify any text in the code string before the = sign. For example, ADMIN_PASSWORD=. The identity applications might not function appropriately if you change the code string incorrectly.

  8. Save and close the editor.

  9. To apply your changes to the application, complete the following steps:

    WARNING:Do not change the file names or directory structure of the .jar and WAR files.

    1. Using the Java JDK jar program, add the properties files back to the .jar file.

    2. Add the modified .jar to the appropriate WAR file, maintaining the folder location within the WAR.

      You can use the Java JDK Jar program. For example:

      jar -uvf IDMPRov.WAR WEB-INF/lib/UserAppStrings_fr.jar
    3. Redeploy the WAR file to your application server.

  10. Stop Tomcat.

    For example:

    systemctl stop netiq-tomcat
  11. Delete all files and folders in the following directories:

    • Tomcat temporary directory, located by default in /opt/netiq/idm/apps/tomcat/temp

    • Catalina directory, located by default in /opt/netiq/idm/apps/tomcat/work/Catalina

      You can view the log files and delete all log files from the tomcat/logs directory, located by default in /opt/netiq/idm/apps/tomcat/logs.

  12. Start Tomcat.

    For example:

    systemctl start netiq-tomcat
  13. Before logging in to the identity applications, clear the browser cache to ensure that the browser displays your changes.

  14. To test your changes, complete the following steps:

    1. Access the identity application that you modified.

    2. Using your list of changes, review each occurrence of the string you changed to determine if you made the change appropriately.

Customizing Strings for OSP

To customize the strings on the OSP login page:

  1. Log in to the server where OSP is installed.

  2. Navigate to osp-extras/l10n-resources.

    By default, it is located in/opt/netiq/idm/apps/osp/osp-extras/l10n-resources.

  3. Back up osp-custom-resources.jar file.

  4. Copy the backed up osp-custom-resources.jar to a temporary directory.

  5. Extract the osp-custom-resources.jar file in the temporary directory.

    For example: jar xf osp-custom-resources.jar

    NOTE:Make sure that you have maintained the existing directory structure during extraction.

  6. Navigate to resources folder and open oidp_enduser_custom_resources_en_US.properties file and uncomment the following properties:

    WARNING:Do not modify any text in the code string before the = sign. For example, ADMIN_PASSWORD=. The identity applications might not function appropriately if you change the code string incorrectly.

    ## Organization name [nbsp], [reg], [tm], [amp], [br], [plus], [apos] are pseudo-tags 
    ## that are converted at runtime into appropriate HTML.
    OIDPENDUSER.LoginProductName=Company[nbsp]Name[reg]
    ## Whether the company or product name should be displayed in the login pages: "true" or "false"
    OIDPENDUSER.LoginProductNameDisplay=true

    These properties modify the banner name on the login page. You can uncomment other properties and change them to localize different texts on the login page.

  7. Save and close the editor.

  8. Stop Tomcat.

    For example:

    systemctl stop netiq-tomcat
  9. To apply your changes to the application, complete the following steps:

    WARNING:Do not change the file names or directory structure of .jar and WAR files.

    1. Using the Java JDK jar program, add the properties files back to the .jar file.

    2. Update the osp-custom-resources.jar with the customized properties files in the temporary directory.

      You can use the Java JDK Jar program. For example:

      jar -uf osp-custom-resources.jar resources/oidp_enduser_custom_resources_en_US.properties
    3. Copy the updated osp-custom-resources.jar to the tomcat/lib directory.

  10. Delete all files and folders in the following directories:

    • Tomcat temporary directory, located by default in /opt/netiq/idm/apps/tomcat/temp

    • Catalina directory, located by default in /opt/netiq/idm/apps/tomcat/work/Catalina

  11. Start Tomcat.

    For example:

    systemctl start netiq-tomcat
  12. Before logging in to the identity applications, clear the browser cache to ensure that the browser displays your changes.