000037079 - How to add language localization to forms in RSA Identity Governance & Lifecycle

Document created by RSA Customer Support Employee on Jan 8, 2019
Version 1Show Document
  • View in full screen mode

Article Content

Article Number000037079
Applies ToRSA Product Set: Identity Governance & Lifecycle
RSA Version/Condition: 7.x
IssueThis article explains how to incorporate the internationalization/language localization features of RSA Identity Governance & Lifecycle into custom forms.
TasksThis feature is controlled using a customerstrings.properties file.  The naming convention is based on resource bundles, so you might provide a French version by including a file called customerstrings_fr.properties.  All these files should be uploaded on the UI  (Admin > User Interface > Files > Customer Strings).

The format of the resource strings for forms depends on if the form is associated with a container (application, directory, ...) or just a global form:



Container format




<object type>-<raw container name>-<variable>=Your localized text

 

No container format




<object type>-<variable>=Your localized text



Note that the name of the form is NOT in the format.  This allows you to specify the localized text once and anywhere that same variable is used the translation applies.




Example 1



If I had a variable named v1 on a global form for which I wanted to localize the form field question and tooltip, the process is to  specify in the customerstrings.properties or customerstrings_xx.properties for a specific language.  For example,
 




Global-v1=New Variable
Global-v1-tooltip=New Variable Tooltip!

 

Example 2



In this example, the form has a static text variable defined:




variable name: st_1
Text: Hello World.



You can optionally add a line to your customerstrings.properties file or just enter the default value in the form element text field:




Global-st_1=Hello World.



Then for other languages such as German add in a customerstrings_de.properties:




Global-st_1=Hallo Welt.


That would have the system display the German version when a user selected German as either their browser language and having that determine the UI language OR have German set as the UI language explicitly from the User Options Language tab (see the user icon in the upper right corner of  the UI).

Notes

If you need language localization in your form validation error messages, please review a thread on the RSA Link RSA Identity Governance & Lifecycle community on how to use customerstrings on form validation files that may help with your JSP.

Attachments

    Outcomes