IoT Platform:Créer une source de données

Informations contextuelles

Lorsque vous configurez un analyseur de transfert de données, associez-le aux topics sources des données. Vous pouvez ajouter jusqu'à 1 000 topics à une source de données.

Spécifiez la fonction topic(n) dans un script d'analyseur pour récupérer le topic source des données. Pour plus d'informations, consultez la section Fonctions.

Créer une source de données

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, choisissez Message Forwarding > Data Forwarding.

4. Dans l'angle supérieur droit de la page Data Forwarding, cliquez sur Go to New Version pour accéder à la nouvelle version.

   Remarque

   Si vous avez déjà effectué cette étape, la page Data Forwarding de la nouvelle version s'affiche lorsque vous choisissez Message Forwarding > Data Forwarding.

5. Cliquez sur l'onglet Data Source. Sur cet onglet, cliquez sur Create Data Source.

6. Saisissez un nom et une description pour la source de données. Ensuite, cliquez sur OK.

   Le nom doit comporter entre 1 et 30 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-).

   La page Data Source Details s'affiche. Cliquez sur Edit dans l'angle supérieur droit pour modifier le nom et la description de la source de données.

7. Sur la page Data Source Details, cliquez sur Add Topic. Dans la boîte de dialogue qui s'affiche, sélectionnez le topic dont vous souhaitez traiter les messages, puis cliquez sur OK.

   Le tableau suivant décrit les topics pris en charge.

   Important

   Si vous utilisez des produits et des appareils hébergés MQTT open source ainsi que des produits et des appareils de passerelle cloud, vous ne pouvez sélectionner que les topics custom, les topics de Device Status Change Notification et les topics de Device Changes Throughout Lifecycle. Pour plus d'informations sur les topics de transfert de messages et les formats de données, consultez les sections Messaging over open source MQTT, Messaging over JT/T 808 et Messaging over GB/T 32960.

   Tableau 1. Descriptions des topics

   Topic	Description	Références
   Custom	Un topic permettant de transférer des messages dans un format de données personnalisé suit le même format qu'un topic personnalisé : /${productKey}/${deviceName}/user/${TopicShortName}. ${TopicShortName} spécifie une catégorie de topic personnalisée, qui correspond au suffixe du topic personnalisé. La valeur peut contenir des caractères génériques, notamment des signes plus (+) et des dièses (#). Tout l'équipement (+) : indique tous les appareils du produit spécifié. /user/# : Tous les topics personnalisés pour un appareil spécifié.	Utiliser des topics personnalisés pour la communication
   Device Status Change Notification	Le topic utilisé pour transférer les notifications lorsque le statut d'un appareil passe de connecté à déconnecté (et vice versa). Format : /as/mqtt/status/${productKey}/${deviceName}.	Statut de connexion et de déconnexion des appareils
   TSL Data Reporting	Comprend : Un appareil transmet les données de propriété au topic suivant : /${productKey}/${deviceName}/thing/event/property/post. Les données d'événement rapportées par un appareil sont transférées vers le topic /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post. Le topic permettant de transférer les données de propriété par lot provenant des appareils est /${productKey}/${deviceName}/thing/property/batch/post. Le topic permettant de transférer les données d'événement par lot provenant des appareils est /${productKey}/${deviceName}/thing/event/batch/post. Un appareil envoie des messages de réponse aux commandes cloud vers le topic suivant : /${productKey}/${deviceName}/thing/downlink/reply/message.	Soumettre les propriétés des appareils Soumettre les événements des appareils Soumettre plusieurs propriétés d'appareil simultanément Soumettre plusieurs événements d'appareil simultanément Statut des instructions descendantes pour les appareils
   	Les topics suivants sont utilisés pour soumettre des données brutes d'appareil : /sys/${productKey}/${deviceName}/thing/event/property/post : Ce topic est utilisé pour soumettre les propriétés des appareils. /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post et /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:{tsl.event.identifier}/post : Ces topics sont utilisés pour soumettre les événements des appareils. /sys/${productKey}/${deviceName}/thing/event/property/batch/post : Ce topic est utilisé pour soumettre par lot les propriétés et les événements des appareils.	Soumettre les propriétés des appareils Soumettre les événements des appareils Soumettre simultanément plusieurs propriétés et événements d'appareil
   Device Changes Throughout Lifecycle	Le topic utilisé pour transférer les messages lorsqu'un appareil est créé, supprimé, désactivé ou activé. Format : /${productKey}/${deviceName}/thing/lifecycle.	Modifications du cycle de vie des appareils
   Sub-Device Data Report Detected by Gateway	Le topic /${productKey}/${deviceName}/thing/list/found est utilisé par les appareils passerelle pour signaler à IoT Platform les informations relatives aux sous-appareils découverts.	Découverte des sous-appareils par la passerelle
   Device Topological Relation Changes	Le topic utilisé pour transférer les notifications lorsque des relations topologiques entre les sous-appareils et la passerelle sont créées ou supprimées. Ce topic est spécifique aux passerelles. Format : /${productKey}/${deviceName}/thing/topo/lifecycle.	Modifications des relations topologiques des appareils
   	Un appareil utilise le topic /sys/${productKey}/${deviceName}/thing/topo/change pour rapporter des données brutes.	Notifier les passerelles des modifications des relations topologiques
   Device tag change	Le topic permettant de transférer les mises à jour des tags d'appareil est /${productKey}/${deviceName}/thing/deviceinfo/update.	Modifications des tags d'appareil
   	Un appareil utilise le topic suivant pour rapporter des données brutes : /sys/${productKey}/${deviceName}/thing/deviceinfo/update.	Soumettre des tags
   TSL Historical Data Reporting	Comprend : /${productKey}/${deviceName}/thing/event/property/history/post : Ce topic est utilisé pour transférer les propriétés historiques. /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/history/post : Ce topic est utilisé pour transférer les événements historiques.	Soumettre les propriétés historiques Soumettre les événements historiques
   	/sys/${productKey}/${deviceName}/thing/event/property/history/post : Ce topic est utilisé pour soumettre les données TSL historiques.	Comment rapporter les données historiques pour un modèle Thing Specification Language
   Device Status Notification for OTA Updates	Comprend : Le topic permettant de transférer le résultat de la mise à jour OTA depuis un appareil est /${productKey}/${deviceName}/ota/upgrade. Un appareil rapporte la progression de la mise à jour OTA au topic /${productKey}/${deviceName}/ota/progress/post.	Notifications de statut pour les mises à jour OTA Notifications de progression des mises à jour OTA
   	Un appareil rapporte sa progression de mise à niveau au topic suivant : /ota/device/progress/${productKey}/${deviceName}.	Rapporter la progression de la mise à niveau de l'appareil
   Submit a module version number	Le topic permettant de rapporter une version de module Over-the-Air (OTA) mise à jour : /${productKey}/${deviceName}/ota/version/post.	Notification des modifications de version de module OTA
   	Un appareil utilise le topic suivant pour rapporter sa version de module OTA : /ota/device/inform/${productKey}/${deviceName}.	L'appareil rapporte la version du module OTA
   Batch status notification	IoT Platform publie les notifications de changement de statut pour un lot de mises à jour OTA sur le topic suivant : /${productKey}/${packageId}/${jobId}/ota/job/status.	Notifications de statut pour les lots de mises à jour OTA
   Job Event	Comprend les topics suivants : Notifications de statut des tâches d'appareil : /sys/uid/${uid}/job/${jobId}/lifecycle. Notifications de statut des tâches de migration d'instance : /sys/uid/${uid}/distribution/${jobId}/lifecycle. Remarque Le nom du produit à migrer est utilisé comme nom de la tâche de migration d'instance.	Notifications de statut des tâches d'appareil Notifications de statut des tâches de migration d'instance

8. Facultatif. Répétez l'étape précédente pour ajouter plusieurs topics à la source de données.

   Supprimez les topics de la page Twin Node Attribute Change selon vos besoins métier.

9. Facultatif. Répétez les étapes Étape 5 à Étape 8 pour créer plusieurs sources de données.

Étapes suivantes

Créer une destination de données