Tutoriel : Déployer la préversion d’Azure Digital Twins et configurer un graphique spatialTutorial: Deploy Azure Digital Twins Preview and configure a spatial graph

Vous pouvez utiliser le service Azure Digital Twins en préversion pour rassembler des personnes, des lieux et des appareils dans un système spatial homogène.You can use the Azure Digital Twins Preview service to bring together people, places, and devices in a coherent spatial system. Cette série de tutoriels montre comment utiliser Azure Digital Twins pour détecter l’occupation d’une salle avec des conditions optimales de qualité d’air et de température.This series of tutorials demonstrates how to use Azure Digital Twins to detect room occupancy with optimal conditions of temperature and air quality.

Ces tutoriels vous guident dans une application de console .NET pour créer un scénario de bâtiment hébergeant des bureaux.These tutorials will walk you through a .NET console application to build a scenario of an office building. L’immeuble comprend plusieurs étages et plusieurs salles à chaque étage.The building has multiple floors and rooms within each floor. Dans les salles se trouvent des appareils auxquels sont reliés des capteurs qui détectent les mouvements, la température ambiante et la qualité de l’air.The rooms contain devices with attached sensors that detect motion, ambient temperature, and air quality.

Vous allez apprendre à répliquer les entités et les zones physiques du bâtiment, tels que des objets numériques en utilisant le service Azure Digital Twins.You'll learn how to replicate the physical areas and entities in the building as digital objects by using the Azure Digital Twins service. Vous allez simuler des événements d’appareil à l’aide d’une autre application console.You'll simulate device events by using another console application. Ensuite, vous allez apprendre à superviser presque en temps réel les événements qui proviennent de ces entités et zones physiques.Then, you'll learn how to monitor the events that come from these physical areas and entities in near real time.

Un administrateur de bureau peut utiliser ces informations pour aider un employé travaillant dans ce bâtiment à réserver des salles de réunion avec des conditions optimales.An office administrator can use this information to help an employee working in this building to book meeting rooms with optimal conditions. Un responsable des locaux de bureau peut utiliser votre configuration pour obtenir les tendances d’utilisation des salles, et également surveiller les conditions de travail à des fins de maintenance.An office facilities manager can use your setup to get usage trends of the rooms, and to monitor working conditions for maintenance purposes.

Dans le premier didacticiel de cette série, vous allez apprendre à effectuer les actions suivantes :In the first tutorial of this series, you learn how to:

  • Déployer Digital Twins.Deploy Digital Twins.
  • Accorder des autorisations à votre application.Grant permissions to your app.
  • Modifier un exemple d’application Digital Twins.Modify a Digital Twins sample app.
  • Provisionner votre bâtiment.Provision your building.

Ces didacticiels utilisent et modifient les mêmes exemples que ceux du démarrage rapide de recherche de salles disponibles, pour une couverture plus détaillée des concepts.These tutorials use and modify the same samples that the quickstart to find available rooms uses, for a more detailed and in-depth coverage of the concepts.

Conditions préalables requisesPrerequisites

  • Un abonnement Azure.An Azure subscription. Si vous ne possédez pas de compte Azure, créez un compte gratuit.If you don’t have an Azure account, create a free account.

  • Le kit SDK .NET Core.The .NET Core SDK. Les exemples Azure Digital Twins utilisés dans ces tutoriels sont écrits en C#.The Azure Digital Twins samples used in these tutorials are written in C#. Veillez à installer le kit SDK .NET Core version 2.1.403 ou ultérieure sur votre machine de développement pour créer et exécuter l’exemple.Make sure to install .NET Core SDK version 2.1.403 or later on your development machine to build and run the sample. Vérifiez que la version appropriée est installée sur votre machine en exécutant dotnet --version dans une fenêtre de commande.Check that the right version is installed on your machine by running dotnet --version in a command window.

  • Visual Studio Code pour explorer l’exemple de code.Visual Studio Code to explore the sample code.

Déployer Digital TwinsDeploy Digital Twins

Utilisez les étapes de cette section pour créer une instance du service Azure Digital Twins.Use the steps in this section to create a new instance of the Azure Digital Twins service. Une seule instance peut être créée par abonnement.Only one instance can be created per subscription. Passez à la section suivante si vous en avez déjà une en cours d’exécution.Skip to the next section if you already have one running.

  1. Connectez-vous au portail Azure.Sign in to the Azure portal.

  2. Sélectionnez la barre latérale, puis + Créer une ressource.Select the home side-bar, then + Create a resource.

    Développer la barre latérale, puis sélectionnez + Créer une ressourceExpand the home side-bar, then select + Create a resource

  3. Recherchez Digital Twins, puis sélectionnez Digital Twins.Search for Digital Twins, and select Digital Twins.

    Sélections pour la création d’une instance Digital TwinsSelections for creating a new Digital Twins instance

    Vous pouvez également sélectionner Internet des objets, puis Digital Twins (version préliminaire) .Alternatively, select Internet of Things, and select Digital Twins (preview).

  4. Sélectionnez Créer pour commencer le processus de déploiement.Select Create to start the deployment process.

    Créer et confirmer le déploiement de la ressourceCreate and confirm the deployment of the resource

  5. Dans le volet Digital Twins, entrez les informations suivantes :In the Digital Twins pane, enter the following information:

    • Nom de la ressource : créez un nom unique pour votre instance Digital Twins.Resource Name: Create a unique name for your Digital Twins instance.

    • Abonnement: choisissez l’abonnement que vous souhaitez utiliser pour créer cette instance Digital Twins.Subscription: Choose the subscription that you want to use to create this Digital Twins instance.

    • Groupe de ressources : sélectionnez ou créez un groupe de ressources pour l’instance Digital Twins.Resource group: Select or create a resource group for the Digital Twins instance.

    • Emplacement : Sélectionnez l’emplacement le plus proche de vos appareils.Location: Select the closest location to your devices.

      Volet Digital Twins avec les informations entréesDigital Twins pane with entered information

  6. Vérifiez les informations de votre instance Digital Twins et sélectionnez Créer.Review your Digital Twins information, and then select Create. La création de votre instance Digital Twins peut prendre quelques minutes.Your Digital Twins instance might take a few minutes to be created. Vous pouvez suivre la progression dans le volet Notifications.You can monitor the progress in the Notifications pane.

  7. Ouvrez le volet Vue d’ensemble de votre instance Digital Twins.Open the Overview pane of your Digital Twins instance. Notez le lien sous API de gestion.Note the link under Management API. L’URL de l’API de gestion respecte le format suivant :The Management API URL is formatted as:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger
    

    Cette URL vous renvoie à la documentation de l’API REST d’Azure Digital Twins qui correspond à votre instance.This URL takes you to the Azure Digital Twins REST API documentation that applies to your instance. Pour savoir comment lire et utiliser la documentation de cette API, consultez la section Comment utiliser Azure Digital Twins Swagger.Read How to use Azure Digital Twins Swagger to learn how to read and use this API documentation. Copiez et modifiez l’URL de l’API de gestion pour qu’elle respecte le format suivant :Copy and modify the Management API URL to this format:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/
    

    Votre application se servira de l’URL modifiée comme de l’URL de base pour accéder à votre instance.Your application will use the modified URL as the base URL to access your instance. Copiez cette URL modifiée dans un fichier temporaire.Copy this modified URL to a temporary file. Vous en aurez besoin dans la prochaine section.You'll need this in the next section.

    Vue d’ensemble de l'API de gestionManagement API overview

Accorder des autorisations à votre applicationGrant permissions to your app

Digital Twins utilise Azure Active Directory (Azure AD) pour contrôler l’accès en lecture/écriture au service.Digital Twins uses Azure Active Directory (Azure AD) to control read/write access to the service. Les applications devant se connecter à votre instance Digital Twins doivent être inscrites auprès d’Azure AD.Any application that needs to connect with your Digital Twins instance must be registered with Azure AD. La procédure décrite dans cette section montre comment inscrire votre exemple d’application.The steps in this section show how to register your sample app.

Si vous disposez déjà d’une inscription d’application, vous pouvez la réutiliser pour votre exemple.If you already have an app registration, you can reuse it for your sample. Toutefois, parcourez cette section pour vous assurer que l’inscription de votre application est correctement configurée.However, browse through this section to make sure your app registration is configured correctly.

Notes

Cette section fournit les instructions sur l’inscription de l'application Azure AD.This section provides instructions for Azure AD app registration.

  1. Dans le Portail Azure, ouvrez Azure Active Directory dans le menu de gauche développable, puis ouvrez le volet Inscriptions d’applications.In the Azure portal, open Azure Active Directory from the expandable left menu, and then open the App registrations pane.

    Sélectionnez le volet Azure Active DirectorySelect the Azure Active Directory pane

  2. Sélectionnez le bouton + Nouvelle inscription.Select the + New registration button.

    Sélectionner le bouton Nouvelle inscriptionSelect the New registration button

  3. Dans la zone Nom, donnez un nom convivial à l’inscription de cette application.Give a friendly name for this app registration in the Name box.

    1. Sous la section URI de redirection (facultatif) , entrez https://microsoft.com dans la zone de texte.Under Redirect URI (optional) section, enter https://microsoft.com in the textbox.

    2. Vérifiez quels comptes et locataires sont pris en charge par votre application Azure Active Directory.Verify which accounts and tenants are supported by your Azure Active Directory app.

    3. Sélectionnez Inscription.Select Register.

    Volet CréerCreate pane

  4. Le panneau Authentification spécifie les paramètres importants de configuration d’authentification.The Authentication blade specifies important authentication configuration settings.

    1. Ajoutez des URI de redirection et configurez des Jetons d’accès en sélectionnant + Ajouter une plateforme.Add Redirect URIs and configure Access Tokens by selecting + Add a platform.

    2. Sélectionnez Oui pour indiquer que l’application est un client public.Select Yes to specify that the app is a public client.

    3. Vérifiez quels comptes et locataires sont pris en charge par votre application Azure Active Directory.Verify which accounts and tenants are supported by your Azure Active Directory app.

    Paramètres de configuration du client publicPublic client configuration setting

  5. Après avoir sélectionné la plateforme appropriée, configurez vos URI de redirection et Jetons d’accès dans le volet latéral situé à droite de l’interface utilisateur.After selecting the appropriate platform, configure your Redirect URIs and Access Tokens in the side panel to the right of the user interface.

    1. L’URI de redirection doit correspondre à l’adresse fournie par la requête d’authentification :Redirect URIs must match the address supplied by the authentication request:

      • Pour les applications hébergées dans un environnement de développement local, sélectionnez Client public (mobile et bureau) .For apps hosted in a local development environment, select Public client (mobile & desktop). Veillez à affecter la valeur Oui à Client public.Make sure to set public client to Yes.
      • Pour les applications monopages hébergées sur Azure App Service, sélectionnez Web.For Single-Page Apps hosted on Azure App Service, select Web.
    2. Déterminez si une URL de déconnexion est appropriée.Determine whether a Logout URL is appropriate.

    3. Activez le flux d’octroi implicite en cochant les Jeton d'accès ou Jetons d'ID.Enable the implicit grant flow by checking Access tokens or ID tokens.

    Configurer les URI de redirectionConfigure Redirect URIs

    Cliquez sur Configurer, puis sur Enregistrer.Click Configure, then Save.

  6. Ouvrez le volet Vue d’ensemble de votre application inscrite, et copiez les valeurs des entités suivantes dans un fichier temporaire.Open the Overview pane of your registered app, and copy the values of the following entities to a temporary file. Ces valeurs vous permettront de configurer votre exemple d’application dans les sections suivantes.You'll use these values to configure your sample application in the following sections.

    • ID d’application (client)Application (client) ID
    • ID de l’annuaire (locataire)Directory (tenant) ID

    ID d’application Azure Active DirectoryAzure Active Directory application ID

  7. Ouvrez le volet API autorisées pour l’inscription de votre application.Open the API permissions pane for your app registration. Sélectionnez le bouton + Ajouter une autorisation.Select + Add a permission button. Dans le volet Demander des autorisations d’API, sélectionnez l’onglet API utilisées par mon organisation, puis recherchez un des éléments suivants :In the Request API permissions pane, select the APIs my organization uses tab, and then search for one of the following:

    1. Azure Digital Twins.Azure Digital Twins. Sélectionnez l’API Azure Digital Twins.Select the Azure Digital Twins API.

      Rechercher Azure Digital Twins dans l’APISearch API or Azure Digital Twins

    2. Vous pouvez également rechercher Azure Smart Spaces Service.Alternatively, search for Azure Smart Spaces Service. Sélectionnez l’API Azure Smart Spaces Service.Select the Azure Smart Spaces Service API.

      Rechercher Azure Smart Spaces dans l’APISearch API for Azure Smart Spaces

    Important

    Le nom et l’ID de l’API Azure AD qui s’affichent dépendent de votre locataire :The Azure AD API name and ID that will appear depends on your tenant:

    • Les comptes de locataire et client utilisés pour les tests doivent rechercher Azure Digital Twins.Test tenant and customer accounts should search for Azure Digital Twins.
    • Les autres comptes Microsoft doivent rechercher Azure Smart Spaces Service.Other Microsoft accounts should search for Azure Smart Spaces Service.
  8. L'une ou l’autre API apparaît sous Azure Digital Twins dans le même volet Demander des autorisations d’API.Either API will appear as Azure Digital Twins in the same Request API permissions pane once selected. Sélectionnez l'option de liste déroulante Read (Lire), puis activez la case à cocher Read.Write (Lire.Écrire).Select the Read drop-down option, and then select the Read.Write checkbox. Sélectionnez le bouton Ajouter des autorisations.Select the Add permissions button.

    Ajouter des autorisations d’APIAdd API permissions

  9. Selon les paramètres de votre organisation, vous devrez peut-être prendre des mesures supplémentaires pour autoriser l’accès de l’administrateur à cette API.Depending on your organization's settings, you might need to take additional steps to grant admin access to this API. Contactez votre administrateur pour obtenir plus d’informations.Contact your administrator for more information. Une fois l’accès administrateur approuvé, la colonne Consentement administrateur requis du volet Autorisations des API affichera vos autorisations.Once the admin access is approved, the Admin Consent Required column in the API permissions pane will display your permissions.

    Approbation de consentement administrateurAdmin consent approval

    Vérifiez que Azure Digital Twins s’affiche.Verify that Azure Digital Twins appears.

Configurer l’exemple Digital TwinsConfigure the Digital Twins sample

Cette section vous guide dans une application Azure Digital Twins qui communique avec les API REST Digital Twins.This section walks you through an Azure Digital Twins application that communicates with the Digital Twins REST APIs.

Télécharger l’exempleDownload the sample

Si vous avez déjà les exemples téléchargés pour le démarrage rapide de recherche de salles disponibles, vous pouvez ignorer ces étapes.If you already have the samples downloaded for the quickstart to find available rooms, you can skip these steps.

  1. Téléchargez les exemples .NET Digital Twins.Download the Digital Twins .NET samples.
  2. Extrayez le contenu du dossier zip sur votre machine.Extract the contents of the zip folder on your machine.

Explorer l’exempleExplore the sample

Dans l’exemple de dossier extrait, ouvrez le fichier digital-twins-samples-csharp\digital-twins-samples.code-workspace dans Visual Studio Code.In the extracted sample folder, open the file digital-twins-samples-csharp\digital-twins-samples.code-workspace in Visual Studio Code. Il inclut deux projets :It contains two projects:

  • Vous pouvez utiliser l’exemple de provisionnement occupancy-quickstart pour configurer et provisionner un graphe d’intelligence spatiale.You can use the provisioning sample occupancy-quickstart to configure and provision a spatial intelligence graph. Ce graphe constitue l’image numérisée de vos espaces physiques et des ressources qu’ils contiennent.This graph is the digitized image of your physical spaces and the resources in them. Il utilise un modèle objet qui définit les objets d’un bâtiment intelligent.It uses an object model, which defines objects for a smart building. Pour obtenir une liste complète des objets et API REST Digital Twins, consultez cette documentation sur les API REST ou l’URL de l’API de gestion qui a été créée pour votre instance.For a complete list of Digital Twins objects and REST APIs, visit this REST API documentation or the Management API URL that was created for your instance.

    Pour explorer l’exemple et comprendre comment il communique avec votre instance Digital Twins, vous pouvez commencer avec le dossier src\actions.To explore the sample to understand how it communicates with your Digital Twins instance, you can start with the src\actions folder. Les fichiers dans ce dossier implémentent les commandes que vous allez utiliser dans ces tutoriels :The files in this folder implement the commands that you'll use in these tutorials:

    • Le fichier provisionSample.cs montre comment provisionner votre graphe spatial.The provisionSample.cs file shows how to provision your spatial graph.
    • Le fichier getSpaces.cs récupère des informations sur les espaces provisionnés.The getSpaces.cs file gets information about the provisioned spaces.
    • Le fichier getAvailableAndFreshSpaces.cs récupère les résultats d’une fonction personnalisée appelée fonction définie par l’utilisateur.The getAvailableAndFreshSpaces.cs file gets the results of a custom function called a user-defined function.
    • Le fichier createEndpoints.cs crée des points de terminaison pour interagir avec d’autres services.The createEndpoints.cs file creates endpoints to interact with other services.
  • L’exemple de simulation device-connectivity simule les données de capteur et les envoie au hub IoT qui est provisionné pour votre instance Digital Twins.The simulation sample device-connectivity simulates sensor data and sends it to the IoT hub that's provisioned for your Digital Twins instance. Vous allez utiliser cet exemple dans le tutoriel suivant, après avoir provisionné votre graphe spatial.You'll use this sample in the next tutorial after you provision your spatial graph. Les identificateurs d’appareils et de capteurs que vous utilisez pour configurer cet exemple doivent être les mêmes que ceux que vous allez utiliser pour provisionner votre graphe.The sensor and device identifiers that you use to configure this sample should be the same as what you'll use to provision your graph.

Configurer l’exemple d’approvisionnementConfigure the provisioning sample

  1. Ouvrez une fenêtre de commande et accédez à l’exemple téléchargé.Open a command window and go to the downloaded sample. Exécutez la commande suivante :Run the following command:

    cd occupancy-quickstart/src
    
  2. Restaurez les dépendances sur l’exemple de projet en exécutant cette commande :Restore dependencies to the sample project by running this command:

    dotnet restore
    
  3. Dans Visual Studio Code, ouvrez le fichier appSettings.json dans le projet occupancy-quickstart.In Visual Studio Code, open the appSettings.json file in the occupancy-quickstart project. Utilisez les valeurs suivantes :Update the following values:

    • ClientId : entrez l’ID d’application de l’inscription de votre application Azure AD.ClientId: Enter the application ID of your Azure AD app registration. Vous avez noté cet ID à la section où vous avez défini des autorisations d’application.You noted this ID in the section where you set app permissions.
    • Tenant : entrez l’ID de répertoire de votre locataire Azure AD.Tenant: Enter the directory ID of your Azure AD tenant. Vous avez également noté cet ID à la section où vous avez défini des autorisations d’application.You also noted this ID in the section where you set app permissions.
    • BaseUrl : entrez l’URL de votre instance Digital Twins.BaseUrl: Enter the URL of your Digital Twins instance. Pour obtenir cette URL, remplacez les espaces réservés dans cette URL par les valeurs de votre instance : https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/.To get this URL, replace the placeholders in this URL with values for your instance: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Vous pouvez également obtenir cette URL en modifiant l’URL API de gestion depuis la section de déploiement.You can also get this URL by modifying the Management API URL from the deployment section. Remplacez swagger/ par api/v1.0/ .Replace swagger/ with api/v1.0/.
  4. Examinez la liste des fonctionnalités Digital Twins que vous pouvez explorer à l’aide de l’exemple.Review a list of Digital Twins features that you can explore by using the sample. Exécutez la commande suivante :Run the following command:

    dotnet run
    

Comprendre le processus de provisionnementUnderstand the provisioning process

Cette section montre comment l’exemple approvisionne un graphique spatial d’un bâtiment.This section shows how the sample provisions a spatial graph of a building.

Dans Visual Studio Code, accédez au dossier occupancy-quickstart\src\actions et ouvrez le fichier provisionSample.cs.In Visual Studio Code, browse to the occupancy-quickstart\src\actions folder and open the file provisionSample.cs. Notez la fonction suivante :Note the following function:

public static async Task<IEnumerable<ProvisionResults.Space>> ProvisionSample(HttpClient httpClient, ILogger logger)
{
    IEnumerable<SpaceDescription> spaceCreateDescriptions;
    using (var r = new StreamReader("actions/provisionSample.yaml"))
    {
        spaceCreateDescriptions = await GetProvisionSampleTopology(r);
    }

    var results = await CreateSpaces(httpClient, logger, spaceCreateDescriptions, Guid.Empty);

    Console.WriteLine($"Completed Provisioning: {JsonConvert.SerializeObject(results, Formatting.Indented)}");

    return results;
}

Cette fonction utilise le fichier provisionSample.yaml dans le même dossier.This function uses provisionSample.yaml in the same folder. Ouvrez ce fichier et notez la hiérarchie d’un bâtiment hébergeant des bureaux : Venue (Lieu) , Floor (Étage) , Area (Zone) et Rooms (Salles) .Open this file, and note the hierarchy of an office building: Venue, Floor, Area, and Rooms. Tous ces espaces physiques peuvent contenir des appareils et des capteurs.Any of these physical spaces can contain devices and sensors. Chaque entrée est dotée d’un élément type prédéfini, par exemple Floor (Étage), Room (Salle).Each entry has a predefined type—for example, Floor, Room.

L’exemple de fichier yaml montre un graphe spatial qui utilise le modèle objet Digital Twins Default.The sample yaml file shows a spatial graph that uses the Default Digital Twins object model. Ce modèle fournit des noms génériques pour la plupart des types.This model provides generic names for most types. Les noms génériques sont suffisants pour un bâtiment.Generic names are sufficient for a building. Les exemples sont Temperature (Température) pour SensorDataType (TypeDonnéesCapteur), et Map (Carte) pour SpaceBlobType (TypeObjetBlobEspace).Examples are Temperature for SensorDataType, and Map for SpaceBlobType. Un exemple de type d’espace est Room (Salle) avec des sous-types, tels que FocusRoom (SalleTravail), ConferenceRoom (SalleRéunion) et ainsi de suite.An example space type is Room with subtypes FocusRoom, ConferenceRoom, and so on.

Si vous deviez créer un graphique spatial pour un lieu de type différent, par exemple une usine, vous auriez probablement besoin d’un autre modèle objet.If you had to create a spatial graph for a different type venue, such as a factory, you might need a different object model. Vous pouvez rechercher les modèles disponibles en exécutant la commande dotnet run GetOntologies dans la ligne de commande pour l’exemple de provisionnement.You can find out which models are available to use by running the command dotnet run GetOntologies on the command line for the provisioning sample.

Pour plus d’informations sur les graphes spatiaux et les modèles objet, consultez Présentation du graphe d’intelligence spatiale et des modèles objet Digital Twins.For more information on spatial graphs and object models, read Understanding Digital Twins object models and spatial intelligence graph.

Modifier l’exemple de graphe spatialModify the sample spatial graph

Le fichier provisionSample.yaml contient les nœuds suivants :The provisionSample.yaml file contains the following nodes:

  • Ressources : le nœud resources crée une ressource Azure IoT Hub pour communiquer avec les appareils de votre configuration.resources: The resources node creates an Azure IoT Hub resource to communicate with the devices in your setup. Un hub IoT au niveau du nœud racine de votre graphe peut communiquer avec tous les appareils et tous les capteurs dans votre graphe.An IoT hub at the root node of your graph can communicate with all the devices and sensors in your graph.

  • spaces : dans le modèle d’objet Digital Twins, l’élément spaces représente les emplacements physiques.spaces: In the Digital Twins object model, spaces represent the physical locations. Chaque espace est doté d’un élément Type, par exemple Region (Région), Venue (Lieu) ou Customer (Client), et d’un élément Name convivial.Each space has a Type—for example, Region, Venue, or Customer—and a friendly Name. Les espaces peuvent appartenir à d’autres espaces, ce qui crée une structure hiérarchique.Spaces can belong to other spaces, creating a hierarchical structure. Le fichier provisionSample.yaml contient le graphe spatial d’un bâtiment imaginaire.The provisionSample.yaml file has a spatial graph of an imaginary building. Remarquez l’imbrication logique des espaces de type Floor au sein de Venue, de Area à un étage, et des nœuds Room dans une zone.Note the logical nesting of spaces of type Floor within Venue, Area in a floor, and Room nodes in an area.

  • devices : les espaces peuvent contenir des éléments devices, qui sont des entités physiques ou virtuelles gérant un certain nombre de capteurs.devices: Spaces can contain devices, which are physical or virtual entities that manage a number of sensors. Par exemple, un appareil peut être le téléphone d’un utilisateur, un pod de capteur Raspberry Pi ou une passerelle.For example, a device might be a user’s phone, a Raspberry Pi sensor pod, or a gateway. Dans le bâtiment imaginaire de votre exemple, notez que la salle nommée Focus Room (Salle de réflexion) contient un appareil Raspberry Pi 3 A1.In the imaginary building in your sample, note how the room named Focus Room contains a Raspberry Pi 3 A1 device. Chaque nœud d’appareil est identifié par un élément hardwareId unique, qui est codé en dur dans l’exemple.Each device node is identified by a unique hardwareId, which is hardcoded in the sample. Pour configurer cet exemple pour une production réelle, remplacez ces éléments par des valeurs de votre configuration.To configure this sample for an actual production, replace these with values from your setup.

  • sensors : un appareil peut contenir plusieurs sensors.sensors: A device can contain multiple sensors. Ils peuvent détecter et enregistrer des modifications physiques, telles que la température, les mouvements et le niveau de batterie.They can detect and record physical changes like temperature, motion, and battery level. Chaque nœud de capteur est identifié de façon unique par un élément hardwareId, codé en dur ici.Each sensor node is uniquely identified by a hardwareId, hardcoded here. Pour une application réelle, remplacez ceux-ci en utilisant les identificateurs uniques des capteurs de votre configuration.For an actual application, replace these by using the unique identifiers of the sensors in your setup. Le fichier provisionSample.yaml contient deux capteurs pour enregistrer Motion (les mouvements) et CarbonDioxide (le dioxyde de carbone).The provisionSample.yaml file has two sensors to record Motion and CarbonDioxide. Ajoutez un autre capteur pour enregistrer Température, en ajoutant les lignes suivantes sous les lignes du capteur CarbonDioxide.Add another sensor to record Temperature, by adding the following lines, below the lines for the CarbonDioxide sensor. Ces éléments sont fournis dans provisionSample.yaml en tant que lignes commentées.These are provided in provisionSample.yaml as commented-out lines. Vous pouvez supprimer les marques de commentaire en retirant le caractère # au début de chaque ligne.You can uncomment them by removing the # character in the front of each line.

            - dataType: Temperature
              hardwareId: SAMPLE_SENSOR_TEMPERATURE
    

    Notes

    Assurez-vous que les clés dataType et hardwareId correspondent aux instructions données au-dessus de cet extrait de code.Make sure the dataType and hardwareId keys align with the statements above this snippet. Assurez-vous également que votre éditeur ne remplace pas les espaces par des tabulations.Also make sure that your editor does not replace spaces with tabs.

Enregistrez et fermez le fichier provisionSample.yaml.Save and close the provisionSample.yaml file. Dans le tutoriel suivant, vous allez ajouter d’autres informations à ce fichier et provisionner votre exemple de bâtiment Azure Digital Twins.In the next tutorial, you'll add more information to this file, and then provision your Azure Digital Twins sample building.

Conseil

Vous pouvez afficher et modifier votre graphe spatial à l’aide de la Visionneuse de graphe Azure Digital Twins.You can view and modify your spatial graph using the Azure Digital Twins Graph Viewer.

Nettoyer les ressourcesClean up resources

Si vous souhaitez arrêter votre exploration d’Azure Digital Twins ici, vous pouvez supprimer les ressources créées dans ce tutoriel :If you want to stop exploring Azure Digital Twins at this point, feel free to delete resources created in this tutorial:

  1. Dans le menu de gauche du portail Azure, sélectionnez Toutes les ressources, puis votre groupe de ressources Digital Twins et Supprimer.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and select Delete.

    Conseil

    Si vous avez rencontré des difficultés pour supprimer votre instance de Digital Twins, une mise à jour du service a été déployée avec le correctif.If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Réessayez de supprimer votre instance.Please retry deleting your instance.

  2. Si nécessaire, supprimez l’exemple d’application sur votre machine de travail.If necessary, delete the sample application on your work machine.

Étapes suivantesNext steps

Pour savoir comment implémenter une logique personnalisée et superviser les conditions au sein de votre exemple de bâtiment, passez au tutoriel suivant de cette série :To learn how to implement a custom logic to monitor conditions in your sample building, go to the next tutorial in the series: