Elipse Knowledgebase

• Os nomes de seções devem estar obrigatoriamente entre colchetes e sozinhos na linha.
• Não é feita diferença entre maiúsculas e minúsculas, tanto para os nomes de seções e variáveis como para os valores. Neste ponto é importante lembrar que não são permitidas duas variáveis com o mesmo nome em uma mesma seção, e que apenas o uso de letras maiúsculas e minúsculas não é suficiente para diferenciar um nome de outro.
• Espaços em branco não são considerados em torno do "=", mas são considerados em torno das vírgulas que separam os valores de uma mesma variável. Por exemplo, no caso da variável header ter a seguinte lista:

• O caractere ";" não pode ser utilizado como parte do nome de um identificador, porque nos modelos esse caractere indica o início de um comentário. A interpretação do arquivo será feita apenas até encontrar o ";" e tudo que estiver após será desconsiderado. Por exemplo:

• Linhas em branco são ignoradas na interpretação do arquivo. Então é possível utilizá-las à vontade para melhor organizar o modelo.
• Mesmo que alguma seção ou variável seja escrita de maneira incorreta, as operações de importação e exportação não irão falhar (exceto se a seção [Header] ou a variável header estiverem incorretas numa exportação). As variáveis possuem valores padrão, que são assumidos quando elas não forem definidas. Por isso, quando a operação não for executada conforme o esperado, aconselha-se verificar a maneira como as variáveis foram escritas no modelo.

Criando um modelo através do Gerenciador de Modelos do E3 Studio

Para utilizar o Gerenciador de Modelos do E3, basta clicar na opção Importar/Exportar, e uma vez aberta a janela da opção, clicar no botão [Configurar...]. As abas disponíveis para configuração são mostradas a seguir. Para finalizar a criação do modelo, basta clicar no botão [OK], estando em qualquer aba.


Aba Configurações

Nesta aba é possível definir as opções válidas tanto para importação quanto para exportação. Estas opções incluem a configuração do separador de colunas e da importação ou exportação do objeto-raiz, das associações e das coleções, além de definir o nome do modelo, caso o usuário deseje salvá-lo para utilizá-lo novamente.


Figura 1: Aba Configurações


Aba Importação

Nesta aba é possível definir as opções válidas apenas para importação. Estas opções incluem definir o comportamento quando estiver sendo importado um objeto ou uma associação duplicados.


Figura 2: Aba Importação


Aba Filtros

É possível definir aqui quais as classes que devem ser importadas ou quais as classes que não devem. A lista das classes é preenchida através do botão [Alterar...].


Figura 3: Aba Filtros


Aba Identificadores

Nesta aba são definidos os identificadores para as classes de objetos. O preenchimento não é obrigatório, apenas se alguma classe deve ser importada ou exportada utilizando um identificador no lugar do próprio nome.


Figura 4: Aba Identificadores


Aba Propriedades

Nesta aba são listadas as propriedades que deverão ser importadas ou exportadas. A lista deverá estar na ordem correta para a opção de exportação. No caso da importação, a ordem é definida pelo próprio arquivo CSV e não pelo modelo. O preenchimento é obrigatório para a exportação.

No caso da importação, só é necessário preencher esta lista apenas se alguma coluna estiver utilizando um identificador no lugar do nome da propriedade. Assim, a variável que define o identificador será criada corretamente. Aqui também é possível definir o agrupamento de duas ou mais propriedades numa mesma coluna.


Figura 5: Aba Propriedades


4) Dicas para melhor utilização dos modelos e da ferramenta

O separador de colunas

O arquivo CSV tem sua estrutura baseada em colunas. Para a identificação correta dessas colunas, é importante que a definição do separador entre elas esteja coerente na exportação e na importação. O mesmo separador de colunas deve ser usado em ambas as operações, para que seja possível importar corretamente os objetos. Uma opção é utilizar o separador de listas configurado no Windows. Essa configuração é feita através do menu Iniciar – Configurações – Painel de Controle – Opções Regionais e de Idioma.


Figura 6: Configurações regionais do Windows


Como esta configuração varia de computador para computador, é importante conferir se o separador utilizado no momento da geração do arquivo CSV é o mesmo configurado quando estiver sendo feita a importação.

Outra opção é configurar manualmente o separador de colunas, através da variável Separator, na seção [Configuration] do modelo. Neste caso, a configuração fica no modelo, e basta utilizar o mesmo modelo na exportação e na importação para garantir que o separador está configurado corretamente.


Agrupe colunas e torne seu arquivo mais versátil

A nova ferramenta traz uma opção prática para diminuir a quantidade de colunas do arquivo CSV. Algumas vezes, quando são exportados objetos diferentes em um mesmo arquivo CSV, pode haver o caso de se ter propriedades que não são comuns aos diferentes objetos, gerando arquivos com diversas colunas em branco. Por exemplo, considerando o caso de tags e blocos de comunicação, têm-se as propriedades N1 a N4 para tags que não são propriedades dos blocos. Por outro lado, as propriedades B1 a B4 dos blocos não são propriedades de tags. Um arquivo CSV para essas oito propriedades seria:

• A importação de Tags de Comunicação ou Tags OPC deve ser feita a partir de um Driver de Comunicação ou Driver OPC, respectivamente, com o mesmo nome dos Drivers do Elipse SCADA, para que as referências para os Tags sejam importadas corretamente.
• A importação de Tags RAM e Demo no E3 deve ser feita a partir de um Servidor de Dados chamado "Dados", também para garantir que as referências fiquem corretas.
• Quando o Elipse SCADA faz a exportação das tags, também é criado outro arquivo .E2F, com o sufixo _Alarms, que contém a configuração de alarmes. A importação desses alarmes no E3 deve ser feita a partir de uma Área previamente criada dentro de um Configurador de Alarmes. Se os tags do Elipse SCADA já tiverem sido importados corretamente, as referências nestes alarmes aparecerá em azul, indicando que o link está correto.
• Antes de importar as Telas do Elipse SCADA no E3 pela primeira vez, é necessário registrar no E3 Studio os controles ActiveX dos objetos de Tela E2Controls. Para isso, selecione a opção Ferramentas—Adicionar ActiveX, e selecione na lista um dos controles da biblioteca E2Controls, por exemplo, E2Animation, clicando a seguir em [OK].

Mantenha sempre um modelo básico para cada objeto

É interessante manter sempre um modelo para cada um dos objetos que mais frequentemente serão importados ou exportados. Por exemplo, um modelo para Drivers de Comunicação, um modelo para Alarmes, um modelo para Telas, outro para Servidores de Dados, e assim por diante, de acordo com as necessidades de cada usuário. Esses modelos básicos tornam mais fácil a configuração da ferramenta.

Eles podem conter, por exemplo, todas as propriedades que devem ser utilizadas, e quais os tipos de objetos desejados. Quando for iniciado um novo procedimento de importação ou exportação, basta selecionar o modelo básico e então clicar no botão [Configurar...]. Todas as configurações que forem encontradas no modelo básico já serão carregadas.

Na opção Salvar as alterações deste modelo em um arquivo INI, escolha um novo nome para o modelo, para que o básico não seja sobrescrito, e altere apenas o que for necessário.


Importe arquivos de tags gerados pelas versões antigas do E3 Studio

O formato dos arquivos CSV gerados pelas versões antigas do E3 na exportação de tags também é suportado pela ferramenta atual, bastando configurar um modelo corretamente. A Elipse Software fornece um modelo apropriado para essa importação, que se encontra no diretório de instalação do E3, na pasta Templates. Mas, caso necessite, a configuração de um novo modelo é simples.

No Gerenciador de Modelos do E3 Studio, siga os seguintes procedimentos:

1) Na aba Configurações, selecione o separador de listas do Windows como separador de colunas, desabilite as opções de importar/exportar o objeto-raiz, as associações e as coleções, e escolha um nome para o modelo.
2) Na aba Importação, deixe a configuração padrão.
3) Na aba Filtros, selecione a opção Incluir apenas estes objetos e clique no botão [Alterar...] para incluir as classes IOTag, IOBlock e IOBlockElement.
4) Na aba Identificadores, defina três identificadores de tipos. Clique no botão [+] e inclua as classes IOTag, IOBlock e IOBlockElement, e defina os identificadores PLC Tag, Block Tag e Element, respectivamente.


Figura 8: Definição dos identificadores para as classes de objetos


5) Na aba Propriedades, defina as propriedades que a versão antiga (2.0 ou anterior) exporta, e relacione com os identificadores utilizados no arquivo CSV. Para ObjectType, associe o identificador type. Para as demais, siga as instruções abaixo:


Figura 9: Escolha das propriedades

• Clique no botão [+] para adicionar as propriedades.
• Selecione a classe IOTag e inclua as propriedades Name, DocString, N1, N2, N3, N4, Scan, AllowRead, AllowWrite, EnableScaling, DeviceLow, DeviceHigh, EULow, EUHigh, ParamDevice, ParamItem.
• Selecione a classe IOBlock e inclua as propriedades B1, B2, B3, B4 e Size.
• Por fim, selecione a classe IOBlockElement e inclua a propriedade Index.
• Selecione as propriedades N e B aos pares e clique no botão [Agrupar propriedades]. Depois altere o nome da coluna de cada uma para N1/B1, N2/B2, etc..
• Altere o nome das colunas das seguintes propriedades: 

        - DocString para Description.
        - Scan para ScanTime.
        - AdviseType para Advise.
        - EnableScaling para Scaling.
        - EUHigh para High2.

6) Clique no botão [OK]. O modelo será salvo e está pronto para ser utilizado pela ferramenta. O arquivo com extensão .INI deve estar semelhante ao mostrado a seguir: