Modifier un modèle d’appareil

Un modèle d’appareil inclut un modèle qui décrit comment un appareil interagit avec IoT Central. Ce modèle définit les fonctionnalités de l’appareil et comment IoT Central interagit avec eux. Les appareils peuvent envoyer des données de télémétrie et des valeurs de propriété à IoT Central, IoT Central peut envoyer des mises à jour et des commandes de propriété à un appareil. IoT Central utilise également le modèle pour définir des interactions avec des fonctionnalités IoT Central telles que des travaux, des règles et des exportations.

Les modifications apportées au modèle dans un modèle d’appareil peuvent affecter l’ensemble de votre application, y compris les appareils connectés. Les modifications apportées à une fonctionnalité utilisée par les règles, les exportations, les groupes d’appareils ou les travaux peuvent entraîner un comportement inattendu ou ne fonctionnent pas du tout. Par exemple, si vous supprimez une définition de télémétrie d’un modèle :

• IoT Central n’est plus en mesure d’interpréter cette valeur. IoT Central affiche les données d’appareil qu’il ne peut pas interpréter comme des données non modélisées sur la page données brutes de l’appareil.
• IoT Central n’inclut plus la valeur dans les exportations de données.

Pour vous aider à éviter les conséquences inattendues de la modification d’un modèle d’appareil, cet article inclut des recommandations basées sur votre phase de cycle de vie de développement actuelle. En général, le plus tôt vous êtes dans le cycle de vie du développement, plus vous pouvez être tolérant aux modifications de modèle d’appareil.

Pour en savoir plus sur les modèles d’appareil et comment en créer un, consultez Qu’est-ce que les modèles d’appareil ? et créer un modèle d’appareil dans votre application Azure IoT Central.

Pour savoir comment gérer des modèles d’appareil à l’aide de l’API REST IoT Central, consultez Comment utiliser l’API REST IoT Central pour gérer les modèles d’appareil.

Modifier un modèle d’appareil

Les modifications additionnelles, telles que l’ajout d’une fonctionnalité ou d’une interface à un modèle, ne sont pas des modifications non-rupture. Vous pouvez apporter des modifications additives à un modèle à n’importe quel stade du cycle de vie du développement.

Les modifications de rupture incluent la suppression de parties d’un modèle ou la modification d’un nom de fonctionnalité ou d’un type de schéma. Ces modifications peuvent entraîner l’affichage des messages d’erreur et l’arrêt du fonctionnement des fonctionnalités d’application telles que les règles, les exportations ou les tableaux de bord.

Dans les premières phases de développement d’appareils, alors que vous concevez et testez le modèle, il existe une plus grande tolérance pour apporter des modifications directement à votre modèle d’appareil. Avant de connecter des appareils de production à un modèle d’appareil, vous pouvez modifier le modèle d’appareil directement. IoT Central applique automatiquement ces modifications aux appareils lorsque vous publiez le modèle d’appareil.

Après avoir attaché des appareils de production à un modèle d’appareil, évaluez l’impact des modifications avant de modifier un modèle d’appareil. Vous ne devez pas apporter de modifications cassants à un modèle d’appareil en production. Pour apporter ces modifications, créez une nouvelle version du modèle d’appareil. Testez le nouveau modèle d’appareil, puis migrez vos appareils de production vers le nouveau modèle lors d’un temps d’arrêt planifié.

Mettre à jour un modèle d’appareil IoT Edge

Pour un appareil IoT Edge, le modèle regroupe les fonctionnalités par modules qui correspondent aux modules IoT Edge s’exécutant sur l’appareil. Le manifeste de déploiement est un document JSON distinct qui indique à un appareil IoT Edge quels modules installer, comment les configurer et quelles propriétés le module possède. Si vous modifiez un manifeste de déploiement, vous pouvez mettre à jour le modèle d’appareil pour inclure les modules et les propriétés définis dans le manifeste :

1. Accédez au nœud Modules dans le modèle d’appareil.
2. Dans la page récapitulative modules , sélectionnez Importer des modules à partir du manifeste.
3. Sélectionnez le manifeste de déploiement approprié, puis sélectionnez Importer.

Pour en savoir plus, consultez les appareils IoT Edge et IoT Central.

Modifier et publier des actions

Les actions suivantes sont utiles lorsque vous modifiez un modèle d’appareil :

• Enregistrer. Lorsque vous modifiez une partie de votre modèle d’appareil, l’enregistrement des modifications crée un brouillon auquel vous pouvez revenir. Ces modifications n’affectent pas encore les appareils connectés. Les appareils créés à partir de ce modèle n’ont pas les modifications enregistrées tant que vous ne le publiez pas.
• Publier. Lorsque vous publiez le modèle d’appareil, il applique toutes les modifications enregistrées aux instances d’appareil existantes. Les instances d’appareil nouvellement créées utilisent toujours le dernier modèle publié.
• Versionnage d’un modèle. Lorsque vous versionz un modèle d’appareil, il crée un modèle avec toutes les dernières modifications enregistrées. Les modifications apportées à une nouvelle version n’affectent pas les instances d’appareil existantes. Pour plus d’informations, consultez Versionner un modèle d’appareil.
• Version d’une interface. Lorsque vous versionz une interface, elle crée une interface avec toutes les fonctionnalités enregistrées les plus récentes. Vous pouvez réutiliser une interface dans plusieurs emplacements au sein d’un modèle. Cette réutilisation est pourquoi une modification apportée à une référence à une interface modifie tous les emplacements du modèle qui utilisent l’interface. Lorsque vous versionz une interface, ce comportement change, car la nouvelle version est désormais une interface distincte. Pour en savoir plus, consultez Version d’une interface.
• Migrez un appareil. Lorsque vous migrez un appareil, l’instance de l’appareil passe d’un modèle d’appareil à un autre. La migration de l’appareil peut entraîner un court moment où IoT Central traite les modifications. Pour plus d’informations, consultez Migrer un appareil entre les versions.

Numéros de version

Les modèles d’appareil et les interfaces ont des numéros de version. Différents numéros de version permettent aux modèles ou interfaces de partager une @id valeur, tout en fournissant un historique des mises à jour. Les numéros de version s’incrémentent uniquement si vous choisissez de versionr le modèle ou l’interface, ou si vous modifiez délibérément le numéro de version. Vous devez modifier un numéro de version lorsque vous apportez une modification majeure à un modèle ou une interface.

L’extrait de code suivant montre le modèle d’appareil pour un appareil thermostat. Le modèle d’appareil a une interface unique. Vous pouvez voir le numéro de version, 1à la fin du@id champ.

{
  "@context": "dtmi:dtdl:context;2",
  "@id": "dtmi:com:example:Thermostat;1",
  "@type": "Interface",
  "displayName": "Thermostat",
  "description": "Reports current temperature and provides desired temperature control.",
  "contents": [
    // ...
  ]
}

Pour afficher ces informations dans l’interface utilisateur IoT Central, sélectionnez Modifier l’identité dans l’éditeur de modèle d’appareil :

Version d’un modèle d’appareil

Pour versionr un modèle d’appareil :

1. Accédez à la page Modèles d’appareil .
2. Sélectionnez le modèle d’appareil que vous souhaitez version.
3. Sélectionnez Version en haut de la page et donnez au modèle un nouveau nom. IoT Central suggère un nouveau nom, que vous pouvez modifier.
4. Cliquez sur Créer.

Vous avez maintenant créé un modèle avec une identité unique qui n’est attachée à aucun appareil existant.

Contrôler la version d’une interface

Pour versionr une interface :

1. Accédez à la page Modèles d’appareil .
2. Sélectionnez le modèle d’appareil que vous avez en mode brouillon.
3. Sélectionnez l’interface publiée que vous souhaitez versionner et modifier.
4. Sélectionnez Version en haut de la page d’interface.
5. Cliquez sur Créer.

Vous avez maintenant créé une nouvelle interface avec une identité unique qui n’est pas synchronisée avec la version précédente de l’interface.

Migrer un appareil entre les versions

Vous pouvez créer plusieurs versions du modèle d’appareil. Au fil du temps, vous disposez de plusieurs appareils connectés à l’aide de ces modèles d’appareil. Vous pouvez migrer des appareils d’une version de votre modèle d’appareil vers un autre. Les étapes suivantes décrivent comment migrer un appareil :

1. Accédez à la page Appareils .

2. Sélectionnez l’appareil que vous devez migrer vers une autre version.

3. Choisissez Migrer :

   

4. Sélectionnez le modèle d’appareil avec la version vers laquelle vous souhaitez migrer l’appareil, puis sélectionnez Migrer.