Esta extensão faz parte do aplicativo de Engenharia do Action.NET e tem como objetivo facilitar a construção de novos projetos por meio da importação de esquemas de estruturas de dados. Ela permite a definição de templates, mapeamento de pontos de aquisição de dados, especificação de critérios de alarmes e configuração de parâmetros para o historiador.

A partir de sua execução, é possível criar no projeto novos elementos como assets, tag objects, templates, alarm items, channels, nodes e points em devices, ampliando significativamente a automação e a padronização dos processos de engenharia.

Informação Geral

A principal finalidade desta extensão é auxiliar na customização de projetos básicos voltados à supervisão de instalações com arquiteturas relativamente repetitivas. Esses projetos geralmente seguem um padrão razoável de dados referentes aos equipamentos monitorados, que frequentemente precisam ser ajustados com a inclusão de novos tags.

Essas alterações são realizadas a partir de arquivos de definição que contêm templates e tags adicionais, os quais são incorporados às estruturas básicas previamente definidas nos projetos. Além dos tags e templates, também são considerados elementos como a criação de assets, devices, alarmes e a definição de parâmetros para dados históricos.

Características principais

As características principais para a utilização desta extensão na criação de projetos são:

Necessidade de criação de vários projetos para instalações similares, como subestações de uma mesma concessionaria.
Geração de um projeto básico com templates gerais para modelar este tipo de instalação.
Utilização de um banco de dados com a definição de alterações dos templates básicos (estrutura apresentada a seguir)
Arquivos de texto csv com especificações para criação de canais e nodes, se for desejada esta criação automática
A extensão tem a capacidade de criar assets, templates, tag objects inserir novos tags em templates existentes, e novos sub-templates nos templates principais.
A extensão criará registros de POINTS, itens de alarme e itens de historiador, seguindo as mesmas sintaxes de categorias e comments já utilizadas na Extensão DEPLOY.https://spineng.atlassian.net/wiki/spaces/ANUG/pages/88375661 ;
Se forem disponibilizados arquivos de texto formato csv com protótipos dos equipamentos (bays), incluindo lista de pontos com tags e seus endereços utilizando os protocolos DNP3 e IEC104 ou IEC61850, a extensão também poderá criar estes canais, nodes e points.
Para a funcionalidade de gateway com centros de operações serão criados os pontos para os canais e nodes deste tipo de comunicação, utilizando IEC104 server.

Base de dados de Entrada

A base de dados de entrada será a definida na ficha DataSets projeto básico como ProjectInternal.

Nesta base de dados devem ser colocadas tabelas com as tags a serem inseridas em templates. Estas tabelas terão o nome de um tag object seguido de underscore e o nome do template a ser utilizado. Exemplo FD1_FEEDER, deve ser o nome da tabela para criação ou alteração de uma tag object de nome FD1 que utiliza o tipo FEEDER (nome do template).

O formato desta tabela deve seguir a definição de criação de tabela abaixo:

CREATE TABLE "FD1_FEEDER" (
    "id"	INTEGER,       --id do registro, numero auto incrementado
    "level"	TEXT,          --Texto com o level (asset) em que está o tag deste registro
    "type"	TEXT,          -- nome do template (tipo) em que es´s definido este tag
	"ied"	TEXT,          -- Nome do IED em que será lido este tag (o Node terá o prefixo NOD_)
	"bay"	TEXT,          -- Nome do bay, isto é o tagObject definido para este tag
	"tag"	TEXT,          -- Nome do tag, ormalmente um node de tag dentro dee template
	"description"	TEXT,  -- Descrição do tag
	"state0"	TEXT,      -- Texto para estado do tag com valor 0
	"state1"	TEXT,      -- Texto para estado do tag com valor 1
	"state2"	TEXT,      -- Texto para estado do tag com valor 2
	"state3"	TEXT,      -- Texto para estado do tag com valor 3
	"tagFull"	TEXT,      -- texto completo do nome do tag comlevel, bay e tag folha
	"tagType"	TEXT,      -- Type padrão do tag folha, como Integer, Double,...
	"comment"	TEXT,      -- commnet do tag, onde devem ser incluidas definiçõse para o Deploy
	"category"	TEXT,      -- categorias a sererm usada pelo Deploy prefixos ALARMGROUP_, HIS_, NODE_
	"subType"	TEXT,      -- nome do template de segundo nivel, que de fato contém os tga folhas. 
                           -- Deve ter o formato <tipo>_<subtipo> ex. FEEDER_STA
	"normal"	TEXT,      -- estado normal do ponto. um numero entre 0 e 3 para digitais.
	PRIMARY KEY("id" AUTOINCREMENT)

Observações:

Basta uma destas definições para a criação de cada template. Vários tag objects podem ser definidos para ser criados com o mesmo template. As linhas que definem tag objects devem ter o nome do tag VAZIO. Veja as linhas com os IDs 25 e 26 definem criação de tag objects. as demais a criação dos tag folhas do template secundário.
Se for definida mais de uma categoria, elas devem ser separadas por “;”
Os textos para estado da tag (state0, state1,…) serão utilizados para a criação de dicionários de enumeração, com o cuidado de não duplicação dos que utilizarem os mesmos pares de valor-texto.
Os nomes de templates e sub templates devem ser únicos. Não serão criados novos templates com o mesmo nome. Caso ao ser feita uma execução da Extensão, em que se colocou novos tags em um template já existente, estes tags serão incluidos nos templates especificados.
A coluna comment deve ser preenchida com todos os atributos necessários segundo a definição da Extensão DEPLOY, para a criação de items de alarmes e item para o historiador.
Se se pretende utilizar também o engine do DEPLOY para a criação de Points, estas definições devem ser feitas no campo Comments e com a atribuição de categorias com prefixo NODE_.
Alternativamente a criação de points pode ser feita pela definição de arquivos de protótipos de bays com os mapas de endereçamento.

Nesta extensão, toda a criação de Assets, Tags, Templates e Tag Objects sempre é feita somente a partir das definições de dados incluídas nestas tabelas da base de dados.

Criação de canais e nodes

A criação de canais e nodes NÃO é obrigatoriamente feita por esta extensão. Poderão ser feita manualmente. Obviamente para a criação de Points deverão existir os Canais e Nodes nos quais estes pontos devam estar contidos.

Para utilizar da facilidade de criação de Canais e Nodes deverão ser disponibilizados os seguintes arquivos, descritos a seguir:

Arquivos de texto csv com a prototipação dos tipos de bays, ou equipamentos;
Arquivos de texto csv para configuração de vários bays;

Arquivos de protótipos de bays

Nesta extensão o nome dos arquivos é feito por “DEV_” seguido do nome do template. Por exemplo DEV_FEEDER para a definição dos dados de device do template(bay) FEEDER. Toda as demais definições do conteúdo destes arquivos pode ser encontrada na documentação de https://spineng.atlassian.net/wiki/spaces/ANUG/pages/932904988/Extens+o+Gateway+de+Equipamentos#Arquivos-de-configura%C3%A7%C3%A3o .

Nestes arquivos há uma parte inicial que define os protocolos, parametrização de canais e nodes dos devices a serem criados. Esta parte é a necessária para a criação destes objetos.

A parte seguinte destes arquivos, que define o mapa de endereços, para a configuração da tabela POINTS no projeto, poderá ou não estar presente:

Se o endereçamento for feito nos comments para que os points sejam criados pelo engine DEPLOY, NÃO devem ser incluídos nestes arquivos.
O endereçamento deve ser incluído nestes arquivos se não for ser utilizado o Deploy para isto. Neste caso a criação dos Points será feita por esta extensão, utilizando este mapa de endereçamento incluído no arquivo.

Arquivos para configuração de vários bays

Este é um arquivo texto de configuração, com os dados para cada bay cujos canais e nodes devam ser criados. Deve estar no diretório do projeto e será escolhido ao executar a extensão (descrito no item seguinte).

Conteúdo do Arquivo

O arquivo deve ter uma linha para cada equipamento. A linha de cabeçalho indica os campos que devem ser preenchidos separados por virgulas. Pode-se inclui linhas de comentários iniciado por “//”.

A palavra NEW: deve ser utilizada antes do nome do canal sempre que de desejar a criação de novo canal. Em caso contrário o nome do canal em que o node deve ser incluído.

Ao criar este arquivo, tenha o cuidado de fazê-lo, colocando as definições na correta sequencia, de acordo com o cabeçalho que indica os campos esperados. Caso algum dos campos não forem usados em uma linha, deixe um vazio entre as virgulas para que não haja deslocamento dos textos.

O node será criado com o nome NOD_ seguido do texto na coluna NodeName, Por exemplo, para a primeira linha, no arquivo acima, será criado o node NOD_DEVUP01

Execução da Extensão Project Importer

Para a customização de um projeto é utilizada a extensão Action.NET – Project Importer.

Com o projeto aberto vá em Run > Extensions e clique no símbolo do Project Importer.

Será mostrada a janela de parametrização desta extensão.

Caso se deseja usar o Arquivo de configuração de vários bays, clicando o botão ao lado do campo Arquivo de Configuração, aparece uma janela para a escolha do arquivo. Ao escolher o nome aparecerá no campo correspondente.

Após isto pressione o botão EXECUTE. A extensão iniciará o trabalho lendo a base de dados e executando as tarefas solicitadas. Aparecerá nos campos da janela mensagens indicativas do progresso da execução. O ultimo texto será Finalizando!. Basta então pressionar o botão Ok para encerrar o trabalho.

Nesta página: