IoT Platform:Crie uma fonte de dados

Informações de fundo

Ao configurar um analisador de encaminhamento de dados, é necessário associá-lo aos tópicos de origem dos dados. É possível adicionar até 1.000 tópicos a uma única fonte de dados.

Para obter o tópico de onde os dados são encaminhados, especifique a função topic(n) no script do analisador. Para mais informações, consulte Funções.

Crie uma fonte de dados

1. Faça login no console do IoT Platform.

2. Na página Overview, localize a instância que deseja gerenciar e clique em ID ou no nome da instância.

3. No painel de navegação à esquerda, escolha Message Forwarding > Data Forwarding.

4. No canto superior direito da página Data Forwarding, clique em Go to New Version para acessar a nova versão.

   Nota

   Caso já tenha executado esta etapa, a página Data Forwarding da nova versão será exibida automaticamente ao navegar por Message Forwarding > Data Forwarding.

5. Clique na aba Data Source. Em seguida, clique em Create Data Source.

6. Insira um nome e uma descrição para a fonte de dados. Depois, clique em OK.

   O nome deve ter entre 1 e 30 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-).

   A página Data Source Details será exibida. No canto superior direito, clique em Edit para modifique o nome e a descrição da fonte de dados.

7. Na página Data Source Details, clique em Add Topic. Na caixa de diálogo exibida, selecione o tópico cujas mensagens você deseja processar e clique em OK.

   A tabela a seguir descreve os tópicos suportados.

   Importante

   Se você utilizar produtos e dispositivos de gateway de nuvem, poderá selecionar apenas tópicos custom, tópicos de Device Status Change Notification e tópicos de Device Changes Throughout Lifecycle. Para mais detalhes sobre tópicos de encaminhamento de mensagens e formatos de dados, consulte Mensagens via MQTT de código aberto, Mensagens via JT/T 808 e Mensagens via GB/T 32960.

   Tabela 1. Descrições dos tópicos

   Tópico	Descrição	Referências
   Custom	Tópico para encaminhamento de mensagens em formato de dados personalizado, seguindo o mesmo padrão de um tópico customizado: /${productKey}/${deviceName}/user/${TopicShortName}. ${TopicShortName} define uma categoria de tópico personalizado, correspondendo ao sufixo do tópico. O valor pode incluir caracteres curinga, como sinais de adição (+) e cerquilhas (#). Todos os equipamentos (+): representa todos os dispositivos do produto especificado. /user/#: Abrange todos os tópicos personalizados de um dispositivo específico.	Usar tópicos personalizados para comunicação
   Device Status Change Notification	Tópico utilizado para encaminhar notificações quando o status de um dispositivo alterna entre online e offline. Formato: /as/mqtt/status/${productKey}/${deviceName}.	Status online e offline do dispositivo
   TSL Data Reporting	Inclui: Relatório de dados de propriedades do dispositivo para o tópico: /${productKey}/${deviceName}/thing/event/property/post. Encaminhamento de dados de eventos reportados pelo dispositivo para o tópico /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Tópico destinado ao encaminhamento em lote de dados de propriedades dos dispositivos: /${productKey}/${deviceName}/thing/property/batch/post. Tópico destinado ao encaminhamento em lote de dados de eventos dos dispositivos: /${productKey}/${deviceName}/thing/event/batch/post. Envio de mensagens de resposta do dispositivo para comandos da nuvem no tópico: /${productKey}/${deviceName}/thing/downlink/reply/message.	Enviar propriedades do dispositivo Enviar eventos do dispositivo Enviar múltiplas propriedades do dispositivo simultaneamente Enviar múltiplos eventos do dispositivo simultaneamente Status de instrução downlink do dispositivo
   	Os tópicos abaixo servem para enviar dados brutos do dispositivo: /sys/${productKey}/${deviceName}/thing/event/property/post: Utilizado para enviar propriedades do dispositivo. /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post e /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:{tsl.event.identifier}/post: Destinados ao envio de eventos do dispositivo. /sys/${productKey}/${deviceName}/thing/event/property/batch/post: Usado para envio em lote de propriedades e eventos do dispositivo.	Enviar propriedades do dispositivo Enviar eventos do dispositivo Enviar múltiplas propriedades e eventos do dispositivo simultaneamente
   Device Changes Throughout Lifecycle	Tópico usado para encaminhar mensagens quando um dispositivo é criado, excluído, desativado ou ativado. Formato: /${productKey}/${deviceName}/thing/lifecycle.	Alterações no ciclo de vida do dispositivo
   Sub-Device Data Report Detected by Gateway	O tópico /${productKey}/${deviceName}/thing/list/found permite que dispositivos gateway relatem informações sobre subdispositivos descobertos ao IoT Platform.	Descoberta de subdispositivos pelo gateway
   Device Topological Relation Changes	Tópico exclusivo para gateways, utilizado para encaminhar notificações quando relações topológicas entre subdispositivos e o gateway são criadas ou excluídas. Formato: /${productKey}/${deviceName}/thing/topo/lifecycle.	Alterações nas relações topológicas do dispositivo
   	Relatório de dados brutos pelo dispositivo através do tópico /sys/${productKey}/${deviceName}/thing/topo/change.	Notificar gateways sobre alterações nas relações topológicas
   Device tag change	Tópico responsável pelo encaminhamento de atualizações de tags do dispositivo: /${productKey}/${deviceName}/thing/deviceinfo/update.	Alterações nas tags do dispositivo
   	Envio de dados brutos pelo dispositivo utilizando o seguinte tópico: /sys/${productKey}/${deviceName}/thing/deviceinfo/update.	Enviar tags
   TSL Historical Data Reporting	Composto por: /${productKey}/${deviceName}/thing/event/property/history/post: Encaminha propriedades históricas. /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/history/post: Encaminha eventos históricos.	Enviar propriedades históricas Enviar eventos históricos
   	/sys/${productKey}/${deviceName}/thing/event/property/history/post: Tópico para envio de dados históricos do modelo TSL.	Como relatar dados históricos para um modelo Thing Specification Language
   Device Status Notification for OTA Updates	Abrange: Encaminhamento do resultado da atualização OTA do dispositivo via tópico /${productKey}/${deviceName}/ota/upgrade. Relatório de progresso da atualização OTA pelo dispositivo no tópico /${productKey}/${deviceName}/ota/progress/post.	Notificações de status para atualizações OTA Notificações de progresso de atualizações OTA
   	O dispositivo informa seu progresso de atualização no seguinte tópico: /ota/device/progress/${productKey}/${deviceName}.	Relatar progresso de atualização do dispositivo
   Submit a module version number	Tópico para relatar uma versão atualizada do módulo Over-the-Air (OTA): /${productKey}/${deviceName}/ota/version/post.	Aviso de alterações na versão do módulo OTA
   	Relato da versão do módulo OTA pelo dispositivo através do tópico: /ota/device/inform/${productKey}/${deviceName}.	Dispositivo relata a versão do módulo OTA
   Batch status notification	Publicação de notificações de alteração de status para um lote de atualizações OTA pelo IoT Platform no tópico: /${productKey}/${packageId}/${jobId}/ota/job/status.	Notificações de status para lotes de atualização OTA
   Job Event	Engloba os seguintes tópicos: Notificações de status de tarefas do dispositivo: /sys/uid/${uid}/job/${jobId}/lifecycle. Notificações de status de tarefas de migração de instância: /sys/uid/${uid}/distribution/${jobId}/lifecycle. Nota O nome da tarefa de migração de instância corresponde ao nome do produto a ser migrado.	Notificações de status de tarefas do dispositivo Notificações de status de tarefas de migração de instância

8. Opcional. Repita a etapa anterior para adicionar vários tópicos à fonte de dados.

   Conforme a necessidade do seu negócio, exclua tópicos diretamente na página Twin Node Attribute Change.

9. Opcional. Repita da Etapa 5 à Etapa 8 para crie múltiplas fontes de dados.

Próximos passos

Crie um destino de dados