Test the language switching functionality at runtime

After you enable run-time language switching in your application, test the language switching functionality. Language switching of alarm and tag comments and alarm fields can be viewed only in the Alarm Viewer and Alarm DB View controls.

As you work with localized alarm and tag comments, be aware of the following:

• If the alarm or tag comment hasn't been translated to the language specified by $Language, the default comment appears in the alarm client.

• If an Alarm Viewer control is querying from multiple providers, the alarm comment, tag comment, and alarm fields from remote nodes also appear translated if the application has the translated dictionary files of the remote node applications.

• If you acknowledge an alarm and provide a comment, this comment appears in the alarm client instead of the localized alarm comment.

• When an Alarm Viewer control is in freeze mode, then the language does not appear switched even though you switched the language. The moment you unfreeze the control, the control is updated with the translated strings.

• The localization of the Alarm Viewer control is only for the display of the control. All script functions still return the default strings even though the language is switched.

• The Alarm DB Logger only stores the data default language strings in the database. The localized strings are not stored in the database.

• The unique IDs for the alarm fields such as EVENT and ACK, are predefined and have the same ID across multiple dictionary files in different nodes. Alarm clients pick the translation from the first loaded dictionary file and the translations from other dictionary files are ignored. Ideally, the alarm fields in all dictionary files should have the same translation in a language. Multiple alarm clients (Alarm DB View and Alarm Viewer controls) use the same translation for the same alarm state for a given language.

• Translated text is truncated to 131 characters for alarm comments and to 160 characters for tag comments.

Test the language switching functionality

1. Open the application in WindowViewer.

2. On the File menu, point to Configure, and then select Language and then select the name of the language to switch to.

   The information from the corresponding translated dictionary file (if one exists) loads and appears.

3. If you added a button to switch the language, select the button to test the script.