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.
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.
Log in to the Identity Manager Dashboard.
Select Applications > .
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.
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.
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.
Save and close the file.
In the Languages window, upload the modified file to the appropriate language.
Close the Languages window, then select Edit Done.
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.
You can modify the menu text and the header on the Application tab.
To change the Application menu text:
Log in to the Identity Manager Dashboard.
Select Applications > .
On the Manage Applications page, select .
On the Languages page, click next to the language file you want to download. For example, English.
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
Save the en.properties file.
Click next to English to upload the en.properties file.
Refresh the browser.
To change the header on the Applications Page:
Navigate to the /opt/netiq/idm/apps/tomcat/webapps/idmdash/i18n/json/ directory.
Edit the DashStringsRsrc_<language>.json file, where <language> is the language file that you want to modify. For example, DashStringsRsrc_en.json.
Modify the following line:
"Applications": "Applications",
For example, you can modify the above line to:
"Applications": Applications List",
Refresh the browser.
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.
To customize strings for identity applications:
Log in to the server where you installed the identity applications.
Identify the WAR file for the identity application that you want to modify.
In the WAR file, locate the .jar file(s) that you want to update.
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.
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.
Browse the file directory to the .properties file that you want to edit.
For example, UserAppStrings_fr.properties.
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.
Save and close the editor.
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.
Using the Java JDK jar program, add the properties files back to the .jar file.
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
Redeploy the WAR file to your application server.
Stop Tomcat.
For example:
systemctl stop netiq-tomcat
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.
Start Tomcat.
For example:
systemctl start netiq-tomcat
Before logging in to the identity applications, clear the browser cache to ensure that the browser displays your changes.
To test your changes, complete the following steps:
Access the identity application that you modified.
Using your list of changes, review each occurrence of the string you changed to determine if you made the change appropriately.
To customize the strings on the OSP login page:
Log in to the server where OSP is installed.
Navigate to osp-extras/l10n-resources.
By default, it is located in/opt/netiq/idm/apps/osp/osp-extras/l10n-resources.
Back up osp-custom-resources.jar file.
Copy the backed up osp-custom-resources.jar to a temporary directory.
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.
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.
Save and close the editor.
Stop Tomcat.
For example:
systemctl stop netiq-tomcat
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.
Using the Java JDK jar program, add the properties files back to the .jar file.
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
Copy the updated osp-custom-resources.jar to the tomcat/lib directory.
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
Start Tomcat.
For example:
systemctl start netiq-tomcat
Before logging in to the identity applications, clear the browser cache to ensure that the browser displays your changes.