Démarrage rapide - Bien démarrer avec un exemple de scénario dans Azure Digital Twins Explorer

Ce guide de démarrage rapide est une introduction à Azure Digital Twins, montrant comment Azure Digital Twins représente les données et montre un exemple d’interaction avec un graphique de jumeau numérique d’un bâtiment physique. Vous utilisez le site du portail Azure et Azure Digital Twins Explorer, qui est un outil permettant de visualiser et d’interagir avec les données Azure Digital Twins dans un navigateur web.

Dans ce guide de démarrage rapide, vous allez examiner les exemples de modèles prédéfinis qui définissent numériquement les concepts d’un bâtiment, d’un étage et d’une salle, et vous utilisez ces définitions de modèles pour créer des jumeaux numériques qui représentent des étages et des salles spécifiques d’un bâtiment physique. Ces jumeaux individuels sont connectés à un graphe de jumeau virtuel qui reflète leurs relations entre eux, formant une réplique numérique complète du bâtiment d'échantillon. Le graphique avec lequel vous travaillez représente un bâtiment qui contient deux étages, et chaque étage contient des chambres. Le graphique ressemble à cette image :

Voici les étapes que vous utilisez pour explorer le graphique dans cet article :

1. Créer une instance Azure Digital Twins et l’ouvrir dans Azure Digital Twins Explorer.
2. Chargez des modèles prédéfinis et des données de graphe pour construire l’exemple de scénario. Ajoutez manuellement un jumeau supplémentaire.
3. Simulez la modification des données IoT et interrogez le graphique pour afficher les résultats.
4. Revoir ce que vous avez appris de l’expérience.

Remarque

Par souci de simplicité, ce guide de démarrage rapide ne couvre pas la configuration d’un flux de données dynamique à partir d’appareils IoT à l’intérieur de l’environnement modélisé ou d’autres sources de données. Pour configurer un flux de données simulé de bout en bout qui alimente votre graphique de jumeau, passez aux tutoriels : Connecter une solution de bout en bout. Pour plus d’informations sur le flux de données entre les services et l’intégration d’Azure Digital Twins dans une solution IoT plus large, consultez Entrée et sortie de données.

Prérequis

Vous avez besoin d’un abonnement Azure pour suivre ce guide de démarrage rapide. Si vous n’en avez pas, créez-en un gratuitement dès maintenant.

Vous devez également télécharger les supports pour l’exemple de graphique utilisé dans le démarrage rapide. Utilisez les instructions suivantes pour télécharger les fichiers requis. Plus tard, vous suivez d’autres instructions pour les charger dans Azure Digital Twins.

• Fichiers de modèle : accédez à chaque lien suivant, cliquez avec le bouton droit n’importe où sur l’écran, puis sélectionnez Enregistrer comme dans le menu contextuel de votre navigateur. Utilisez la fenêtre Enregistrer sous pour enregistrer le fichier quelque part sur votre machine.

  • Building.json: ce fichier de modèle définit numériquement un bâtiment. Il spécifie que les bâtiments peuvent contenir des étages.
  • Floor.json: ce fichier de modèle définit numériquement un plancher. Il spécifie que les étages peuvent contenir des salles.
  • Room.json: ce fichier de modèle définit numériquement une salle. Il a une propriété de température.

• buildingScenario.xlsx : cette feuille de calcul contient les données d’un exemple de graphique de jumeaux, comprenant cinq jumeaux numériques représentant un bâtiment spécifique avec étages et salles. Les jumeaux sont basés sur les modèles génériques et connectés à des relations indiquant quels éléments contiennent les autres. Selon les paramètres de votre navigateur, la sélection de ce lien peut télécharger automatiquement le fichier buildingScenario.xlsx à votre emplacement de téléchargement par défaut, ou ouvrir le fichier dans votre navigateur avec une option de téléchargement. Voici à quoi ressemble l’option de téléchargement dans Microsoft Edge :

  

Conseil

Ces fichiers proviennent du dépôt Azure Digital Twins Explorer dans GitHub. Vous pouvez consulter le dépôt pour obtenir d’autres exemples de fichiers, le code de l’explorateur, et bien plus encore.

Configurer Azure Digital Twins

La première étape de l’utilisation d’Azure Digital Twins consiste à créer une instance Azure Digital Twins qui contient toutes vos données de graphe. Dans cette section, vous allez créer une instance du service et l’ouvrir dans Azure Digital Twins Explorer.

Créer une instance Azure Digital Twins

Dans cette section, vous allez créer une nouvelle instance d’Azure Digital Twins à l’aide du portail Azure. Accédez au portail et connectez-vous à l’aide de vos informations d’identification.

1. Une fois dans le portail, commencez par sélectionner Créer une ressource dans le menu de la page d’accueil des services Azure.

   

2. Recherchez Azure Digital Twins dans la zone de recherche, puis choisissez le service Azure Digital Twins dans les résultats.

   Laissez le champ Plan défini sur Azure Digital Twins et sélectionnez le bouton Créer pour une nouvelle instance du service.

   

3. Renseignez les champs sous l’onglet Informations de base de la configuration, y compris votre abonnement, votre groupe de ressources, un nom de ressource pour votre nouvelle instance et votre nouvelle région. Cochez la case Attribuer le rôle Propriétaire des données Azure Digital Twins pour vous accorder les autorisations nécessaires afin de gérer les données dans l’instance.

   

   Remarque

   Si la zone Attribuer le rôle Propriétaire des données Azure Digital Twins est grisée, cela signifie que vous n’avez pas d’autorisations dans votre abonnement Azure pour gérer l’accès utilisateur aux ressources. Vous pouvez poursuivre la création de l’instance dans cette section. Une personne disposant des autorisations nécessaires doit ensuite vous attribuer ce rôle sur l’instance pour que vous puissiez terminer ce démarrage rapide.

   Les rôles communs qui répondent à cette exigence sont Propriétaire, Administrateur de compte ou la combinaison des rôles Administrateur de l’accès utilisateur et Contributeur.

4. Sélectionnez Vérifier + créer pour terminer la création de votre instance.

5. Vous voyez une page récapitulative montrant les détails que vous avez entrés. Confirmez et créez l’instance en sélectionnant Créer.

Cette action vous permet d’accéder à une page Vue d’ensemble qui suit l’état du déploiement de l’instance.

Attendez que la page indique que votre déploiement est terminé.

Ouvrir une instance dans Azure Digital Twins Explorer

Une fois le déploiement terminé, utilisez le bouton Accéder à la ressource pour passer à la page de présentation de l’instance dans le portail.

Ensuite, sélectionnez le bouton Ouvrir Azure Digital Twins Explorer (préversion).

Cette action ouvre Azure Digital Twins Explorer dans un nouvel onglet. Si c’est la première fois que vous utilisez l’Explorateur, vous voyez un résumé modal de bienvenue de ses principales fonctionnalités.

Azure Digital Twins Explorer peut se connecter automatiquement à votre instance. Si ce n’est pas le cas, vous voyez l’écran suivant vous demandant de spécifier une URL Azure Digital Twins. (Si vous ne voyez pas cette zone sur votre écran, Azure Digital Twins Explorer a effectué cette étape automatiquement.)

Si vous voyez cette zone, entrez https:// dans le champ, puis le nom d’hôte de votre instance (cette valeur est disponible dans la page Vue d’ensemble de l’instance dans le portail). Ces valeurs composent ensemble l’URL de l’instance. Sélectionnez Enregistrer pour vous connecter à votre instance.

Important

Azure Digital Twins Explorer ne prend pas en charge les points de terminaison privés. Si vous souhaitez utiliser Azure Digital Twins Explorer avec une instance Azure Digital Twins qui utilise Private Link pour désactiver l’accès public, vous pouvez déployer le codebase Azure Digital Twins Explorer en privé dans le cloud. Pour obtenir des instructions sur la procédure à suivre, consultez Azure Digital Twins Explorer : exécution dans le cloud.

Générer l’exemple de scénario

Ensuite, vous utilisez Azure Digital Twins Explorer pour configurer les modèles d'exemple et le graphe des jumeaux. Vous commencez par importer les fichiers de modèle et le fichier de graphique de jumeaux que vous avez téléchargés sur votre machine dans la section Prérequis . Ensuite, vous terminez le scénario en créant un jumeau manuellement.

Modèles

Dans un graphique Azure Digital Twins, la première étape à faire est de définir le vocabulaire de votre environnement. Les modèles sont des définitions génériques pour chaque type d’entité qui existe dans votre environnement. Cet exemple de scénario de construction contient un bâtiment, des étages et des chambres. Par conséquent, vous avez besoin d’une définition de modèle décrivant ce qu’est un bâtiment , une définition de modèle décrivant ce qu’est un étage et une définition de modèle décrivant ce qu’est une salle . Plus tard, vous pouvez créer des jumeaux numériques qui sont des instances de ces modèles, représentant des bâtiments, des étages et des salles spécifiques.

Les modèles pour Azure Digital Twins sont écrits en langage DTDL (Digital Twin Definition Language), un langage d’objet de données similaire à JSON-LD. Chaque modèle décrit un type d’entité unique en termes de propriétés, de relations et de composants.

Pour ce guide de démarrage rapide, les fichiers de modèle sont écrits pour vous. Vous avez téléchargé Building.json, Floor.jsonet Room.json dans la section Conditions préalables , et maintenant vous les chargez dans votre instance Azure Digital Twins à l’aide d’Azure Digital Twins Explorer.

Charger les modèles (fichiers .json)

Dans Azure Digital Twins Explorer, procédez comme suit pour charger les modèles Building, Floor et Room (fichiers .json que vous avez téléchargés précédemment).

1. Dans le panneau Modèles, sélectionnez l’icône Charger un modèle symbolisée par une flèche pointant vers le haut.

   

2. Dans la fenêtre Ouvrir qui s’affiche, accédez au dossier contenant les fichiers .json téléchargés sur votre ordinateur.

3. Sélectionnez Building.json, Floor.json et Room.json, puis sélectionnez Ouvrir pour tous les charger à la fois.

Azure Digital Twins Explorer charge ces fichiers de modèle dans votre instance Azure Digital Twins. Ils doivent apparaître dans le panneau Modèles, sous leur nom convivial et leur ID de modèle complet.

Vous pouvez sélectionner Afficher le modèle dans les options de tout modèle pour afficher le code DTDL qui définit chaque type de modèle.

Jumeaux et graphe de jumeaux

Maintenant que certaines définitions de modèle sont chargées sur votre instance Azure Digital Twins, vous pouvez utiliser ces définitions pour créer des jumeaux numériques pour les éléments de votre environnement.

Chaque jumeau numérique de votre solution représente une entité de l’environnement physique. Vous pouvez créer de nombreux jumeaux basés sur le même type de modèle, comme plusieurs jumeaux de salle qui utilisent tous le modèle Room. Dans ce guide de démarrage rapide, vous avez besoin d’un jumeau numérique pour le bâtiment et d’un jumeau numérique pour chaque étage et pièce du bâtiment. Les jumeaux sont connectés par des relations dans un graphe de jumeaux qui représente l'environnement complet du bâtiment.

Dans cette section, vous chargez un graphique préexistant contenant un jumeau de bâtiment, deux jumeaux d’étage et deux jumeaux de pièce.

Importer le graphe (fichier .xlsx)

Dans Azure Digital Twins Explorer, procédez comme suit pour importer l’exemple de graphique (le fichier .xlsx que vous avez téléchargé précédemment).

1. Dans le volet Graphe de jumeaux, sélectionnez l’icône Importer le graphe repérable par une flèche pointant vers un nuage.

   

2. Dans la fenêtre ouverte, accédez au fichier buildingScenario.xlsx que vous avez téléchargé précédemment. Ce fichier contient des données de jumeau et de relation pour l’exemple de graphique. Sélectionnez Ouvrir.

   Après quelques secondes, Azure Digital Twins Explorer ouvre la vue Importer dans laquelle vous pouvez voir un aperçu du graphe à charger.

3. Pour terminer l’importation du graphe, sélectionnez l’icône Enregistrer en haut à droite du panneau d’aperçu du graphe.

   

4. Azure Digital Twins Explorer utilise le fichier chargé pour créer les jumeaux et les relations demandés entre eux. Vérifiez que la boîte de dialogue suivante s’affiche pour indiquer que l’importation a réussi avant de continuer.

   

   Sélectionnez Fermer.

   Le graphique est maintenant chargé dans Azure Digital Twins Explorer et le panneau Twin Graph recharge. Elle s’affiche vide.

5. Pour voir le graphe, sélectionnez le bouton Exécuter la requête du panneau Explorateur de requêtes, dans la partie supérieure de la fenêtre Azure Digital Twins Explorer.

   

Cette action exécute la requête par défaut pour sélectionner et afficher tous les jumeaux numériques. Azure Digital Twins Explorer récupère du service la totalité des jumeaux et des relations. Il dessine le graphe correspondant dans le panneau Graphe de jumeaux. Vous pouvez maintenant voir le graphe chargé de l’exemple de scénario.

Les cercles (« nœuds » de graphe) représentent des jumeaux numériques. Les lignes représentent des relations. Le jumeau BuildingA « contient » les jumeaux Floor0 et Floor1, le jumeau Floor0 « contient » Room0, et le jumeau Floor1 « contient » Room1. Si vous utilisez une souris, vous pouvez cliquer et faire glisser dans le graphe pour déplacer des éléments.

Ajouter un autre jumeau

Vous pouvez continuer à modifier la structure d’un graphe de jumeau numérique après sa création. Imaginez qu’une autre pièce a été récemment construite sur Floor1 de cet exemple de bâtiment. Dans cette section, vous ajoutez un nouveau jumeau au graphe pour représenter la nouvelle salle.

Commencez par sélectionner le modèle qui définit le type de jumeau que vous souhaitez créer. Dans le panneau Modèles sur la gauche, ouvrez le menu Options du modèle Room. Sélectionnez Créer un jumeau pour créer une instance de ce type de modèle.

Entrez Room2 pour Nom du nouveau jumeau, puis sélectionnez Enregistrer. Cette action crée un jumeau numérique, qui n’est pas encore connecté par des relations au reste du graphique.

Ensuite, vous ajoutez une relation pour montrer que Floor1 contient Room2. Utilisez les touches CTRL/CMD ou MAJ pour sélectionner simultanément Floor1 et Room2 dans le graphique. Lorsque les deux jumeaux sont sélectionnés, cliquez avec le bouton droit sur Room2 et choisissez Ajouter des relations.

Cette action ouvre une boîte de dialogue Créer une relation préremplie avec les détails d’une relation « contient » de Étage1 et Salle2. Sélectionnez Enregistrer.

Maintenant, Room2 est connecté dans le graphique. Si vous utilisez une souris, vous pouvez cliquer et faire glisser des jumeaux dans le graphique pour les organiser dans la configuration de votre choix.

Afficher les propriétés des jumeaux

Vous pouvez sélectionner un jumeau pour voir la liste de ses propriétés et leurs valeurs dans le panneau Propriétés du jumeau.

Voici les propriétés de Room0. Notez que Room0 a une température de 70.

Voici les propriétés de Room1. Notez que Room1 a une température de 80.

Room2 n’a pas encore de valeurs définies pour ses propriétés, car ce jumeau a été créé manuellement. Pour définir ses valeurs de propriété, modifiez les champs de façon à ce que l’humidité soit 50, et la température est de 72. Sélectionnez l’icône Enregistrer.

Requête modifiant les données IoT

Dans Azure Digital Twins, vous pouvez interroger votre graphe de jumeau pour répondre à des questions sur votre environnement, à l’aide du langage de requête Azure Digital Twins de type SQL. L’une des façons d’interroger les jumeaux de votre graphique consiste à utiliser leurs propriétés. L’interrogation basée sur les propriétés peut vous aider à répondre à diverses questions, ou identifier les valeurs hors normes, sur votre environnement. Dans un scénario entièrement connecté et piloté par les données, les propriétés de vos jumeaux changent fréquemment en réponse aux données IoT des capteurs de votre environnement ou à d’autres sources de données connectées. Dans ce guide de démarrage rapide, vous modifiez manuellement les valeurs pour simuler la lecture d’un capteur changeant.

Commencez par exécuter une requête pour voir combien de jumeaux dans votre environnement ont une température supérieure à 75. Exécutez la requête suivante dans le panneau Explorateur de requêtes.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Rappelez-vous, après avoir consulté les propriétés des jumeaux plus tôt, que la température de Room0 est de 70, celle de Room1 est de 80 et celle de Room2 est de 72. Les jumeaux de bâtiment et d’étage n’ont pas du tout de propriété de température. Ainsi, seul Room1 s’affiche dans les résultats.

Conseil

D’autres opérateurs de comparaison (<,>, =, ou !=) sont également pris en charge dans les requêtes. Vous pouvez essayer de tester ces opérateurs, mais aussi d’autres valeurs ou propriétés de jumeaux, dans la requête pour tenter de répondre à vos propres questions.

Modifier les données de température

Dans une solution Azure Digital Twins entièrement connectée, les jumeaux dans votre graphe reçoivent des mises à jour automatiques à partir d’appareils IoT réels et d’autres sources de données, et mettent à jour leurs propriétés automatiquement afin de rester synchronisés avec votre environnement réel. Pour plus de simplicité dans ce guide de démarrage rapide, vous utilisez Azure Digital Twins Explorer ici pour régler manuellement le relevé de température de la Salle0 à 76.

D’abord, réexécutez la requête suivante pour sélectionner tous les jumeaux numériques. Cette action affiche à nouveau le graphique complet dans le panneau Twin Graph .

SELECT * FROM DIGITALTWINS

Sélectionnez Room0 pour afficher sa liste de propriétés dans le panneau Propriétés du jumeau.

Modifiez la valeur de température de 70 à 76, puis sélectionnez l’icône Enregistrer pour mettre à jour la température.

Une fois la mise à jour de propriété réussie, vous verrez une case Informations sur les correctifs montrant le code de correctif utilisé en arrière-plan avec les API Azure Digital Twins pour effectuer la mise à jour.

Fermez les informations sur les correctifs.

Requête pour voir le nouveau résultat

Pour voir la nouvelle température de Room0 reflétée dans le graphique, relancez la requête de plus tôt pour obtenir tous les jumeaux de l’environnement dont la température est supérieure à 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Maintenant que la température de Room0 est passée de 70 à 76, Room0 et Room1 doivent apparaître dans le résultat.

Passer en revue et contextualiser les apprentissages

Dans ce guide de démarrage rapide, vous avez créé une instance Azure Digital Twins, et vous avez utilisé Azure Digital Twins Explorer pour la remplir à l’aide d’un exemple de scénario. Vous avez également ajouté un jumeau numérique manuellement.

Ensuite, vous avez exploré le graphique, y compris...

• Utilisant une requête pour répondre à une question relative au scénario
• Modifiant une propriété d’un jumeau numérique
• Réexécutant la requête pour voir comment la réponse a changé après la modification

L’objectif de cet exercice est de montrer comment vous pouvez utiliser le graphe Azure Digital Twins pour répondre à des questions sur votre environnement, en particulier lorsque les environnements IoT changent continuellement.

Dans ce guide de démarrage rapide, vous avez mis à jour la température manuellement. Il est courant dans Azure Digital Twins de connecter des jumeaux numériques à des appareils IoT réels afin qu’ils reçoivent automatiquement des mises à jour en fonction des données de l’appareil. Vous pouvez également connecter d’autres sources de données, intégrer des données à partir de différents systèmes et définir votre propre logique pour la mise à jour des jumeaux. De cette façon, vous pouvez créer un graphe dynamique qui reflète toujours l’état réel de votre environnement. Vous pouvez utiliser des requêtes pour obtenir des informations sur ce qui se passe dans votre environnement en temps réel.

Vous pouvez également exporter des données Azure Digital Twins vers le suivi historique, l’analytique des données et les outils Foundry pour obtenir des insights plus importants et effectuer des simulations d’environnement. L’intégration d’Azure Digital Twins dans vos solutions IoT peut vous aider à suivre plus efficacement le passé, contrôler le présent et prédire l’avenir.

Nettoyer les ressources

Pour le nettoyage à la fin de ce guide de démarrage rapide, choisissez les ressources Azure Digital Twins à supprimer, en fonction de ce que vous voulez faire ensuite.

• Si vous voulez continuer les guides de démarrage rapide et les tutoriels Azure Digital Twins, vous pouvez réutiliser l’instance de ce guide de démarrage rapide et n’avez pas besoin de la supprimer.

• Si vous souhaitez continuer à utiliser l’instance Azure Digital Twins à partir de cet article, mais souhaitez effacer tous ses modèles, jumeaux et relations, exécutez la commande CLI az dt job suppression suivante :

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  Si vous souhaitez uniquement supprimer certains de ces éléments, vous pouvez utiliser les commandes suppression de relation de jumeau az dt, az dt twin delete et az dt model delete pour supprimer sélectivement uniquement les éléments que vous souhaitez supprimer.

• Si vous n’avez plus besoin de votre instance Azure Digital Twins, vous pouvez la supprimer dans le portail Azure.

  Revenez à la page Vue d’ensemble de l’instance dans le portail. (Si vous avez fermé cet onglet, vous pouvez retrouver l’instance en recherchant son nom dans la barre de recherche du portail Azure et en la sélectionnant dans les résultats de la recherche.)

  Sélectionnez Supprimer pour supprimer l’instance, y compris tous ses modèles et jumeaux.

  

Vous pouvez également supprimer les exemples de fichiers projet de votre ordinateur local.

Étapes suivantes

Passez au guide de démarrage rapide suivant pour visualiser un scénario Azure Digital Twins dans un environnement 3D.

Bien démarrer avec 3D Scenes Studio

Ou bien passez directement aux tutoriels pour approfondir les kits SDK, la création de graphiques de jumeaux et la configuration des flux d’événements.

• Coder une application cliente
• Créer un graphique dans Azure Digital Twins
• Connecter une solution de bout en bout