Dictionaries are tables which are used to add functionality to your project. There are the following types of dictionaries:

Localization: allows the creation of translated texts so you can run your application in multiple languages.

Enumeration sets: connect a number with pre-defined strings.

Categories: organize your project's defined categories for Tags, Symbols, etc. 







Localization

You can localize the text in your application in as many languages as needed. To do this, create a dictionary for each language. 

To localize the user interface text, be sure to select the Localizable option (Dynamics Configuration window, TextOutput options) for each display component that you need to localize.

To create a localization dictionary:

  • Go to Run > Dictionaries -> Localization.
  • Click New.
  • The Create New Localization Dictionary window will display.
  • Enter a name for the dictionary.
  • Click OK.
  • Click Load Strings to populate the table with all of the controls that have strings that are set to Localizable. In the TranslatedText column, enter the text in the dictionary language.
  • Create controls in a display or write a script to use the object called Client.Localization to configure the dictionary or dictionary options for the user. When the dictionary changes, the language changes throughout the application.

The alarm messages can also be included in the localization if the related check-box is set.

In Info-Project-Settings, you can define the default Culture Information that the application is using. The runtime property Client.CultureInfo allows you to change it during runtime. Some display controls may get the Culture Info directly from the Operating System. In this situation, the correct procedure is for both the Operating System settings and the project settings to have the application's target culture. 



Enumeration Sets

You can also use dictionaries to "translate" tag values to text. These dictionaries are called Enumeration Sets. For example, a device may have a value of 0 (grey lightbulb) or 1 (lightbulb). Rather than display "0" or "1," you can display the strings "on" or "off."

To configure Enumeration sets:

  • Go to Run > Dictionaries > Enumeration Sets.
  • Click New.
  • The Create New Dictionary window will display.
  • Enter a name for the dictionary.
  • Click OK.
  • In the Value column, enter the numeric value. In the Translated Text column, enter the string that you want to display.
  • For tags that use numeric values as Enumeration Set, configure the Parameters column to use this set.
  • When configuring a display component to use these tags, set the TextOutput to one of the following:
  • Tagname or Tagname.Value: show the numeric value of the tag.
  • Tagname.ValueAsString or Tagname.DisplayValue: show the enumeration string.


Categories

You can create a dictionary of Categories to allow classification of engineering objects. Most configuration tables have the Category column, where you can apply one or more categories to that object.

  • Go to Run > Dictionaries > Categories.
  • Edit the desired categories for this project.

The object categories can also be accessed during runtime (for filtering and other custom applications) from the Category property of the objects. A list is available of all the categories that are defined in the Project during runtime in the property Server.Categories. 



  • No labels