2.6.7  Localization/Internationalization

If the dashboards you create are viewed from multiple locales, it may be desirable to configure Viewsheet components to display text in a language specific to the user locale. The following Viewsheet components can be localized in this way:

Table title and column header text

Freehand Table title and text cell text

Crosstab title, column header text, and grand total text

Chart axis titles and legend titles

Selection component titles

Text component text

Input component titles

Submit button label

You can configure a Viewsheet component for localization by associating one or more Text ID properties with the component. The specified Text IDs for each component are then used to create a mapping between the text string(s) in the component and the replacement text string(s) to be shown to the user.

To specify a Text ID for a component, follow the steps below:

1. Press the 'Options' button in the Visual Composer toolbar to open the 'Viewsheet Options' dialog box.

2. Select the Localization tab.

 

3. In the left 'Component' panel, select the property in the element tree that you wish to localize, and press 'Add'. This adds the property to the right 'Localization Text ID' panel.

4. In the 'Localization Text ID' panel, 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.

5. Press 'OK' to exit the 'Viewsheet Options' 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 Viewsheet 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.

<< 2.6.6 Setting Default Viewsheet State © 1996-2013 InetSoft Technology Corporation (v11.5) 3 Using Viewsheet Components >>