The following instructions detail the method by which additional languages can be added to the JReport Server interface. These languages replace the default English text on the various windows generated by JReport, including those involved in ad hoc reporting.

Creating an NLS Resource Folder for New Language

There are three property files which together contain all UI text and messages in JReport Server:

  • common.properties
    This property file stores some common UI text all over JReport Server (including Page Report Studio, Web Report Studio, JDashboard and Visual Analysis) in the specific language.
  • dhtml.properties
    This property file stores UI text and messages referred by Page Report Studio, Web Report Studio, JDashboard and Visual Analysis in the specific language.
  • server.properties
    This property file stores UI text and messages referred by JReport Server in the specific language.

The language package is stored in:
<server_install_root>\resources\server\languages

The structure is:
\LanguageName
\properties
common.properties
dhtml.properties
server.properties

Manually adding a language package

To add a language package, follow the steps below:

  1. Browse to the <server_install_root>\resources\server\languages
  2. Create a folder named for the new language. The folder name should keep to ISO language and country code naming criterion.
  3. Copy the properties folder in the existing <server_install_root>\resources\server\languages\en directory to the new folder.
  4. Modify the three property files: common.properties, dhtml.properties, and server.properties in the new folder by translating all the text and messages after “=” to the new language.
  5. Save these property files with UTF-8 encoding.
  6. Convert the contents in the three property files into Unicode using native2ascii.exe in the <jdk_install_root>\bin directory by running the following line in the Command Console:
    C:\jdk1.8.0\bin>native2ascii -encoding utf-8 common.properties >newcommon.properties
    C:\jdk1.8.0\bin>native2ascii -encoding utf-8 dhtml.properties >newdhtml.properties
    C:\jdk1.8.0\bin>native2ascii -encoding utf-8 server.properties >newserver.properties

NOTE:
One additional property file can be translated for users of JReport Monitor. The file is called monitor.properties and is in the following location:
<monitor_install_root>\resources\server\languages\en\properties

Enabling New Language for User

An end user can enable the new language for himself.

  1. Log onto the JReport console (http://server_ip_address:8888) with the user name and password.
    JReport Server Login
  2. Click My Profile in the Manage category.
    JReport Server Start Page
  3. Click the Advanced tab on the My Profile page.
    JReport Server - My Profile - Advanced
  4. Check the Yes checkbox for the Specify Default Language option, choose the desired language through the provided drop-down list, and click the OK button.
    JReport Server - My Profile - Advanced - Language Select
  5. Click OK to register the new setting and log off.
    JReport Server - Settings OK

JReport Server text should be displayed in the chosen language the next time the user logs into the application/environment and accesses JReport Server console.