Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Beginning with Profound Version 5, Fix Pack 5.0, all Atrium messages or strings are configurable for different languages or cultures.  You can customize these strings yourself, or even define new languages with configuration options.

Configuring a Language

Settings File

To configure language support for Atrium, create a new settings.js file and By default, the Atrium Menu Interface uses the English US (en_US) language.

There are two ways to set the language used by the Atrium interface to something else.

  • An IFS settings file sets one language to be displayed for all users.
  • Setting a field under users' Atrium profiles, allowing different languages per user. (This method is available with Profound UI Version 6 Fix Pack 0.4 and later.)

Method 1 - Settings File

This method sets one language for all users.

To begin, create a new JavaScript file–for example, settings.js–and place it in the following IFS directory:

...

The configuration options set in the Atrium settings.js file apply only to Atrium. If you want to configure languages for Genie or Rich Display sessions, see Language Support.

Settings

To set the language, specify a value for pui.language in your Atrium settings file. For example, to set the language to "French, France", you would code the following:

Code Block
languagejavascript
pui.language = "fr_FR";

Setting pui["language"] is all that's necessary for Atrium to provide text or messages in the language of your choice. (Note: not all messages and strings have been translated for every language yet. For those not yet translated, you can define them yourself as shown below.)

Method 2 - Setting language for the ATUSERSP.AULANG field

With this method, different users can use different languages. (This method is available with Profound UI Version 6 Fix Pack 0.4 and later.)

To set a single user's language, find the user in the ATUSERSP physical file, and set the AULANG field to a valid language identifier. Valid language identifiers for Atrium are listed in a section below: Languages Provided for the Atrium Menu Interface.

The pui.language setting must not exist in any JavaScript file in userdata/extension/atrium/, or else this method will not work.

For example, to setup a single user whose ID is 2 to use Dutch, the ATUSERSP file can be updated with the following SQL statement:

Code Block
languagesql
UPDATE InstName/atusersp
set aulang = 'nl_NL'
where auuser = 2

"InstName" should be the library where your instance of Profound UI is installed. The default is PROFOUNDUI.

Then, when the user reloads Atrium, the interface will be in Dutch.

Changing the Language Identifiers from Older Versions with Existing Translations

Atrium includes a translations file, ATNTRANSP, which defines alternate texts for navigation and toolbar items. Each navigation/toolbar item can display different languages, depending on the users' language setting in ATUSERSP.AULANG. For a translated text to appear, the AULANG field data must match the ATNTRANSP.ANTLANG data. For example, if a user's AULANG is 'de_DE' and there are translations defined for the navigation/toolbar items, then the entries in ATNTRANSP.ATNLANG must also be 'de_DE'. Older versions of Profound UI could only use 3-character language fields. The newer versions (V6 FP0.4 and later) can use 5.

To allow a user's language to be different and migrate from an older language setting, queries like the following samples can be used:

Code Block
languagesql
UPDATE InstName/ATUSERSP
SET AULANG = 'de_DE'
WHERE AULANG = 'GER';

UPDATE InstName/ATNTRANSP
SET ANTLANG = 'de_DE'
WHERE ANTLANG = 'GER';

"InstName" should be the library where your instance of Profound UI is installed. The default is PROFOUNDUI.

Languages Provided for the Atrium Menu Interface

The following languages are provided with Atrium:

  • en_US = English, USA  (default)
  • en_UK = English, UK
  • de_DE = German, Germany
  • pt_PT = Portuguese, Portugal
  • pt_BR = Portuguese, Brazil
  • es_ES = Spanish, Spain
  • es_MX = Spanish, Mexico
  • fr_FR = French, France
  • fr_CA = French, Canada
  • it_IT = Italian, Italy
  • nl_NL = Dutch, Netherlands

Setting pui["language"] is all that's necessary for Atrium to provide text or messages in the language of your choice. (Note: not all messages and strings have been translated for every language yet. For those not yet translated, you can define them yourself as shown below.)

Customizing a Language

Any of the strings that are provided in the language dictionary of Atrium may be customized. To do that, you can define a string as follows:

...