<< Clique para Mostrar o Sumário >>   Sintaxe de um Modelo JSON

Para extrair ou montar o conteúdo de uma mensagem é necessário declarar um modelo, ou template, que permite informar o formato desta mensagem e quais partes devem ser transformadas em dados. Cada template deve utilizar palavras-chave 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

 

Opções disponíveis para a palavra-chave TS_TEXT

 

O código a seguir contém 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

 

Opções disponíveis para o padrão OPC DA

 

Exemplos de Configuração de Modelos no Formato JSON

Um arquivo no formato JSON contendo um array com múltiplos conjuntos de dados deve incluir a palavra-chave Repeat_E3VAL no template imediatamente após o colchete que inicia este array, conforme o exemplo a seguir.

{
  "MessageType":"DUMMY",
  "TagData": [
    Repeat_E3VAL {
      "Temperature": "E3VAL",
      "Humidity": "E3VAL"
    }
  ],
  "MessageDesc": "DUMMY"
}

 

Neste caso, ao receber uma mensagem com 2 (dois) conjuntos de dados, por exemplo, o evento OnRead de um Tag Bloco é disparado para cada conjunto, como mostrado no código a seguir.

Sub [Sensor-001_OnRead]()
  Application.Trace Item("Temperature").Value
  Application.Trace Item("Humidity").Value
End Sub

 

Se outros valores do tipo E3VAL são declarados antes ou depois de um valor do tipo Repeat_E3VAL, estes são replicados para cada conjunto, com o valor do tipo Repeat_E3VAL sempre como o último valor no Tag Bloco de recebimento, como no exemplo a seguir.

{
  "MessageType": "E3VAL",
  "TagData": [
    Repeat_E3VAL {
      "Temperature": "E3VAL",
      "Humidity": "E3VAL"
    }
  ],
  "MessageDesc": "E3VAL"
}

 

Um Tag Bloco com os Elementos de Bloco Tipo, Descrição, Temperatura e Umidade pode gerar, a cada evento OnRead, valores como no código a seguir.

"Teste";"Descrição";11;12 => Primeiro evento OnRead
"Teste";"Descrição";14;66 => Segundo evento OnRead
"Teste";"Descrição";70;55 => Terceiro evento OnRead

 

Caso sem Repetição de Leitura por Conjunto

Se não há necessidade de disparar um evento OnRead para cada conjunto, um template pode ser declarado sem um valor do tipo Repeat_E3VAL, usando apenas uma palavra-chave do tipo E3VAL para capturar o array, conforme o exemplo a seguir.

{
  "MessageType": "DUMMY",
  "TagData": "E3VAL",
  "MessageDesc":"DUMMY"
}

 

Nesse caso, o array recebido é expandido com base na quantidade de elementos, resultando em uma única leitura no evento OnRead, no formato do exemplo a seguir.

array(11, 12); array(14, 66); array(70, 55) => Evento OnRead único

 

Se um template contém mais de uma palavra-chave do tipo E3VAL, ou seja, não DUMMY, este array não é expandido, conforme o exemplo a seguir.

{
  "MessageType": "E3VAL",
  "TagData": "E3VAL",
  "MessageDesc": "E3VAL"
}

 

Esta leitura é realizada em um único evento OnRead, no formato do exemplo a seguir.

"Teste"; array(array(11, 12), array(14, 66), array(70, 55)); "Descrição"=> Evento OnRead único

 

 

Campos do Tipo Lista

Um campo do corpo de uma requisição pode ser declarado como uma lista, utilizando a palavra-chave E3VAL dentro de um array, conforme o exemplo a seguir.

{
  "canais": ["E3VAL"],
  "id": "E3VAL"
}

 

Este modelo tem dois Elementos de Bloco, o primeiro corresponde ao campo canais e o segundo ao campo id. Um campo declarado como lista consome um único Elemento de Bloco, e o valor escrito neste Elemento define o conteúdo desta lista, conforme a tabela a seguir.

Exemplos de preenchimento de um campo do tipo Lista

 

 

Conversão de Valores Recebidos como Texto

Quando o valor extraído por uma palavra-chave E3VAL chega como texto, ou seja, entre aspas no formato JSON, este Driver converte este valor para um número somente se o texto inteiro é um número, ou seja, apenas dígitos, opcionalmente um sinal negativo no início e no máximo um separador decimal, que pode ser ponto ou vírgula. Qualquer outro texto, mesmo formado só por dígitos, pontos ou hifens, como por exemplo um endereço IP ou uma data, é entregue a um Tag exatamente como foi recebido. Esta regra também vale para os valores dentro de arrays e objetos, e também para os Tags de Caminho JSON.

Exemplos de conversão de valores recebidos como texto