Dicionários e Localização

Localização da linguagem no Runtime

Neste contexto Localizar é transformar alguma coisa nos costumes locais, como a tradução de textos para o idioma local. Você pode mostrar o texto em seu aplicativo em tantas línguas que necessitar. Basta você criar um dicionário para cada idioma.

Image Removed

Para configurar a localização:

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.

Image Added

To set up the location:

1. Go to Run > Dictionaries -> Localization.

1. Click New

• Aparecerá a janela Criar Novo Dicionário Localização.

1. York, U..

   • The Create New Location Dictionary window will appear.

2. Type a name for the dictionary.

3. Click OK.

As mensagens de alarme podem também ser incluídas na localização, se o check-box correspondente na definição da mensagem estiver marcada (ver figura acima).

Em Info-Project-Settings, você também pode definir qual o default para Culture Information que o aplicativo deverá usar. Há disponível para scripts a propriedade runtime Client.CultureInfo que permite você alterar esta definição em tempo de execução.

Alguns objetos de visualização podem obter a informação Culture diretamente do sistema operacional, por isso, o procedimento correto é ter tanto a configuração de sistema operacional e as configurações do projeto com a cultura alvo para executar a aplicação.

Conjuntos de Enumeração

Você também pode usar os dicionários para traduzir os valores dos tags em texto. Por exemplo, um dispositivo pode ter um valor de 0 (desligado) ou 1 (ligado). Ao invés de exibir "0" ou "1", você pode exibir as palavras "Ligado" ou "Desligado".

Para configurar conjuntos de enumeração:

1. Clique Load Strings para preencher a tabela com todos os controles que têm textos que foram definidos como localizáveis. Na coluna TranslatedText, digite o texto no idioma do dicionário. Marque Alarm Messages se também desejar que as mensagens de alarme sejam localizadas.

2. Crie controles de visualização em uma Tela ou escreva um script para usar o objeto chamado Client.Dictionary para configurar o dicionário ou opções de dicionário para o usuário. Quando o dicionário é trocado as correspondências de textos são alteradas em toda a aplicação.

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.

Clique

1. Click New York, U..

Aparecerá a janela

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

Digite um nome para o dicionário

1. Type a name for the dictionary.

Clique em

1. Click OK.

Na coluna

1. In the "Tag State"

, digite o valor numérico, e na coluna

1. column, type the numeric value, and in the "Display text"

, digite o texto a ser exibido.

3. Para os Tags que usam os valores numéricos com o Conjunto de Enumeração, deve-se configurar a coluna Parâmetros para escolher o conjunto ser usado.

4. Ao configurar um componente de uma tela para usar estas tags, deve-se definir o TextOutput para um dos seguintes atributos:

   • Com "tagName" ou "Tagname.Value" para mostrar o valor numérico da tag.

   • Com "Tagname.ValueAsString" ou "Tagname.DisplayValue" para mostrar o texto do conjunto de enumeração.

Veja na figura um exemplo para a criação do Conjunto de Enumeração

1. column, type the text to display.

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

3. 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" para a definição dos estados de uma chave seccionadora:

Image Removed

Na definição do Tag veja a indicação para uso do dicionário do Conjunto de Enumeração:

Image Removed

Dicionário de Categorias

Um tag pode pertencer a uma categoria pré-definida de objetos. Por exemplo: tags de trafos, tags de alimentadores, tags de proteção, tags de alarmes, podem ser agrupados em categorias. As categorias devem ser pré-definidas no Dicionário de Categorias.

Você pode criar Categorias para permitir a classificação de vários tipos de objetos do projeto.

A maioria das tabelas de configuração, como Tags, Nós de Dispositivos, Grupos de Alarme, têm a coluna Categoria, onde você pode aplicar uma ou mais categorias para esse objeto.

Para criar categorias:

1. Vá para Run > Dictionaries > Categories .

2. Digite ou edite o nome e a descrição para a categoria.

3. Continue adicionando tantas categorias como você precisa.

4. Na abas Tag -> Objetos, para Tags novos ou já existentes, selecione a nova categoria na coluna Categoria. Outros elementos do projeto também podem usar categorias para organização do projeto.

Image Removed

Um mesmo tag ou objeto pode pertencer a várias categorias.

Por exemplo: suponha que foram definidas duas categorias: TAGS_DE_TRAFOS e TAGS_DE_MEDIDAS. Poderíamos querer pesquisar, dentro de um código de script, os tags que são de pontos de medição de tensão nos trafos. No cadastramento destes pontos especificaríamos no campo Categoria destes tags estas duas categorias.

Uma vez a Categoria criada, passará a estar disponível na lista de existentes na coluna Categoria da aba Objeto, para a criação de Tags. Para cada tag escolha todas em que o mesmo se enquadra.

As Categorias de objeto também pode ser acessadas durante o tempo de execução para a filtragem e outras aplicações personalizadas, utilizando a propriedade Categoria dos objetos, como critérios para a escolha de objetos. Uma lista de todas as categorias definidas no projeto está disponível em tempo de execução na propriedade "Server.Categories".

Dicionário de Unidades

Pode-se definir unidades de engenharia para serem utilizadas no projeto, como atributos de tags de medidas. Para a criação e alteração de dados de Unidades de Engenharia, também é utilizada esta tabela de Dicionários.

Para configurar Unidades de Engenharia:

1. Vá para Run > Dictionaries > Units.

2. Clique New.

   • Aparecerá a janela "Create new unit".

3. Digite um nome para esta unidade.

4. Clique em OK.

5. Na coluna "Base", digite a unidade base para este valor numérico, e na coluna "New", digite o texto a ser exibido.

Dicionário - Temas

Nesta área há também a aba para a definição de cores em objetos de visualização, a serem usadas nos Temas de Cores.

Image Removed

Informações completas sobre Temas, sua utilização e sua configuração estão disponíveis na secção Temas de Cores, na área deste guia.

enumeration set for defining the states of a disconnecting key:

Image Added

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

Image Added

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.

Image Added

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.

Image Added

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