BluePlant - Ferramenta Dictionaries – Base de Conhecimento

Este tutorial tem o objetivo de explicar como utilizar a ferramenta Dictionaries do supervisório BluePlant para alterar o idioma nos objetos de telas.

Componentes

Software: BluePlant v2018.1.37

Seções do Tutorial

1. ARQUITETURA

2. DESENVOLVIMENTO

2.1. Criação da Tela

2.2. Ferramenta Dictionaries

2.3. Script da tela

3. RESULTADO

4. VÍDEO

1. ARQUITETURA

A arquitetura deste tutorial é constituída do supervisório BluePlant instalado e funcionando corretamente em um computador.

2. DESENVOLVIMENTO

A ferramenta Dictionaries é utilizada para tornar objetos que contenham texto (Text Box, Text Output, Button, CheckBox, RadioButton, entre outros) traduzíveis em outros idiomas. É importante ressaltar que a tradução dos textos deve ser feita de forma manual.

Neste tutorial, foi desenvolvido um projeto em que o idioma de uma tela pode ser alterado para inglês, português ou francês. Este projeto estará disponível para download nos anexos para auxiliar no entendimento.

Obs1.: Os passos descritos neste tutorial podem ser repetidos para criar telas em qualquer idioma e com a quantidade de idiomas que for desejada.

Obs2.: Neste tutorial, não constam informações de como criar e executar um projeto ou inserir objetos na tela. Caso não conheça alguns desses procedimentos ou é iniciante na utilização desse supervisório, sugere-se olhar os tutoriais referentes ao BluePlant que estão em nossa Base de Conhecimento e dentre estes, recomenda-se ler o tutorial que explica como criar um projeto, cujo link está abaixo:

BluePlant - Criação de um Projeto

2.1. Criação da Tela

Com o projeto devidamente criado, vá no tópico Draw e na aba Drawing.

A tela foi construída utilizando os objetos Text Output (1) e Button (2) e através de um objeto ComboBox (3) é possível realizar a alteração do idioma da tela.

Para cada objeto que contém texto e que deseja-se realizar a alteração de idioma deve ser marcado o item Localizable. Dessa forma, o BluePlant irá reconhecer o objeto na ferramenta Dictionaries.

Por fim, selecione o Combo Box inserido. A esquerda da tela estarão algumas propriedades gráficas do objeto. No campo Uid, coloque o nome de identificação do objeto. Este nome será muito importante para execução do script, pois é através dele que o objeto gráfico Combo Box é vinculado ao script. Neste tutorial foi dado o nome "combo1" ao Combo Box.

2.2. Ferramenta Dictionaries

Após desenvolver a tela, vá no tópico Run e execute o projeto uma vez, através do comando Startup. Após a execução, ainda no tópico Run, clique em Dictionaries.

A ferramenta Dictionaries abrirá a direita da tela. Primeiramente, será criado a tradução para o idioma inglês. Para isso, na aba Localization clique no botão New.

A janela Create New dictionary abrirá. Digite um nome para o dicionário e clique em Ok.

Com o dicionário criado, iremos carregar as strings para traduzi-las de forma manual. Deixe marcado apenas o item Displays strings e clique em Load strings.

Diversas strings contidas no projeto serão carregadas. Delete as que não serão utilizadas, deixando apenas as que serão traduzidas. Na coluna OriginalText estarão as strings dos objetos com o idioma original (neste tutorial o português) e na coluna TranslatedText será inserido de forma manual a tradução para cada string (para este dicionário o inglês).

O dicionário English ficará da seguinte forma:

Repita esse mesmo procedimento para criar o dicionário Français (idioma francês) e na coluna TranslatedText insira as strings traduzidas para o francês, conforme a imagem abaixo:

Por fim, crie um dicionário Portugues. Nesse dicionário não será necessário carregar as strings, pois esse idioma já é o original utilizado neste tutorial e o Blueplant irá realizar a conversão dos textos de forma automática.

2.3. Script da tela

Após criar os dicionários, será desenvolvido o script que adiciona os itens (idiomas) ao objeto ComboBox, tornando possível a alteração do idioma da tela para o idioma selecionado pelo usuário.

Vá no tópico Draw e clique na aba CodeBehind.

Altere a linguagem de programação do script para CSharp (é a linguagem utilizada no script deste tutorial) e clique em Sim na Pop Up de aviso que será aberta.