<< Clique para Mostrar o Sumário >>
Sintaxe dos Templates |
Para extrair o conteúdo de uma mensagem é necessário declarar um Template, que permite informar o formato da mensagem e quais partes devem ser transformadas em dados. Os Templates podem ser do tipo JSON, CSV ou XML. Cada Template deve utilizar palavras-chave, que devem ser colocadas no lugar dos valores a serem extraídos. As palavras-chave disponíveis estão descritas na tabela a seguir.
Palavras-chave disponíveis para Templates
Palavra-chave |
Descrição |
---|---|
TS_TEXT(format) |
Estampa de tempo, em formato textual, que é usada como estampa de tempo do Tag Bloco ou Tag de Comunicação. O significado de cada campo está descrito na tabela Opções disponíveis para a palavra-chave TS_TEXT |
TS_UNIX |
Estampa de tempo, no formato de segundos desde 1970 (formato UNIX). Este valor pode ser numérico ou textual, e é usado como estampa de tempo do Tag Bloco ou Tag de Comunicação, como por exemplo 1504198675 ou "1504198675" |
TS_DAYS1900 |
Estampa de tempo, em formato numérico, cujo valor é o número de dias desde primeiro de janeiro de 1900, também conhecido como Calendário Gregoriano, e é usado como estampa de tempo do Tag Bloco ou Tag de comunicação, como por exemplo 43595.37373843. Esta palavra-chave só está disponível em Templates do tipo JSON ou XML |
TS_UNIX_TZ_SECONDS+ TS_UNIX_TZ_SECONDS- |
Fuso horário, em segundos, informado separadamente da palavra-chave TS_UNIX. Deve ser informado um símbolo de + (mais) ou - (menos) para indicar se os segundos devem ser adicionados ou removidos, respectivamente, da palavra-chave TS_UNIX para representar a estampa de tempo da mensagem. Esta palavra-chave só está disponível em Templates do tipo JSON |
QL_OPC |
Qualidade, no padrão OPC DA, utilizando um byte. Este valor é usado diretamente como valor de qualidade no Tag Bloco ou Tag de Comunicação, sem transformações. Consulte a tabela Padrão OPC DA para mais informações |
QL_BOOL |
Qualidade no padrão Booleano. Se o valor é maior que 0 (zero) ou a expressão "true" ou "TRUE", a qualidade é boa. Se o valor é igual a 0 (zero) ou a expressão "false" ou "FALSE", a qualidade é ruim |
V1, V2, ... V50 Template JSON |
Declara um ou mais valores, que podem ser extraídos individualmente para Tags de Comunicação, através da especificação do terceiro parâmetro de endereçamento (param). Se todos os valores de uma mensagem são mapeados para um Tag Bloco único, então é possível usar a palavra-chave E3VAL para qualquer valor a ser extraído, indistintamente |
E3VAL |
Especifica um valor que é extraído na sequência que ocorre para um Tag Bloco, cada valor em um Elemento de Bloco. Se houver apenas um valor E3VAL na mensagem, o Template também pode ser usado com um Tag de Comunicação |
DUMMY |
Campo variável, mas cujo valor não deve ser enviado para Tags de Comunicação |
Repeat_E3VAL |
Palavra chave que só pode ser usada dentro de um array JSON, para indicar que os membros que se repetem dentro desse array devem ser lidos de forma independente pelo driver, retornando uma leitura para cada conjunto. Para mais informações, veja a seção Template JSON. |
Opções disponíveis para a palavra-chave TS_TEXT
Opção |
Descrição |
---|---|
%a |
Dia da semana abreviado, em inglês |
%A |
Dia da semana completo, em inglês |
%b |
Nome do mês abreviado, em inglês |
%B |
Nome do mês completo, em inglês |
%C |
Século |
%d |
Dia do mês, começando com 0 (zero) |
%e |
Dia do mês, começando com um espaço |
%f |
Milissegundos, de 0 (zero) a 999 |
%h |
Hora, no formato de 12 horas |
%H |
Hora, no formato de 24 horas |
%m |
Mês |
%M |
Minuto |
%p |
AM ou PM |
%S |
Segundos |
%y |
Ano com dois dígitos |
%Y |
Ano com quatro dígitos |
%Z |
Nome do fuso horário, um código internacional que transforma o horário para GMT |
%+ |
Deslocamento (offset) GMT no formato +-HH:MM |
Exemplos de estampas de tempo formatados pela palavra-chave TS_TEXT:
"2014-07-11T15:26:37Z" -> "TS_TEXT(%y-%m-%dT%H:%M:%SZ)"
"Mon Jul 10 11:04:47 BRT 2017" -> "TS_TEXT(%a %b %d %H:%M:%S %Z %Y)"
"2018-05-02T10:29:28.622-02:00" -> "TS_TEXT(%Y-%m-%dT%H:%M:%S.%f%+)"
Bit |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
Descrição |
Q |
Q |
S |
S |
S |
S |
L |
L |
Opções disponíveis para o padrão OPC DA
Opção |
Descrição |
---|---|
Dois bits de qualidade |
|
SSSS |
Quatro bits de sub-status |
LL |
Dois bits de limite |
0: BAD, 1: UNCERTAIN ou 3: GOOD |
|
SSSS |
0: BAD_NONSPECIFIC, 1: BAD_CONFIGERROR, 2: BAD_NOTCONNECTED, 3: BAD_DEVICEFAILURE ou 4: BAD_SENSORFAILURE |
SSSS |
0: UNCERT_NONSPECIFIC, 1: UNCERT_LASTUSABLEVALUE ou 4: UNCERT_SENSORNOTACCURATE |
SSSS |
0: GOOD_NONSPECIFIC, 1: GOOD_LOCALOVERRIDE ou 6: GOOD_NONSPECIFICLOCALTIMESTAMP |
LL |
0: FREE, 1: LOW, 2: HIGH ou 3: CONST |