7.7 Localization/Internationalization

If deployed reports are viewed in multiple locales, it may be desirable to configure report elements to display text in a language specific to the user locale. You can configure a report element for localization by associating one or more Text ID properties with the element. The specified Text ID for each element is then used to create a mapping between the text string in the element and the replacement text string to be shown to the user.

To specify the Text ID for an element, follow the steps below:

1. Select 'Localization' from the Style Studio Report menu. This opens the 'Localization' dialog box.

2. Select the element you wish to localize from the element tree.

3. Enter a label for the element in the 'Text ID' field.

The Text ID that you enter here is the label used to represent the text of the corresponding component in the localization mapping file, discussed below. Some elements, such as tables, may have multiple components which can each be given an independent Text ID.

4. Click 'OK' to exit the 'Localization' dialog box.

 

The mapping between the specified Text IDs and the replacement text for each locale is specified in a resource bundle specific to that locale. The resource bundle is a “.properties” file, and must be available on the classpath, preferably in the sree\WEB-INF\classes directory. The file should be named using the ISO-standard two-letter codes for language and country; for example, a property file supporting Canadian French speakers would be called 'SreeBundle_fr_CA.properties'. See the Localization/Internationalization section of the Administration Reference for details on configuring resource bundle contents.

When the end-user selects a locale from the User Portal login menu, the mapping in the corresponding resource bundle is used to display the replacement text for all mapped elements. If a resource bundle corresponding to the user's locale selection is not found on the classpath, no localization will be performed.

In addition to localizing report elements, you can also configure localization for User Portal interface components (tabs, tree elements, etc.). See the Localization/Internationalization section of the Administration Reference for instructions.

<< 7.6.2 Report Partitioning © 1996-2013 InetSoft Technology Corporation (v11.4) 7.8 Viewer Actions >>