Documentação do Oracle Cloud Infrastructure

Criando um Adaptador Digital Twin

Crie um adaptador de gêmeo digital para converter cargas úteis de dados brutos provenientes de um dispositivo físico ou de um sistema externo para dados de telemetria normalizados com base no modelo de gêmeo digital.

Os dados são passados para o adaptador de gêmeo digital como um objeto JSON que contém os dados e o mapeamento.

É necessário um adaptador digital twin ao trabalhar com dados estruturados. Há duas maneiras de usar um adaptador digital twin, dependendo se o dispositivo com o qual você está trabalhando pode ser programado para enviar dados:

  • Formato de adaptador padrão: Se o dispositivo puder ser programado para enviar dados no formato com o qual você deseja trabalhar, crie um adaptador de gêmeo digital sem especificar inbound-envelope ou inbound-routes. Como resultado, os dados são enviados no formato padrão do dispositivo. Se o mapeamento de envelope não for especificado e contiver um timeObserved, receivedTime será usado como valor timeObserved. Para obter um exemplo específico, consulte Cenário: Enviando Dados Estruturados em um Formato Padrão usando HTTPs.
  • Formato de adaptador personalizado: Para dispositivos que não podem ser programados para enviar dados, você pode criar um adaptador de gêmeo digital personalizado definindo um inbound-envelope e um envelope-mapping personalizado, transformando o payload e os metadados para obter a saída com a qual deseja trabalhar. Para obter um exemplo específico, consulte Cenário: Enviando Dados Estruturados em um Formato Personalizado usando HTTPs.
Observação

Limite: o número máximo de rotas de entrada é 128.

Exemplo JSON de payload do dispositivo:

{ "time": "<timestamp>", "temp": 65, "hum": 55 }

Use expressões de JQ ou JsonPath para criar um mapeamento JSON de payload do adaptador.

Este exemplo usa JQ: 
{ "temperature": .temp, "humidity": .hum, "timeObserved": .time }
Resultado de saída transformado:
{ "temperature": 65, "humidity": 55, "timeObserved": "<timestamp>" }

Você pode tentar o mapeamento do adaptador no JQ Playground colando o payload como entrada de consulta, adicionando o mapeamento JSON na seção JSON e, em seguida, exibindo o resultado da saída.

  • Os exemplos a seguir usam o parâmetro DTMI URI para associar o adaptador ao modelo de gêmeo digital. Como alternativa, você pode usar o parâmetro --digital-twin-model-id com o <digital-twin-model-OCID> para o modelo de gêmeo digital que deseja associar a um adaptador de gêmeo digital.

    Para criar um adaptador de gêmeo digital para dados estruturados em um formato padrão:

    Use o comando oci iot digital-twin-adapter create e os parâmetros necessários para criar um adaptador de gêmeo digital. Substitua <digital-twin-model-spec-uri> pelo URI DTMI do seu modelo gêmeo digital associado. Para dados estruturados, se o dispositivo puder ser programado, crie um adaptador de gêmeo digital sem especificar o inbound-envelope ou o envelope-mapping para aceitar os dados provenientes do dispositivo na resposta. 
    oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-spec-uri '<digital-twin-model-spec-uri>'

    Para criar um adaptador de gêmeo digital para dados estruturados em um formato personalizado:

    Use o comando oci iot digital-twin-adapter create e os parâmetros necessários para criar um adaptador de gêmeo digital personalizado a fim de definir valores inbound-envelope ou inbound-routes específicos para obter a saída com a qual você deseja trabalhar. Defina seu mapeamento de payload personalizado para seu gêmeo digital usando um arquivo <file://inbound-envelope.json> e um arquivo <file://inbound-routes.json> usando expressões de JQ.

    Substitua <digital-twin-model-spec-uri> pelo URI DTMI do seu modelo gêmeo digital associado e substitua o <iot-domain-OCID> pelo OCID do domínio IoT que você deseja associar a este adaptador de gêmeo digital:

    oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-spec-uri '<digital-twin-model-spec-uri>' --inbound-envelope <file://inbound-envelope.json> --inbound-routes <file://inbound-routes.json>

    Para obter mais informações sobre como referenciar arquivos, consulte Usando um Arquivo JSON para Entrada Complexa.

    Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte Referência de Comando CLI.

  • Execute a operação CreateDigitalTwinAdapter para criar um adaptador de gêmeo digital no domínio IoT especificado.