Dictionaries and

Localization

Language localization in runtime

In this context Find is to transform something in local customs, such as the translation of texts into the local language. You can show the text in your app in as many languages as you need. All you have to do is create a dictionary for each language.

To set up the location:

1. Go to Run > Dictionaries -> Localization.

2. Click New York, U..

   • The Create New Location Dictionary window will appear.

3. Type a name for the dictionary.

4. Click OK.

1. Click Load Strings to populate the table with all controls that have text that have been set to Localizable. In the column TranslatedText, type the text in the dictionary language. Select Alarm Messages if you also want the alarm messages to be located.

2. Create preview controls on a screen or write a script to use the object called Client.Dictionary to configure the dictionary or dictionary options for the user. When the dictionary is exchanged the text matches are changed throughout the application.

Alarm messages can also be included in the location if the corresponding check-box in the message definition is checked (see figure above).

In Info-Project-Settings, you can also set which default for Culture Information the application should use. There are scripts available for the Runtime Client.CultureInfo property that allows you to change this setting at run time.

Some visualization objects can get culture information directly from the operating system, so the correct procedure is to have both the operating system configuration and the project settings with the target culture to run the application.

Enumeration Sets

You can also use dictionaries to translate tag values into text. For example, a device might have a value of 0 (off) or 1 (turned on). Instead of displaying "0" or "1," you can display the words "On" or "Off."

To set up enumeration sets:

1. Go to Run > Dictionaries > Enumeration Sets.

2. Click New York, U..

   • The "Create new Enumeration Set" window will appear.

3. Type a name for the dictionary.

4. Click OK.

5. In the "Tag State" column, type the numeric value, and in the "Display text" column, type the text to display.

6. For Tags that use numeric values with the Enumeration Set, you must configure the Parameters column to choose the set to use.

7. When you configure a component of a screen to use these tags, you must set textoutput to one of the following attributes:

   • With "tagName" or "Tagname.Value" to show the numeric value of the tag.

   • With "Tagname.ValueAsString" or "Tagname.DisplayValue" to show the text of the enumeration set.

The figure shows an example for creating the "AN_DISJ_STATES" enumeration set for defining the states of a disconnecting key:

In the tag definition see the indication for use of the Enumeration Set dictionary:

Category Dictionary

A tag can belong to a predefined category of objects. For example: trafos tags, feeder tags, protection tags, alarm tags, can be grouped into categories. Categories must be predefined in the Category Dictionary.

You can create Categories to allow the classification of various types of project objects.

Most configuration tables, such as Tags, Device Nodes, Alarm Groups, have the Category column, where you can apply one or more categories to that object.

To create categories:

1. Go to Run > Dictionaries > Categories .

2. Type or edit the name and description for the category.

3. Keep adding as many categories as you need.

4. In the tabs Tag -> Objects, for new or existing Tags, select the new category in the Category column. Other project elements can also use categories for project organization.

The same tag or object can belong to multiple categories.

For example: suppose two categories have been defined: TAGS_DE_TRAFOS and TAGS_DE_MEDIDAS. We might want to search, within a script code, the tags that are of stress measurement points in the trafos. In the registration of these points we would specify in the field Category of these tags these two categories.

Once the Category is created, it will be available in the existing list in the Category column of the Object tab, for tag creation. For each tag choose all that fits.

Object Categories can also be accessed during runtime for filtering and other custom applications, using the Object Category property as criteria for choosing objects. A list of all categories defined in the project is available at run time in the "Server.Categories" property.

Dictionary of Units

You can define engineering units to be used in the project, such as measure tag attributes. For the creation and alteration of Engineering Units data, this Dictionary table is also used.

To set up Engineering Units:

1. Go to Run > Dictionaries > Units.

2. Click New York, U..

   • The "Create new unit" window will appear.

3. Enter a name for this drive.

4. Click OK.

5. In the "Base" column, type the base unit for this numeric value, and in the "New" column, type the text to display.

Dictionary - Themes

In this area there is also the tab for setting colors on visualization objects, to be used in Color Themes.

Complete information about Themes their use and configuration are available in the Color Themes, in the area of this guide.