Schémas de modèles de données

Les intégrations gérées prennent en charge deux types de schéma : la capacité et la définition du type. Si vous créez un modèle de données personnalisé, vous utilisez un document de schéma JSON pour définir l'un ou l'autre type de schéma. Chaque document de schéma est limité à 50 000 caractères.

Schéma de capacité

Une capacité est un élément fondamental qui représente des fonctionnalités spécifiques au sein d'un point de terminaison. Grâce aux fonctionnalités, vous pouvez modéliser les états et les comportements des appareils à l'aide de propriétés, d'actions et d'événements. Les propriétés vous permettent de modéliser les attributs d'état de l'appareil de manière flexible avec n'importe quel type de données déclaratif. Les actions et les événements modélisent le comportement de l'appareil, notamment les commandes qu'il peut exécuter et les signaux qu'il peut signaler.

Ce qui suit montre la structure de haut niveau d'un schéma de capacités.

Capability
  |
  |-- Action
  |-- Event      
  |-- Property

Action

Entité représentant une interaction avec une capacité d'un dispositif. Par exemple, faites sonner la cloche ou regardez qui est à la porte.

Événement

Entité représentant un événement issu d'une capacité d'un appareil. Un appareil peut envoyer un événement pour signaler un incident, une alarme ou une activité provenant d'un capteur, comme un coup à la porte.

Propriété

Entité représentant un attribut particulier dans l'état de l'appareil. Par exemple, une cloche sonne ou la lumière du porche est allumée

Chaque fonctionnalité inclut un identifiant unique avec un espace de noms, des informations de version et une description de son objectif. Le document de schéma utilise le versionnement sémantique pour maintenir la rétrocompatibilité tout en activant de nouvelles fonctionnalités.

Pour de plus amples informations, veuillez consulter Schéma pour les définitions des capacités.

Schéma de définition de type

Une définition de type est un type de données structuré déclaratif qui permet la réutilisabilité et la composabilité. Il définit la manière dont les informations doivent être formatées et limitées. Utilisez des définitions de type pour créer des formats de données standardisés dans votre solution IoT.

Chaque définition de type inclut :

• Un identifiant unique avec espace de noms

• Title

• Description

• Propriétés qui définissent le formatage des données et les contraintes

Les types peuvent être soit de simples primitives, telles que des entiers ou des chaînes avec des limites définies, soit des structures complexes telles que des énumérations ou des objets personnalisés avec plusieurs champs. Les définitions de type utilisent la syntaxe du schéma JSON pour spécifier les contraintes, notamment les valeurs minimales et maximales, les longueurs de chaîne et les modèles autorisés.

Pour de plus amples informations, veuillez consulter Schéma pour les définitions de type.