Customize labels of web UI pages

You can modify labels on most PPM web UI pages, which are read from the built-in properties files. This enables you to improve translations or adapt PPM labels to end-user terminology.

In this topic:

Location to customize labels

You should add custom properties files with the customized labels in the folder <PPM_HOME>/conf/custom_resources/custom_labels. If you are running PPM as a cluster with multiple servers, you should copy your custom files on every server.

The System Appearance Customization > Labels Customization page in the Administration menu helps you identify the bundle name (name of the properties file), and key of the labels displayed on web UI pages.

Back to top

Toggle Labels Debugging

If you turn on labels debugging by clicking the Turn On Labels Debugging buttons in the Labels Customization page, whenever a PPM Web page loads, every label will be replaced by its label key prefixed with the [bundle_name]. This will indicate how to name the custom properties file and the key in the file contents if you want to modify this label.

Back to top

Encode text for Properties files

If you open any .properties file, especially the ones with non-english text, you will notice that every character that is not a standard ASCII character will be encoded to a form such as \u1234.

In this section, you can paste some text and click the Encode button to get the text that you should insert in the properties file. It’s a good practice to do so even with English text, as characters such as double quotes and backslashes should also be encoded when put in a properties file.

Back to top

List of supported languages

This section lists all the languages currently enabled on your PPM instance, and for each of them, shows you how to name a custom properties file to have it contain custom labels for that language.

This section also includes a button “Reload all custom labels” that you can press if you added new custom labels and custom properties files in <PPM_HOME>/conf/custom_resources/custom_labels, and want to test them immediately without restarting PPM. Note that if you’re running on a PPM cluster, this will only apply to the node to which you’re currently connected.

Back to top

Limitations

Label customization has the following limitations:

• Labels customization doesn’t work on the admin console labels.
• Labels customization doesn’t work on labels from the Dashboard Module (icons on Dashboard page & “Personalize Dashboard” page).
• Labels customization doesn’t work on translations from database (some workflow labels).
• Labels customization doesn’t work on Workbench Labels.
• Labels customization doesn’t work with Business Data translations – you still need to use the command line tool to import/export translations.

Back to top