EPM Tag Port.

Introdução

Às vezes, é necessário realizar a análise ou investigação de algum comportamento incomum nos dados de uma aplicação. Para isso, é preciso transportar esse conjunto específico de dados de um EPM para outro, como no caso de uma instalação de testes, por exemplo. A partir desta necessidade real de analistas/engenheiros e integradores, criamos a ferramenta EPM Tag Port.

O conceito é permitir que o usuário possa carregar a ferramenta em um pendrive, e não precise instalá-la. Isso facilita seu uso, já que geralmente a coleta das informações ocorre em ambientes onde as instalações são controladas e de acesso restrito, enquanto que o acesso e coleta das informações no EPM Server exige login e senha do EPM.

O EPM Tag Port é um executável pequeno e configurável pelo usuário. Na operação Pack, ele se conecta a um EPM Server, consulta um período de dados de Basic Variables específicas, e então gera um arquivo HDF5 para posterior uso. Já na operação Unpack, o caminho é inverso: abrir um arquivo HDF5 e carregar esses dados em um EPM Server.

Escolhemos o formato HDF5 porque ele possui suporte em várias ferramentas de análise de dados de terceiros, além de ser amigável com Python e outros volumes maiores de dados.

 

Operação Pack

Aba EPM Server

Nesta etapa, deve-se informar o nome da máquina onde está instalado o EPM Server, o usuário do EPM, e sua senha. Qualquer usuário com permissão de leitura de tags pode acessar esta informação.

Também é possível definir as datas inicial e final da coleta. Note que essas datas precisam estar no formato UTC.

 

 

Aba Pack Info

Nesta etapa, iremos adicionar as Basic Variables de onde desejamos realizar a coleta. Na figura abaixo, já adicionamos duas Basic Variables previamente criadas no EPM Server. A remoção de algum tag adicionado na lista pode ser feito atravé do botão Remove.

 

 

Definindo o arquivo HDF5

Uma vez definidas essas configurações, é possível gerar o arquivo HDF5 clicando no botão Pack na barra de ferramentas. Uma janela será aberta, onde o usuário irá definir o nome do arquivo HDF5 e a pasta onde ele será gerado.

Todas as configurações feitas (conexão com o EPM Server, período de coleta e tags) podem ser salvas em um arquivo JSON, o que facilita futuras coletas. Esta opção está no menu File. Da mesma forma, a abertura de um arquivo de configuração já salvo é feita pelo mesmo menu, na opção Open.

Quando um arquivo de configuração previamente criado é aberto no EPM Tag Port, é importante que o usuário sempre utilize o botão Check disponível acima da lista de tags na aba Pack Info.

O objetivo principal deste comando é conectar ao EPM Server e verificar se os tags existentes na lista ainda se encontram disponíveis. Dessa forma, se alguma Basic Variable já tiver sido deletada, por exemplo, o usuário saberá previamente quais itens da lista não estão mais válidos para a coleta, efetuando então o ajuste da configuração.

 

NOTA: Limitações do EPM Tag Port:  os arquivos poderão conter até 1000 (mil) Basic Variables, e um período máximo de 5 anos de dados.

 

Operação Unpack

Esta operação faz o caminho inverso da operação Pack, ou seja: nela, o EPM Tag Port abrirá um arquivo HDF5 e irá carregar no EPM Server especificado pelo usuário.

Após a abertura do arquivo HDF5 no EPM Tag Port, é necessário configurar a conexão com o EPM Server que receberá os dados. Esta configuração é igual àquela àquela vista na operação de Pack.

Aba Package Info

Em seguida, selecionamos a aba Package Info. Nela, podemos visualizar as Basic Variables contidas no arquivo, juntamente com seu respectivo período de dados.

 

Na operação Unpack, o objetivo do botão Check é avaliar se o EPM Server configurado como destino já não possui tags com o mesmo nome que os presentes no arquivo HDF5 em questão. Caso positivo, a operação de Unpack não é permitida de forma direta, ou seja, nada será alterado no EPM Server destino de forma automática (as opções disponíveis serão descritas mais adiante).

 

Por outro lado, caso não haja nenhum conflito de nomes entre os tags, a mensagem abaixo será mostrada.

 

A partir desse instante, basta clicar no botão Unpack para realizar a operação.

Caso o usuário clique na operação Unpack sem ter feito a checagem de nomes antes, e esta apresente alguma inconsistência, mesmo assim a ferramenta irá solicitar ao usuário o que deseja fazer em relação a este conflito.

Existem duas opções disponíveis. Elas são:

• Manter as Basic Variables que existem no EPM Server destino e carregar apenas as tags que não possuem conflito de nome; ou
• Deletar as Basic Variables existentes no EPM Server destino que causam conflito de nome e carregar os dados do arquivo HDF5, mantendo o nome informado das Basic Variables.

 

Para mais informações, consulte os links abaixo:

https://github.com/elipsesoftware/EPMTagport

https://github.com/elipsesoftware/EPMTagport/blob/master/examples/Basics_TagPort_HDF5.ipynb