Skip to main content
Pentaho Documentation

Report Viewer Localization

Follow the directions below to create localized message bundles for the Report Viewer plugin.

Note: This is for the Report Viewer, which displays reports created with Report Designer. The instructions here, while similar, do not provide localization support for Interactive Reporting, or for individual reports. Refer to Pentaho Interactive Reporting Localization for Interactive Reporting localization.
Warning: The date picker is an interface element from the common-ui BA Server plugin, which does not currently support more than one locale at a time.
  1. If the BA Server is currently running, shut it down.
  2. Make a copy of the messages.properties file in /pentaho-solutions/system/reporting/messages/; name the copy according to the standard locale naming scheme defined earlier in this section.
    cp messages.properties messages_fr.properties
  3. Translate the content of the new message bundle into the locale defined in its file name.
  4. Inside of the Pentaho Web application, unpack the /WEB-INF/lib/pentaho-reporting-engine-classic-core- platform-plugin---check--5.1 .jar JAR, then navigate to the /org/pentaho/reporting/platform/plugin/messages/ directory inside of it.
  5. Make a copy of the messages.properties file in this directory; name the copy according to the standard locale naming scheme defined earlier in this section.
    cp messages.properties messages_fr.properties
  6. Translate the content of the new message bundle into the locale defined in its file name, and remove all of the properties that you don't change. Leaving the unchanged properties in the file will cause duplicate definitions, which cause unnecessary overhead and difficulty in future translation efforts.
  7. Re-pack the JAR. If the original JAR was not deleted when you unpacked it, you will have to delete it before re-packing.
You now have translated Report Viewer (and Reporting plugin) message bundles available in your BA Server.