1 – Setup and customization > 1.3 Viewpoint customization > Localizing the user interface

Localizing the user interface

Viewpoint does not currently ship with any language aside from U.S. English. However, you can translate the user interface strings and place them in a file that will be used by the Internet browser, depending on its language locale.

To localize the user interface

  1. Copy the message.properties file (typically located in the tomcat/webapps/moab/WEB-INF/grails-app/i18n directory), and rename it in this fashion: messages_<language_code>.properties.
  2. For example, if you are creating a Castilian Spanish interface, the language code is "es_ES". This means, you would rename the copied file: messages_es_ES.properties.

  3. Content on the left of the equal sign (=) represents current Viewpoint code for content that appears in the user interface. Content on the right replaces content on the left and becomes visible in the user interface. This means you should translate the content on the right for each string you want to localize.
  4. Save the messages_<language_code>.properties file.
  5. Restart Tomcat to allow changes to take effect.
  6. When using keys, do not use spaces or special characters. Also case-sensitivity must be considered; content in the files appears in the user interface exactly as it appears in the dictionary list.

When your web browser loads, it will display the strings from the localized file.

Related topics