Sintaxe dos Templates

<< 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%+)"

 

Padrão OPC DA

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

QQ

Dois bits de qualidade

SSSS

Quatro bits de sub-status

LL

Dois bits de limite

QQ

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

Esta página foi útil?