Activating System Languages

• Activating System Languages
  • Overview
  • Process
    • Configure System Languages
    • Maintaining the msesys.config.multivaluedI18Nsetting Preference
  • Entering Content into Multi-language Text Fields
    • Effect of Deactivating System Languages
  • Selecting a Client Invoice or Report Language in a drop-down List
  • Configuring the CCLAS 6 User Interface Language
  • Maintaining System Table Localisations

Overview

A language that is configured for the system can be activated for use which makes it available for:

• Entering content into multi-language text fields.
• Selecting a client invoice or report language in a drop-down list.
• Configuring the screen label language.
• Maintaining system table localisations.

Process

Configure System Languages

To make a language available to CCLAS 6, the language must first be entered as a system table code with a Table Type of DLAN—Display system languages. Refer to Maintaining System Table Codes. After that, the language can be activated or deactivated for use within the system.

Configure system languages

The active system languages are configured using the msesys.config.multivaluedI18Nsetting user preference.

The preference is applied at the following scopes:

• System—Where the Laboratory, User Id and Role are empty, then each listed language in the preference, where the language is a valid system language, applies to all users. Each activated language is available for use at the next login or change of user credentials, for all users of the system.

• Laboratory—Where the Laboratory is defined and User Id and Role are empty, then each listed language in the preference, where the language is a valid system language, applies to all users who log in to the laboratory at the next log in or change of user credentials.

• User—Where the User Id is defined and laboratory and Role are empty, then each listed language in the preference, where the language is a valid system language, applies to the user at the next log in or change of user credentials, however:

  • The system languages available for activation at the user level are those active at the system level, that is, where a language code is added for a user, but the language code is not configured at the system level or is not activated for all users, then it is ignored for the user.

  • Where a language code is added for a user and also set at the laboratory or instance level, then the user level definition is applied when the user logs in.

That is, the system cannot react to the language of the browser only, but sets the base language and an alternate language, for example, a base language of ES_LA and an alternate language of EN_US. That is, there cannot be any combination of settings to make the system presume that the default text values on items are in an alternate language without actually locking in that language on the UI.

ria.force.label.localisation	msesys.config.multivaluedI18Nsetting	UI labels	Entry of values that support I18N	Entry of alternative I18N values	Comments
<not defined> or <empty>	<not defined> or <empty>	Reacts to Browser Language	ReadOnly (as EN_US)	None available	Presumes EN_US as default
<not defined> or <empty>	Defined with single language as EN_US	Reacts to Browser Language	ReadWrite (as EN_US)	None available	Presumes EN_US as default
<not defined> or <empty>	Defined with single language as ES_LA	Reacts to Browser Language	ReadOnly (as EN_US)	ReadOnly (as ES_LA)	Presumes EN_US as default
<not defined> or <empty>	Defined with 2 language as ES_LA, EN_US	Reacts to Browser Language	ReadWrite (as EN_US)	ReadWrite (as ES_LA)	Presumes EN_US as default
<not defined> or <empty>	Defined with 2 language as EN_US, ES_LA	Reacts to Browser Language	ReadWrite (as EN_US)	ReadWrite (as ES_LA)	Presumes EN_US as default
ES_LA	Defined with single language as EN_US	Locks into ES_LA	ReadOnly (as ES_LA)	ReadOnly (as EN_US)
ES_LA	Defined with 2 language as EN_US, ES_LA	Locks into ES_LA	ReadWrite (as ES_LA)	ReadWrite (as EN_US)
ES_LA	Defined with 2 language as ES_LA, EN_US	Locks into ES_LA	ReadWrite (as ES_LA)	ReadWrite as EN_US
ES_LA	<not defined>	Locks into ES_LA	ReadOnly (as ES_LA)	None available
EN_US	Defined with single language as EN_US	Locks into EN_US	ReadWrite (as EN_US)	None available
ES_LA	Defined with single language as ES_LA	Locks into ES_LA	ReadWrite (as ES_LA)	None available
EN_US	<not defined>	Locks into EN_US	ReadOnly (as EN_US)	None available
EN_US	Defined with single language as ES_LA	Locks into EN_US	ReadOnly (as EN_US)	ReadOnly (as ES_LA)

Maintaining the msesys.config.multivaluedI18Nsetting Preference

The the msesys.config.multivaluedI18Nsetting system preference, scoped by system or user, controls whether system languages are active or not.

System languages can be activated or deactivated at system level using the MSESYS—System Preferences application.

Activate/Deactivate system languages for the system

System languages can be activated or deactivated at user level using the CCUSER—User application.

Activate/Deactivate a system language for a user

Currently, the CCLBRT—Laboratory application cannot update this preference at laboratory level, however, the MSEPRF—User Preferences application can be used to maintain this preference at any scope.

Activate/Deactivate system languages by directly accessing the multivaluedI18Nsetting user preference

Note: To configure system languages, use Maintaining System User Preferences to update the preference manually. Example: EN_AU,EN_GB,EN_MY,EN_US,ES_ES,ES_LA,FI_FI,FR_CA,FR_FR,PT_BR,RU_RU,ZH_CN

The Property accessed is msesys.config.multivaluedI18Nsetting.

The expected Counter is 00000000.

The Value is entered as comma-separated list of 4-alpha locale codes for the languages that are to be active for the interface, for example, EN_AU, PT_BR, FR_FR to add Australian English, Brazilian Portuguese and European French.

Note: Since this application allows for the entry of any text as the preference value, care must be taken when setting it up this way. If a language that is not in the DLAN table is entered into the Value field, , then that language is ignored.

Entering Content into Multi-language Text Fields

The content of any text field is reportable. It is a requirement that reports are generated in the language of the recipient. Therefore, where applicable, I18N text fields are provided.

For any I18N text field, text for the default system language, as configured by the browser, is entered into the main text field, and alternate language text is entered by accessing the multi-language input text areas using the language button next to the fields.

One text area is provided for each active alternate system language. If no alternate system languages are activated, then no I18N alternate language text areas are shown.

Where a user is configured to have a subset of these system languages active for them, then multi-language input text areas are displayed for that subset of languages. Where a system language is deactivated, then it is no longer deemed active for the user.

Effect of Deactivating System Languages

When a system language is deactivated, any existing content remains in the system but is not accessible unless the language is reactivated for the applicable scope.

Selecting a Client Invoice or Report Language in a drop-down List

When selecting the language for a client's invoice or for a report request's report, the list of languages available in the drop-down list is populated from the active system languages. Refer to Maintaining Invoicing Details for a Client and Maintaining Reports for a Report Request.

Where a user is configured to have a subset of these system languages active for them, then the drop-down list is limited to that subset of languages. Where a system language is deactivated, then it is no longer deemed active for the user.

Configuring the CCLAS 6 User Interface Language

The ria.force.label.localisation system user preference controls which label language is used to display:

• Login and menu buttons
• Labels
• Enumerations
• Online help.

Note: This preference is only applicable at a system level, and not at the laboratory, role or user level.

The MSEPRF—User Preferences application is used to create or update this preference.

Force the user interface to use a specific locale

Note: System user preference settings are held in a cache on the server. If a system user preference is changed, it can take some time to have the settings updated in the server cache, and sometimes, depending on the setting that is updated, can require a server restart for the new setting to take effect.

Where the ria.force.label.localisation system user preference is not set or not present, a user can change the CCLAS 6 user interface language via CCLAS 6 Desktop settings.

Select the desktop locale, where the user interface is not forced to use a specific locale

For example,

1. Force the user interface to use EN_US. Allow time for the system user preference to take affect in the server cache (refer to the note above).

2. Open the CCLAS 6 Desktop.

3. Select the desktop locale as fr-CA.

4. Restart the CCLAS 6 Desktop.

5. Login into CCLAS 6.

6. Launch an application and view the literals displayed in fr-CA.

Maintaining System Table Localisations

Simple drop-down lists available on various CCLAS fields, as configured in the MSF010 system table, are displayed on the screen using the language of the browser. Refer to Maintaining system table localisations to enter translations for table codes to languages configured in CCLAS. Table code localisations can be used by report scripts to report the string in the appropriate language.