Previous Page Next Page

NLS at Application Level

All the JReport Designer UI text and message related files are packaged in the file resource_en_US.jar (if JReport Designer is Chinese version, the file name is resource_zh_CN.jar) in <install_root>\lib. To make JReport Designer display in your required language, you just need to translate the needed files in this package.

The following takes French as an example to explain how to make JReport Designer display in another language.

1. Backup the file resource_en_US.jar in <install_root>\lib, then rename it to resource_fr_FR.jar.

   The name of the file must follow the format below: resource_abbreviation of the language with lowercase_abbreviation of the country using the language with uppercase.jar. The language argument is a valid ISO Language Code as defined by ISO-639. You can find a full list of these codes at a number of sites, for example: http://www.loc.gov/standards/iso639-2/php/code_list.php. The locale argument is a valid ISO Country Code as defined by ISO-3166. You can find a full list of these codes at a number of sites, for example: http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html.

2. Open the newly saved file resource_fr_FR.jar, and you can find it contains two folders, META-INF and resource.
3. In the resource folder, open the following files one by one and translate the property values in the files to French, then save and close the files:
   • JWColorChooser.properties
   • JWFileChooser.properties
   • JWMessage.properties
   • JWMisc.properties
   • JWNLSPropertyValue.properties
   • JWObject.properties
   • JWObjectToolTip.properties
   • JWPropertyGroup.properties
   • JWToolTip.properties
4. Open the folder images in the resource folder, translate all text that can be translated in the image files, and save them. The file names cannot be changed.
5. Copy the folder uidescriptors in the resource folder to a specified place (for example, the Desktop), then open it. The folder contains a lot of .xml files.
6. Right-click the file CatalogDoctorResource.xml in the uidescriptors folder and select Edit from the shortcut menu to open the file. The file contains some name properties. Translate their values to French, then save and close the file.
7. Translate the name property values in the following files as you do in the above step:

   • DataBrowser.xml

   • ReferenceEntityDialog.xml

   • MainMenu.xml

   • ToolBoxResource.xml

   • HelpLinkResource.xml

8. Translate the displayname property values in the following files as you do in step 6:

   • FormulaSpecialFieldsResource.xml

   • CrosstabFormulaFunctions.xml

   • FormulaFunctions.xml

   • FormulaOperators.xml

   • CTFormulaSpecialFieldsResource.xml

   • DynamicFormulaSpecialFieldsResource.xml

9. Translate the title, name, tooltip and text property values in the other .xml files except ComponentContainerRelationship.xml, GraphPanel.xml and the ones listed in step 7 and step 8 as you do in step 6.
10. After finishing the translation, copy the folder uidescriptors from the Desktop to the resource folder in resource_fr_FR.jar placed in <install_root>\lib to replace the original one.
11. Open the file config.xml in <install_root>\bin, and set the value of the property to _fr_FR. Make sure that JReport Designer is closed when you modify this file.

    The language name must follow the format below: abbreviation of the language with lowercase_abbreviation of the country using the language with uppercase.jar. If the name format is not correct, JReport Designer will start with the default language.

12. Right-click the file JReport.bat in <install_root>\bin and select Edit from the shortcut menu to open the file, then change the name of the language package resource_en_US.jar to resource_fr_FR.jar.
13. Save the file. Then when you run JReport Designer, the UI text will be displayed in the specified language.

Previous Page Next Page