Configuring Locales

By default, Openspace automatically provides two built-in language packs (American English and British English). Openspace also provides a locale.properties files that lists all 57 known locales that are available. When Openspace loads, it makes a call to the server to check whether any of the language packs for the 57 locales have been installed. If a language pack is installed, then Openspace loads the relevant data for the installed language pack. However, testing for a large number of potential locales can have an impact on the time taken to load Openspace. If you are finding that Openspace is taking a long time to load, TIBCO recommends that you amend the locale.limit property in the config.properties file to limit the number of locales that Openspace tests for.

The locale.properties file assigns a locale property to each of the 57 locales. A snap shot of the file is shown below: 
locale.0=en_US
 locale.1=en_GB
 locale.2=fr_FR
 locale.3=fr_CA
 locale.4=es_ES
By default, Openspace checks for all 57 locales specified in the locale.properties file. The locale.limit property allows you to limit how many locales Openspace checks for. If you have configured the locale.limit property, Openspace processes this file sequentially from the top, until it reaches the limit specified in the locale.limit property.
The format of the locale.limit property is locale.limit=value where value is either:
  • numeric. In this case, you must specify the integer that indicates the locale limit that you want Openspace to reach. For example, if you only want en_US and es_ES then the locale.limit property should be configured as locale.limit=4. Openspace still checks for en_GB, fr_FR and fr_CA but will stop at es_ES. If you want, you can reorder the locale.properties file. For example, you could specify that locale.2=es_ES and then set the locale.limit property to locale.limit=2.
  • text. In this case, you can specify any text you like and then add that text as part of an extended URL. For example, you can specify the locale.limit property as locale.limit=restrict. You can then specify the limit as part of an extended URL in Openspace. For example, if you only wanted en_US, you could specify the URL as 
    https://localhost:8080/openspace/openspace/?restrict=0

The locale.limit property is commented out by default.

See Openspace Configuration Overview for the location of the locale.properties and config.properties files.

Prerequisites

TIBCO recommends that you take a backup of the config.properties file before amending it.

Procedure

  1. Open the config.properties file in a text editor.
  2. Uncomment the locale.limit property.
  3. Specify the value, depending on your requirements.
  4. Save and close the config.properties file.
  5. Log out and log back into Openspace for the changes to take effect.