Conteúdo personalizado

Os conteúdos personalizados permitem que o Publicador MQTT envie dados para sistemas que não usam a estrutura de conteúdo padrão.

Conteúdos padrão e personalizados

O conteúdo padrão usa uma estrutura JSON fixa. Um conteúdo personalizado usa modelos do Formatador de strings para alterar nomes de campos, aninhamento ou saída de texto sem formatação.
Comparação entre conteúdos padrão e personalizados
Aspecto
Conteúdo padrão
Conteúdo personalizado
Caso de uso
Use quando o sistema receptor aceitar a estrutura JSON integrada.
Use quando o sistema receptor exigir nomes de campos diferentes, outro tipo de aninhamento ou texto sem formatação.
Estrutura
A estrutura do conteúdo é fixa. Para ver um exemplo, consulte MQTT.
O cabeçalho, os registros ou ambos usam modelos do Formatador de strings.
Configuração do publicador
Deixe
PF Enabled
 desabilitado.
Habilite
PF Enabled
; em seguida, defina
PF Header
 e, se necessário,
PFRecord
.
Compatibilidade com o assinante
O Assinante MQTT espera o conteúdo JSON padrão. Consulte Assinatura de JSON padrão.
Este tópico descreve apenas a formatação do publicador.
Matrizes e tipos de dados complexos
As matrizes são suportadas apenas no formato de conteúdo padrão. Para obter mais informações, consulte Publicação de tipos de dados complexos.
Use o formato de conteúdo padrão ao publicar matrizes.
IMPORTANTE: O Assinante MQTT espera o conteúdo JSON padrão. Este tópico descreve a formatação personalizada do Publicador MQTT.
Um conteúdo personalizado pode incluir um cabeçalho, registros ou ambos. Por exemplo:
{
  "timestamp": "...",
  "sensors": [
    { "name": "MyVariableA", "value": 23 },
    { "name": "MyVariableB", "value": true },
    { "name": "MyVariableC", "value": "abc" }
  ]
}
Estrutura de conteúdo geral
Legenda apresentando a estrutura de um conteúdo, com cabeçalho e padrão de registro distintos apresentados.
O
FactoryTalk® Optix™
usa vínculos dinâmicos do Formatador de strings com propriedades do formatador de conteúdo do Publicador MQTT:
PF Enabled
,
PF Header
 e
PFRecord
.
DICA: No Formatador de strings, selecione o formato compatível com JSON quando os registros incluírem vários tipos de dados. Para obter mais informações, consulte Tipos de dados do Formatador de strings.

Componentes do formatador de conteúdo

PF Header
:
  • Define a parte do cabeçalho do conteúdo.
  • Usa o Formatador de strings para definir JSON, texto sem formatação ou texto misto com valores dinâmicos.
  • Pode incluir uma ou mais variáveis, como um carimbo de data/hora ou número da linha de produção.
  • Usa o espaço reservado
    #PFRecord
     quando o cabeçalho insere a saída do registro.
  • Usa colchetes ao redor de
    #PFRecord
     quando várias variáveis formam uma matriz JSON.
  • Se houver várias variáveis em uma pasta, o
    FactoryTalk Optix
     fará a iteração pelas variáveis durante a geração do conteúdo.
PFRecord
:
  • Define a parte de registros repetidos do conteúdo.
  • Usa vínculos dinâmicos do Formatador de strings para mapear atributos de itens de alias, como nome de navegação e valor.
  • Pode permanecer em branco quando o conteúdo não usar registros repetidos.
DICA: No Formatador de strings, escape a primeira chave de abertura para evitar um erro de sintaxe. Duplique a chave para escapá-la. Por exemplo:
{{{0}

Exemplos de conteúdo personalizado

Estes exemplos mostram formatos do Formatador de strings e vínculos dinâmicos para
Cabeçalho do PF
 e
Registro do PF
.
  • Formato do Formatador de strings do
    Cabeçalho do PF
    :
    {"timestamp":"{0:o}","sensors":[#PFRecord]}
    Vínculo dinâmico (0):
    MQTT/MQTTClient/MQTTPublisher/PayloadUpadteTimestamp
    . O espaço reservado
    {0:o}
     é mapeado para este vínculo.
    O espaço reservado
    #PFRecord
     insere a saída formatada do
    Registro do PF
     na matriz de sensores.
  • Formato do Formatador de strings de
    Registro do PF
    :
    {"name":"{0}","value":{1}},
    Vínculo dinâmico (0):
    {Item}@BrowseName
    . O espaço reservado
    {0}
     é mapeado para este vínculo.
    Vínculo dinâmico (1):
    {Item}@Value
    . O espaço reservado
    {1}
     é mapeado para este vínculo.
Para ver a estrutura fixa do conteúdo padrão, consulte MQTT. Para matrizes e tipos de dados complexos no formato de conteúdo padrão, consulte Publicação de tipos de dados complexos.
Dê sua opinião
Tem dúvidas ou comentários sobre esta documentação? Por favor, envie seu comentário aqui.
Normal