{"id":13797,"date":"2023-07-12T10:13:34","date_gmt":"2023-07-12T13:13:34","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=13797"},"modified":"2023-07-12T10:13:34","modified_gmt":"2023-07-12T13:13:34","slug":"epm-tag-port","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/epm-tag-port\/","title":{"rendered":"EPM Tag Port."},"content":{"rendered":"

Introdu\u00e7\u00e3o<\/h3>\n

\u00c0s vezes, \u00e9 necess\u00e1rio realizar a an\u00e1lise ou investiga\u00e7\u00e3o de algum comportamento incomum nos dados de uma aplica\u00e7\u00e3o. Para isso, \u00e9 preciso transportar esse conjunto espec\u00edfico de dados de um EPM<\/a> para outro, como no caso de uma instala\u00e7\u00e3o de testes, por exemplo. A partir desta necessidade real de analistas\/engenheiros e integradores, criamos a ferramenta EPM Tag Port<\/strong>.<\/p>\n

O conceito \u00e9 permitir que o usu\u00e1rio possa carregar a ferramenta em um pendrive, e n\u00e3o precise instal\u00e1-la. Isso facilita seu uso, j\u00e1 que geralmente a coleta das informa\u00e7\u00f5es ocorre em ambientes onde as instala\u00e7\u00f5es s\u00e3o controladas e de acesso restrito, enquanto que o acesso e coleta das informa\u00e7\u00f5es no EPM Server exige login e senha do EPM.<\/p>\n

O EPM Tag Port \u00e9 um execut\u00e1vel pequeno e configur\u00e1vel pelo usu\u00e1rio. Na opera\u00e7\u00e3o Pack<\/strong>, ele se conecta a um EPM Server, consulta um per\u00edodo de dados de Basic Variables espec\u00edficas, e ent\u00e3o gera um arquivo HDF5 para posterior uso. J\u00e1 na opera\u00e7\u00e3o Unpack<\/strong>, o caminho \u00e9 inverso: abrir um arquivo HDF5 e carregar esses dados em um EPM Server.<\/p>\n

Escolhemos o formato HDF5 porque ele possui suporte em v\u00e1rias ferramentas de an\u00e1lise de dados de terceiros, al\u00e9m de ser amig\u00e1vel com Python e outros volumes maiores de dados.<\/p>\n

 <\/p>\n

Opera\u00e7\u00e3o Pack<\/h3>\n

Aba EPM Server<\/h4>\n

Nesta etapa, deve-se informar o nome da m\u00e1quina onde est\u00e1 instalado o EPM Server, o usu\u00e1rio do EPM, e sua senha. Qualquer usu\u00e1rio com permiss\u00e3o de leitura de tags pode acessar esta informa\u00e7\u00e3o.<\/p>\n

Tamb\u00e9m \u00e9 poss\u00edvel definir as datas inicial e final da coleta. Note que essas datas precisam estar no formato UTC.<\/p>\n

 <\/p>\n

\"\"
Aba EPM Server: Pack<\/figcaption><\/figure>\n

 <\/p>\n

Aba Pack Info<\/h4>\n

Nesta etapa, iremos adicionar as Basic Variables de onde desejamos realizar a coleta. Na figura abaixo, j\u00e1 adicionamos duas Basic Variables previamente criadas no EPM Server. A remo\u00e7\u00e3o de algum tag adicionado na lista pode ser feito atrav\u00e9 do bot\u00e3o Remove<\/em>.<\/p>\n

 <\/p>\n

\"\"
Aba Pack Info: Pack<\/figcaption><\/figure>\n

 <\/p>\n

Definindo o arquivo HDF5<\/h4>\n

Uma vez definidas essas configura\u00e7\u00f5es, \u00e9 poss\u00edvel gerar o arquivo HDF5 clicando no bot\u00e3o Pack<\/strong><\/em> na barra de ferramentas. Uma janela ser\u00e1 aberta, onde o usu\u00e1rio ir\u00e1 definir o nome do arquivo HDF5 e a pasta onde ele ser\u00e1 gerado.<\/p>\n

\"\"
Bot\u00e3o Pack<\/figcaption><\/figure>\n

Todas as configura\u00e7\u00f5es feitas (conex\u00e3o com o EPM Server, per\u00edodo de coleta e tags) podem ser salvas em um arquivo JSON, o que facilita futuras coletas. Esta op\u00e7\u00e3o est\u00e1 no menu File<\/em><\/strong>. Da mesma forma, a abertura de um arquivo de configura\u00e7\u00e3o j\u00e1 salvo \u00e9 feita pelo mesmo menu, na op\u00e7\u00e3o Open<\/em><\/strong>.<\/p>\n

Quando um arquivo de configura\u00e7\u00e3o previamente criado \u00e9 aberto no EPM Tag Port, \u00e9 importante que o usu\u00e1rio sempre utilize o bot\u00e3o Check<\/em> dispon\u00edvel acima da lista de tags na aba Pack Info<\/em><\/strong>.<\/p>\n

O objetivo principal deste comando \u00e9 conectar ao EPM Server e verificar se os tags existentes na lista ainda se encontram dispon\u00edveis. Dessa forma, se alguma Basic Variable j\u00e1 tiver sido deletada, por exemplo, o usu\u00e1rio saber\u00e1 previamente quais itens da lista n\u00e3o est\u00e3o mais v\u00e1lidos para a coleta, efetuando ent\u00e3o o ajuste da configura\u00e7\u00e3o.<\/p>\n

\"\"
Opera\u00e7\u00e3o Pack conclu\u00edda<\/figcaption><\/figure>\n

 <\/p>\n

NOTA:<\/strong><\/span> Limita\u00e7\u00f5es do EPM Tag Port:\u00a0 os arquivos poder\u00e3o conter at\u00e9 1000 (mil) Basic Variables, e um per\u00edodo m\u00e1ximo de 5 anos de dados.<\/p>\n

 <\/p>\n

Opera\u00e7\u00e3o Unpack<\/h3>\n

Esta opera\u00e7\u00e3o faz o caminho inverso da opera\u00e7\u00e3o Pack, ou seja: nela, o EPM Tag Port abrir\u00e1 um arquivo HDF5 e ir\u00e1 carregar no EPM Server especificado pelo usu\u00e1rio.<\/p>\n

\"\"
Bot\u00e3o Open<\/figcaption><\/figure>\n

Ap\u00f3s a abertura do arquivo HDF5 no EPM Tag Port, \u00e9 necess\u00e1rio configurar a conex\u00e3o com o EPM Server que receber\u00e1 os dados. Esta configura\u00e7\u00e3o \u00e9 igual \u00e0quela \u00e0quela vista na opera\u00e7\u00e3o de Pack.<\/p>\n

Aba Package Info<\/h4>\n

Em seguida, selecionamos a aba Package Info<\/strong>. Nela, podemos visualizar as Basic Variables contidas no arquivo, juntamente com seu respectivo per\u00edodo de dados.<\/p>\n

\"\"
Aba Pack Info: Unpack<\/figcaption><\/figure>\n

 <\/p>\n

Na opera\u00e7\u00e3o Unpack, o objetivo do bot\u00e3o Check<\/strong> \u00e9 avaliar se o EPM Server configurado como destino j\u00e1 n\u00e3o possui tags com o mesmo nome que os presentes no arquivo HDF5 em quest\u00e3o. Caso positivo, a opera\u00e7\u00e3o de Unpack n\u00e3o \u00e9 permitida de forma direta, ou seja, nada ser\u00e1 alterado no EPM Server destino de forma autom\u00e1tica (as op\u00e7\u00f5es dispon\u00edveis ser\u00e3o descritas mais adiante).<\/p>\n

\"\"
Opera\u00e7\u00e3o Unpack Com Conflito<\/figcaption><\/figure>\n

 <\/p>\n

Por outro lado, caso n\u00e3o haja nenhum conflito de nomes entre os tags, a mensagem abaixo ser\u00e1 mostrada.<\/p>\n

\"\"
Opera\u00e7\u00e3o Unpack Sem Conflito<\/figcaption><\/figure>\n

 <\/p>\n

A partir desse instante, basta clicar no bot\u00e3o Unpack<\/em> <\/strong>para realizar a opera\u00e7\u00e3o.<\/p>\n

\"\"
Bot\u00e3o Unpack<\/figcaption><\/figure>\n

Caso o usu\u00e1rio clique na opera\u00e7\u00e3o Unpack sem ter feito a checagem de nomes antes, e esta apresente alguma inconsist\u00eancia, mesmo assim a ferramenta ir\u00e1 solicitar ao usu\u00e1rio o que deseja fazer em rela\u00e7\u00e3o a este conflito.<\/p>\n

\"\"
Resolu\u00e7\u00e3o de Conflitos<\/figcaption><\/figure>\n

Existem duas op\u00e7\u00f5es dispon\u00edveis. Elas s\u00e3o:<\/p>\n