Zelf studie: Azure Digital Apparaatdubbels preview implementeren en een ruimtelijke grafiek configurerenTutorial: Deploy Azure Digital Twins Preview and configure a spatial graph

Notitie

Hartelijk dank voor uw interesse in het Azure Digital Apparaatdubbels preview-programma.Thank you for your interest in the Azure Digital Twins preview program. Vanwege een enorme vraag wordt het preview-programma tijdelijk gesloten tijdens de voor bereiding op de aanstaande release van nieuwe mogelijkheden.Due to overwhelming demand, the preview program is temporarily closed as we prepare for the upcoming release of new capabilities. Als gevolg hiervan is het mogelijk dat u op dit moment geen nieuwe Azure Digital Apparaatdubbels-resources kunt maken.As a result, you may not be able to create new Azure Digital Twins resources right now. Ga door met het controleren op nieuwe gegevens.Please continue checking back for new information.

U kunt de Azure Digital Apparaatdubbels preview-service gebruiken om mensen, plaatsen en apparaten samen te brengen in een samenhangend ruimtelijk systeem.You can use the Azure Digital Twins Preview service to bring together people, places, and devices in a coherent spatial system. Deze reeks zelfstudies laat zien hoe u Azure Digital Twins gebruikt voor het detecteren van ruimtebezetting met optimale omstandigheden qua temperatuur- en luchtkwaliteit.This series of tutorials demonstrates how to use Azure Digital Twins to detect room occupancy with optimal conditions of temperature and air quality.

In deze zelfstudies leert u een .NET-consoletoepassing te maken om een scenario op te bouwen voor een kantoorgebouw.These tutorials will walk you through a .NET console application to build a scenario of an office building. Het gebouw heeft meerdere verdiepingen en verschillende ruimten per verdieping.The building has multiple floors and rooms within each floor. De ruimten bevatten apparaten waaraan bewegings-, temperatuur- en luchtkwaliteitssensoren zijn gekoppeld.The rooms contain devices with attached sensors that detect motion, ambient temperature, and air quality.

U leert hoe u de fysieke gebieden en entiteiten in het gebouw kunt repliceren als digitale objecten met behulp van de Azure Digital Twins-service.You'll learn how to replicate the physical areas and entities in the building as digital objects by using the Azure Digital Twins service. U simuleert apparaatgebeurtenissen met een andere consoletoepassing.You'll simulate device events by using another console application. Vervolgens leert u hoe u de gebeurtenissen die afkomstig zijn van deze fysieke gebieden en entiteiten bijna in realtime kunt bewaken.Then, you'll learn how to monitor the events that come from these physical areas and entities in near real time.

Een office manager kan deze informatie gebruiken om werknemers in het gebouw te helpen bij het boeken van vergaderruimten met optimale omstandigheden.An office administrator can use this information to help an employee working in this building to book meeting rooms with optimal conditions. Een facilitair manager kan uw instellingen gebruiken voor het detecteren van trends in het gebruik van de ruimten en voor het bewaken van werkomstandigheden voor onderhoudswerkzaamheden.An office facilities manager can use your setup to get usage trends of the rooms, and to monitor working conditions for maintenance purposes.

In de eerste zelfstudie van deze reeks leert u het volgende:In the first tutorial of this series, you learn how to:

  • Digital Twins implementeren.Deploy Digital Twins.
  • Machtigingen verlenen aan uw app.Grant permissions to your app.
  • Een voorbeeld-app van Digital Twins wijzigen.Modify a Digital Twins sample app.
  • Het gebouw inrichten.Provision your building.

In deze zelfstudies worden dezelfde voorbeelden gebruikt en aangepast als in de snelstart voor het vinden van beschikbare ruimten, voor een meer gedetailleerde en uitgebreide uitleg van de concepten.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.

VereistenPrerequisites

  • Een Azure-abonnement.An Azure subscription. Als u geen Azure-account hebt, maakt u een gratis account.If you don't have an Azure account, create a free account.

  • De .NET Core-SDK.The .NET Core SDK. De Azure Digital Twins-voorbeelden in deze zelfstudies zijn geschreven in C#.The Azure Digital Twins samples used in these tutorials are written in C#. Installeer .NET Core SDK-versie 2.1.403 of hoger op een ontwikkelcomputer om het voorbeeld te bouwen en uit te voeren.Make sure to install .NET Core SDK version 2.1.403 or later on your development machine to build and run the sample. Controleer of de juiste versie op uw computer is geïnstalleerd door dotnet --version uit te voeren in een opdrachtvenster.Check that the right version is installed on your machine by running dotnet --version in a command window.

  • Visual Studio Code om de voorbeeldcode mee te verkennen.Visual Studio Code to explore the sample code.

Azure Digital Twins implementerenDeploy Digital Twins

Maak een nieuw exemplaar van de Azure Digital Twins-service met behulp van de stappen in deze sectie.Use the steps in this section to create a new instance of the Azure Digital Twins service. Per abonnement kan slechts één exemplaar worden gemaakt.Only one instance can be created per subscription. Ga naar de volgende sectie als u al een actief exemplaar hebt.Skip to the next section if you already have one running.

  1. Meld u aan bij de Azure-portal.Sign in to the Azure portal.

  2. Selecteer de balk aan de linkerkant en klik vervolgens op een resource maken.Select the home side-bar, then + Create a resource.

    Vouw de balk aan de linkerkant uit en selecteer + een resource makenExpand the home side-bar, then select + Create a resource

  3. Zoek naar Digital apparaatdubbelsen selecteer Digital apparaatdubbels.Search for Digital Twins, and select Digital Twins.

    Selecties voor het maken van een nieuw Digital Twins-exemplaarSelections for creating a new Digital Twins instance

    U kunt ook Internet of Thingsselecteren en Digital apparaatdubbels (preview) selecteren.Alternatively, select Internet of Things, and select Digital Twins (preview).

  4. Selecteer Maken om het implementatieproces te starten.Select Create to start the deployment process.

    De implementatie van de resource maken en bevestigenCreate and confirm the deployment of the resource

  5. In het deelvenster Digital Twins voert u de volgende informatie in:In the Digital Twins pane, enter the following information:

    • Resourcenaam: geef uw instantie van Digital Twins een unieke naam.Resource Name: Create a unique name for your Digital Twins instance.

    • Abonnement: kies het abonnement dat u wilt gebruiken om deze instantie van Digital Twins te maken.Subscription: Choose the subscription that you want to use to create this Digital Twins instance.

    • Resourcegroep: selecteer of maak een resourcegroep voor de instantie van Digital Twins.Resource group: Select or create a resource group for the Digital Twins instance.

    • Locatie: selecteer de locatie die het dichtst bij uw apparaten in de buurt is.Location: Select the closest location to your devices.

      Digital Twins-deelvenster met ingevoerde gegevensDigital Twins pane with entered information

  6. Controleer uw Digital Twins-gegevens en selecteer Maken.Review your Digital Twins information, and then select Create. Het kan een paar minuten duren voordat uw instantie van Digital Twins is gemaakt.Your Digital Twins instance might take a few minutes to be created. U kunt de voortgang bewaken via het deelvenster Meldingen.You can monitor the progress in the Notifications pane.

  7. Open het deelvenster Overzicht van de instantie van Digital Twins.Open the Overview pane of your Digital Twins instance. Zoals u ziet, wordt er een koppeling weergegeven onder Beheer API.Note the link under Management API. De URL van de beheer-API is opgemaakt als:The Management API URL is formatted as:

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

    Deze URL leidt u naar de documentatie van de REST API van Azure Digital Twins, die van toepassing is op uw instantie.This URL takes you to the Azure Digital Twins REST API documentation that applies to your instance. Zie Het gebruik van Azure Digital Twins Swagger voor informatie over hoe u deze API-documentatie dient te lezen en gebruiken.Read How to use Azure Digital Twins Swagger to learn how to read and use this API documentation. Kopieer de API-URL voor beheer en wijzig deze in deze indeling:Copy and modify the Management API URL to this format:

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

    Uw toepassing gebruikt de aangepaste URL als de basis-URL voor toegang tot uw instantie.Your application will use the modified URL as the base URL to access your instance. Kopieer deze gewijzigde URL naar een tijdelijk bestand.Copy this modified URL to a temporary file. U hebt deze URL nodig in de volgende sectie.You'll need this in the next section.

    Overzicht van beheer-APIManagement API overview

Machtigingen verlenen aan uw appGrant permissions to your app

Digital Twins maakt gebruik van Azure Active Directory (Azure AD) voor het beheren van de lees-/schrijftoegang tot de service.Digital Twins uses Azure Active Directory (Azure AD) to control read/write access to the service. Elke toepassing die moet worden verbonden met uw exemplaar van Digital Twins, moet worden geregistreerd bij Azure AD.Any application that needs to connect with your Digital Twins instance must be registered with Azure AD. In de stappen in deze sectie wordt uitgelegd hoe u de voorbeeld-app registreert.The steps in this section show how to register your sample app.

Als u al over een app-registratie beschikt, kunt u deze opnieuw gebruiken voor uw voorbeeld.If you already have an app registration, you can reuse it for your sample. Neem deze sectie echter wel door om te controleren of de registratie van uw app juist is geconfigureerd.However, browse through this section to make sure your app registration is configured correctly.

Notitie

Deze sectie bevat instructies voor de registratie van Azure AD-apps.This section provides instructions for Azure AD app registration.

  1. Open in de Azure Portal Azure Active Directory in het menu uitbreidbaar links en open vervolgens het app-registraties deel venster.In the Azure portal, open Azure Active Directory from the expandable left menu, and then open the App registrations pane.

    Het deel venster Azure Active Directory selecterenSelect the Azure Active Directory pane

  2. Selecteer de knop + nieuwe registratie .Select the + New registration button.

    Selecteer de knop nieuwe registratieSelect the New registration button

  3. Geef een beschrijvende naam voor deze app-registratie op in het vak Naam.Give a friendly name for this app registration in the Name box.

    1. Typ https://microsoft.com in het tekstvak onder omleidings-URI (optioneel) .Under Redirect URI (optional) section, enter https://microsoft.com in the textbox.

    2. Controleer welke accounts en tenants worden ondersteund door uw Azure Active Directory-app.Verify which accounts and tenants are supported by your Azure Active Directory app.

    3. Selecteer Registreren.Select Register.

    Deelvenster makenCreate pane

  4. De Blade verificatie specificeert belang rijke instellingen voor verificatie configuratie.The Authentication blade specifies important authentication configuration settings.

    1. Voeg omleidings-uri's toe en configureer toegangs tokens door + een platform toe te voegen.Add Redirect URIs and configure Access Tokens by selecting + Add a platform.

    2. Selecteer Ja om op te geven dat de app een open bare clientis.Select Yes to specify that the app is a public client.

    3. Controleer welke accounts en tenants worden ondersteund door uw Azure Active Directory-app.Verify which accounts and tenants are supported by your Azure Active Directory app.

    Configuratie-instelling voor de open bare clientPublic client configuration setting

  5. Nadat u het juiste platform hebt geselecteerd, configureert u de omleidings-uri's en toegangs tokens in het deel venster aan de rechter kant van de gebruikers interface.After selecting the appropriate platform, configure your Redirect URIs and Access Tokens in the side panel to the right of the user interface.

    1. Omleidings-uri's moeten overeenkomen met het adres dat is opgegeven door de verificatie aanvraag:Redirect URIs must match the address supplied by the authentication request:

      • Voor apps die worden gehost in een lokale ontwikkel omgeving selecteert u open bare client (mobiele & bureau blad).For apps hosted in a local development environment, select Public client (mobile & desktop). Zorg ervoor dat de open bare client is ingesteld op Ja.Make sure to set public client to Yes.
      • Voor apps met één pagina die worden gehost op Azure App Service, selecteert u Web.For Single-Page Apps hosted on Azure App Service, select Web.
    2. Bepaal of een Afmeldings-URL geschikt is.Determine whether a Logout URL is appropriate.

    3. Schakel de impliciete toekennings stroom in door toegangs tokens of id-tokenste controleren.Enable the implicit grant flow by checking Access tokens or ID tokens.

    Omleidings-Uri's configurerenConfigure Redirect URIs

    Klik op configurerenen vervolgens op Opslaan.Click Configure, then Save.

  6. Open het deel venster overzicht van de geregistreerde app en kopieer de waarden van de volgende entiteiten naar een tijdelijk bestand.Open the Overview pane of your registered app, and copy the values of the following entities to a temporary file. U gebruikt deze waarden om uw voorbeeld toepassing te configureren in de volgende secties.You'll use these values to configure your sample application in the following sections.

    • (Client-)id van de appApplication (client) ID
    • (Tenant-)id van de mapDirectory (tenant) ID

    Azure Active Directory toepassings-IDAzure Active Directory application ID

  7. Open het deel venster API-machtigingen voor de registratie van uw app.Open the API permissions pane for your app registration. Selecteer + een machtigings knop toevoegen .Select + Add a permission button. Selecteer in het deel venster API-machtigingen voor aanvragen de api's mijn organisatie tabblad gebruikt en zoek vervolgens een van de volgende opties: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. Selecteer de Azure Digital apparaatdubbels -API.Select the Azure Digital Twins API.

      Zoek-API of Azure Digital ApparaatdubbelsSearch API or Azure Digital Twins

    2. U kunt ook zoeken naar Azure Smart Spaces Service.Alternatively, search for Azure Smart Spaces Service. Selecteer de Azure Smart Spaces-service -API.Select the Azure Smart Spaces Service API.

      Zoek-API voor Azure Smart SpacesSearch API for Azure Smart Spaces

    Belangrijk

    De naam en ID van de Azure AD-API die wordt weer gegeven, is afhankelijk van uw Tenant:The Azure AD API name and ID that will appear depends on your tenant:

    • Test Tenant-en klant accounts moeten zoeken Azure Digital Twinsnaar.Test tenant and customer accounts should search for Azure Digital Twins.
    • Andere micro soft-accounts moeten Azure Smart Spaces Servicezoeken.Other Microsoft accounts should search for Azure Smart Spaces Service.
  8. Een van de API'S wordt weer gegeven als Azure Digital apparaatdubbels in het deel venster API-machtigingen voor aanvragen nadat het is geselecteerd.Either API will appear as Azure Digital Twins in the same Request API permissions pane once selected. Selecteer de vervolg keuzelijst lezen en schakel vervolgens het selectie vakje lezen. schrijven in.Select the Read drop-down option, and then select the Read.Write checkbox. Selecteer de knop machtigingen toevoegen .Select the Add permissions button.

    API-machtigingen toevoegenAdd API permissions

  9. Afhankelijk van de instellingen van uw organisatie moet u mogelijk extra stappen uitvoeren om beheerders toegang tot deze API te verlenen.Depending on your organization's settings, you might need to take additional steps to grant admin access to this API. Neem contact op met de beheerder voor meer informatie.Contact your administrator for more information. Zodra de beheerders toegang is goedgekeurd, worden in het deel venster API- machtigingen uw machtigingen weer gegeven in de kolom Administrator toestemming vereist .Once the admin access is approved, the Admin Consent Required column in the API permissions pane will display your permissions.

    Goed keuring van beheerders toestemmingAdmin consent approval

    Controleer of Azure Digital apparaatdubbels wordt weer gegeven.Verify that Azure Digital Twins appears.

Het Digital Twins-voorbeeld configurerenConfigure the Digital Twins sample

In deze sectie ziet u hoe een Azure Digital Twins-toepassing communiceert met de REST-API's van Digital Twins.This section walks you through an Azure Digital Twins application that communicates with the Digital Twins REST APIs.

Het voorbeeld downloadenDownload the sample

Als u de voorbeelden voor de snelstart voor het vinden van beschikbare ruimten al hebt gedownload, kunt u deze stappen overslaan.If you already have the samples downloaded for the quickstart to find available rooms, you can skip these steps.

  1. Download de .NET-voorbeelden van Digital Twins.Download the Digital Twins .NET samples.
  2. Pak de inhoud van de gecomprimeerde map uit op uw computer.Extract the contents of the zip folder on your machine.

Het voorbeeld verkennenExplore the sample

Open het bestand digital-twins-samples-csharp\digital-twins-samples.code-workspace uit de uitgepakte voorbeeldmap in Visual Studio Code.In the extracted sample folder, open the file digital-twins-samples-csharp\digital-twins-samples.code-workspace in Visual Studio Code. Dit bestand bevat twee projecten:It contains two projects:

  • U kunt het inrichtingsvoorbeeld occupancy-quickstart gebruiken voor het configureren en inrichten van een ruimtelijke informatiegrafiek.You can use the provisioning sample occupancy-quickstart to configure and provision a spatial intelligence graph. Deze grafiek is de digitale kopie van uw fysieke ruimten en de resources in die ruimten.This graph is the digitized image of your physical spaces and the resources in them. Er wordt gebruikgemaakt van een object modelwaarmee objecten voor een slim gebouw worden gedefinieerd.It uses an object model, which defines objects for a smart building. Ga voor een volledige lijst van objecten en REST-API's van Digital Twins naar deze REST API-documentatie of de URL van de Beheer API die is gemaakt voor uw exemplaar.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.

    Als u het voor beeld wilt bekijken om te begrijpen hoe het communiceert met uw Digital Apparaatdubbels-exemplaar, kunt u beginnen met de map src\actions .To explore the sample to understand how it communicates with your Digital Twins instance, you can start with the src\actions folder. De bestanden in deze map implementeren de opdrachten die u in deze zelfstudies gaat gebruiken:The files in this folder implement the commands that you'll use in these tutorials:

    • Het provisionSample.cs -bestand laat zien hoe u uw ruimtelijke grafiek kunt inrichten.The provisionSample.cs file shows how to provision your spatial graph.
    • Het getSpaces.cs -bestand krijgt informatie over de ingerichte ruimten.The getSpaces.cs file gets information about the provisioned spaces.
    • Het bestand getAvailableAndFreshSpaces.cs haalt de resultaten op van een aangepaste (door de gebruiker gedefinieerde) functie op.The getAvailableAndFreshSpaces.cs file gets the results of a custom function called a user-defined function.
    • Het bestand createEndpoints.cs maakt eindpunten voor interactie met andere services.The createEndpoints.cs file creates endpoints to interact with other services.
  • Het simulatievoorbeeld device-connectivity simuleert sensorgegevens en verzendt deze naar de IoT-hub die is ingericht voor uw exemplaar van 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. U gebruikt dit voorbeeld in de volgende zelfstudie nadat u de ruimtelijke grafiek hebt ingericht.You'll use this sample in the next tutorial after you provision your spatial graph. De sensor- en apparaat-id's die u gebruikt voor het configureren van dit voorbeeld moeten gelijk zijn aan de id's die u gebruikt voor het inrichten van de grafiek.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.

Het inrichtingsvoorbeeld configurerenConfigure the provisioning sample

  1. Open een opdrachtvenster en ga naar het gedownloade voorbeeld.Open a command window and go to the downloaded sample. Voer de volgende opdracht uit:Run the following command:

    cd occupancy-quickstart/src
    
  2. Herstel afhankelijkheden van het voorbeeldproject met deze opdracht:Restore dependencies to the sample project by running this command:

    dotnet restore
    
  3. Open in Visual Studio Code het bestand appSettings.json van het project occupancy-quickstart.In Visual Studio Code, open the appSettings.json file in the occupancy-quickstart project. Werk de volgende waarden bij:Update the following values:

    • ClientId: voer de toepassings-id van uw Azure AD-app-registratie in.ClientId: Enter the application ID of your Azure AD app registration. U hebt deze id genoteerd in de sectie voor het instellen van app-machtigingen.You noted this ID in the section where you set app permissions.
    • Tenant: voer de map-id van uw Azure AD-tenant in.Tenant: Enter the directory ID of your Azure AD tenant. U hebt deze id ook genoteerd in de sectie voor het instellen van app-machtigingen.You also noted this ID in the section where you set app permissions.
    • BaseUrl: voer de URL van uw exemplaar van Digital Twins in.BaseUrl: Enter the URL of your Digital Twins instance. Hiertoe vervangt u de tijdelijke aanduidingen in deze URL door de waarden voor uw exemplaar: 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/. U kunt deze URL ook verkrijgen door de URL van de Beheer API uit de implementatiesectie te wijzigen.You can also get this URL by modifying the Management API URL from the deployment section. Vervang swagger/ door api/v1.0/.Replace swagger/ with api/v1.0/.
  4. Bekijk een lijst met digitale Apparaatdubbels-functies die u kunt verkennen met behulp van het voor beeld.Review a list of Digital Twins features that you can explore by using the sample. Voer de volgende opdracht uit:Run the following command:

    dotnet run
    

Inzicht in het inrichtingsprocesUnderstand the provisioning process

In deze sectie wordt beschreven hoe u met het voorbeeld een ruimtelijke grafiek van een gebouw inricht.This section shows how the sample provisions a spatial graph of a building.

Ga in Visual Studio Code naar de map occupancy-quickstart\src\actions en open het bestand provisionSample.cs.In Visual Studio Code, browse to the occupancy-quickstart\src\actions folder and open the file provisionSample.cs. Let op de volgende functie: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;
}

Deze functie maakt gebruik van het bestand provisionSample.yaml in dezelfde map.This function uses provisionSample.yaml in the same folder. Open dit bestand en bekijk de hiërarchie van een kantoorgebouw, bestaande uit: locatie, verdieping, gebied en ruimten.Open this file, and note the hierarchy of an office building: Venue, Floor, Area, and Rooms. Elk van deze fysieke ruimten kan devices en sensors bevatten.Any of these physical spaces can contain devices and sensors. Elk vermelding heeft een vooraf gedefinieerde type—, bijvoorbeeld Verdieping, Ruimte.Each entry has a predefined type—for example, Floor, Room.

Het yaml-voorbeeldbestand bevat een ruimtelijke grafiek die gebruikmaakt van het Digital Twins-objectmodel Default.The sample yaml file shows a spatial graph that uses the Default Digital Twins object model. Dit model bevat algemene namen voor de meeste typen.This model provides generic names for most types. Algemene namen zijn voldoende voor een gebouw.Generic names are sufficient for a building. Voorbeelden hiervan zijn Temperatuur voor SensorDataType en Toewijzen voor SpaceBlobType.Examples are Temperature for SensorDataType, and Map for SpaceBlobType. Een voorbeeld van een type ruimte is Ruimte met de subtypen Concentratieruimte, Vergaderruimte, enzovoort.An example space type is Room with subtypes FocusRoom, ConferenceRoom, and so on.

Als u een ruimtelijke grafiek voor een ander type locatie wilt maken (zoals een fabriek) hebt u wellicht een ander objectmodel nodig.If you had to create a spatial graph for a different type venue, such as a factory, you might need a different object model. Als u wilt weten welke modellen beschikbaar zijn, voert u de opdracht dotnet run GetOntologies uit vanaf de opdrachtregel voor het inrichtingsvoorbeeld.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.

Lees voor meer informatie over ruimtelijke grafieken en de objectmodellen Inzicht in Digital Twins-objectmodellen en ruimtelijke informatiegrafiek.For more information on spatial graphs and object models, read Understanding Digital Twins object models and spatial intelligence graph.

Het voorbeeld van de ruimtelijke grafiek wijzigenModify the sample spatial graph

Het bestand provisionSample.yaml bevat de volgende knooppunten:The provisionSample.yaml file contains the following nodes:

  • resources: het knooppunt resources maakt een IoT Hub-resource om te communiceren met de apparaten in uw installatie.resources: The resources node creates an Azure IoT Hub resource to communicate with the devices in your setup. Een IoT-hub in het hoofdknooppunt van uw grafiek kan communiceren met alle apparaten en sensoren in uw grafiek.An IoT hub at the root node of your graph can communicate with all the devices and sensors in your graph.

  • spaces: in het Digital Twins-objectmodel worden de fysieke locaties vertegenwoordigd door spaces.spaces: In the Digital Twins object model, spaces represent the physical locations. Elke ruimte heeft een Type—, bijvoorbeeld een regio, locatie of klant—, en een gebruiksvriendelijke Name.Each space has a Type—for example, Region, Venue, or Customer—and a friendly Name. Ruimten kunnen deel uitmaken van andere ruimten in een hiërarchische structuur.Spaces can belong to other spaces, creating a hierarchical structure. Het bestand provisionSample.yaml bevat een ruimtelijke grafiek van een denkbeeldig gebouw.The provisionSample.yaml file has a spatial graph of an imaginary building. Merk op dat ruimten van het type Floor logisch genest zijn in Venue, Area in een verdieping, en Room-knooppunten in een gebied.Note the logical nesting of spaces of type Floor within Venue, Area in a floor, and Room nodes in an area.

  • devices: ruimten kunnen devices bevatten. Dat zijn fysieke of virtuele entiteiten waarmee een aantal sensoren wordt beheerd.devices: Spaces can contain devices, which are physical or virtual entities that manage a number of sensors. Een apparaat kan bijvoorbeeld het telefoon nummer van een gebruiker zijn, een Raspberry Pi sensor Pod of een gateway.For example, a device might be a user's phone, a Raspberry Pi sensor pod, or a gateway. In het denkbeeldige gebouw uit het voorbeeld bevat de ruimte Focus Room bijvoorbeeld het apparaat 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. Elk apparaatknooppunt wordt geïdentificeerd door een unieke hardwareId, die is vastgelegd in het voorbeeld.Each device node is identified by a unique hardwareId, which is hardcoded in the sample. Als u dit voorbeeld wilt configureren in een productieomgeving, moet u deze waarden vervangen door de waarden van uw installatie.To configure this sample for an actual production, replace these with values from your setup.

  • sensoren: een apparaat kan meerdere sensors bevatten.sensors: A device can contain multiple sensors. Hiermee kunnen fysieke wijzigingen (bijvoorbeeld in temperatuur, beweging of accuniveau) worden gedetecteerd en vastgelegd.They can detect and record physical changes like temperature, motion, and battery level. Elk sensorknooppunt wordt geïdentificeerd door een unieke hardwareId, die hier is vastgelegd.Each sensor node is uniquely identified by a hardwareId, hardcoded here. Voor een werkelijke toepassing moet u deze vervangen door de unieke id's van de sensoren in uw installatie.For an actual application, replace these by using the unique identifiers of the sensors in your setup. Het bestand provisionSample.yaml bevat twee sensoren: een bewegingssensor (Motion) en een CO2-sensor (CarbonDioxide).The provisionSample.yaml file has two sensors to record Motion and CarbonDioxide. Voeg, onder de regels voor de CO2-sensor, de volgende regels toe om een temperatuursensor (Temperature) toe te voegen.Add another sensor to record Temperature, by adding the following lines, below the lines for the CarbonDioxide sensor. Deze zijn opgenomen in provisionSample. yaml als commentaar-out-lijnen.These are provided in provisionSample.yaml as commented-out lines. U kunt er coderegels van maken door het teken # aan het begin van elke regel te verwijderen.You can uncomment them by removing the # character in the front of each line.

            - dataType: Temperature
              hardwareId: SAMPLE_SENSOR_TEMPERATURE
    

    Notitie

    Zorg ervoor dat de sleutels dataType en hardwareId in overeenstemming zijn met de instructies boven dit fragment.Make sure the dataType and hardwareId keys align with the statements above this snippet. Zorg er ook voor dat in uw editor spaties niet worden vervangen door tabs.Also make sure that your editor does not replace spaces with tabs.

Sla het bestand provisionSample.yaml op en sluit het.Save and close the provisionSample.yaml file. In de volgende zelfstudie gaat u meer gegevens aan dit bestand toevoegen en het voorbeeldgebouw inrichten in Azure Digital Twins.In the next tutorial, you'll add more information to this file, and then provision your Azure Digital Twins sample building.

Tip

U kunt de ruimtelijke grafiek bekijken en aanpassen met de Graph Viewer voor Azure Digital Twins.You can view and modify your spatial graph using the Azure Digital Twins Graph Viewer.

Resources opschonenClean up resources

Als u Azure Digital Twins niet verder wilt verkennen, kunt u de resources die in deze zelfstudie zijn gemaakt, gerust verwijderen:If you want to stop exploring Azure Digital Twins at this point, feel free to delete resources created in this tutorial:

  1. Klik in het linkermenu in de Azure-portal op Alle resources, selecteer de Digital Twins-resourcegroep en selecteer Verwijderen.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and select Delete.

    Tip

    Als u problemen hebt bij het verwijderen van uw Digital Twins-exemplaar, is er een service-update met de oplossing hiervoor beschikbaar.If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Probeer opnieuw of u het exemplaar kunt verwijderen.Please retry deleting your instance.

  2. Verwijder zo nodig de voorbeeldtoepassing van uw werkcomputer.If necessary, delete the sample application on your work machine.

Volgende stappenNext steps

Ga voor meer informatie over het implementeren van aangepaste logica voor het bewaken van de omstandigheden in uw voorbeeldgebouw naar de volgende zelfstudie in de reeks:To learn how to implement a custom logic to monitor conditions in your sample building, go to the next tutorial in the series: