Quickstart: aan de slag met een voorbeeldscenario in Azure Digital Twins Explorer

In deze quickstart verkent u een vooraf gebouwde Azure Digital Twins grafiek met behulp van de Azure Digital Twins Explorer. Met dit hulpprogramma kunt u uw gegevens binnen de Azure Digital Twins visualiseren en Azure Portal.

Met Azure Digital Twins kunt u livemodellen van uw echte omgevingen maken en gebruiken, die deel kunnen uitmaken van bredere IoT-oplossingen. Eerst modelleert u afzonderlijke elementen als digitale dubbels. Vervolgens koppelt u deze aan een kennisgraaf die kan reageren op livegebeurtenissen en waarop query's kunnen worden uitgevoerd om informatie op te halen.

U moet de volgende stappen voltooien:

1. Maak een Azure Digital Twins en maak er verbinding mee in Azure Digital Twins Explorer.
2. Vooraf gemaakte modellen en graafgegevens uploaden om het voorbeeldscenario samen te stellen.
3. De gemaakte scenariograaf verkennen.
4. Wijzigingen aanbrengen in de graaf.
5. Bekijk uw kennis van de ervaring.

De Azure Digital Twins voorbeeldgrafiek die u gaat gebruiken, vertegenwoordigt een gebouw met twee verdiepingen en twee ruimten. Floor0 bevat Room0 en Floor1 bevat Room1. De graaf ziet eruit als deze afbeelding:

Vereisten

U hebt een Azure-abonnement nodig om deze quickstart te voltooien. Als u er nog geen hebt, kunt u er nu gratis een maken .

U moet ook de materialen downloaden voor de voorbeeldgrafiek die in de quickstart wordt gebruikt. Gebruik de onderstaande koppelingen en instructies om de drie vereiste bestanden te downloaden uit de digital-twins-explorer GitHub opslagplaats. Later volgt u meer instructies om ze te uploaden naar Azure Digital Twins.

• Room.json:Dit is een modelbestand dat een ruimte in een gebouw vertegenwoordigt. Navigeer naar de koppeling, klik met de rechtermuisknop op een locatie op het scherm en selecteer Opslaan als in het snelmenu van uw browser. Gebruik het volgende Venster Opslaan als om het bestand ergens op uw computer op te slaan met de naam Room.json.

• Floor.json:dit is een modelbestand dat een verdieping in een gebouw vertegenwoordigt. Navigeer naar de koppeling, klik met de rechtermuisknop op een locatie op het scherm en selecteer Opslaan als in het snelmenu van uw browser. Gebruik het volgende Venster Opslaan als om het bestand op te slaan op dezelfde locatie als Room.json, onder de naam Floor.json.

• buildingScenario.xlsx: dit bestand bevat een grafiek van de tweelingen van de ruimte en de vloer, en de relaties ertussen. Navigeer naar de koppeling en selecteer de knop Downloaden. Hiermee wordt het bestand gedownload naar de standaardlocatie voor downloaden.

  

Azure Digital Twins instellen

De eerste stap bij het werken met Azure Digital Twins is het maken van een Azure Digital Twins-exemplaar. Nadat u een exemplaar van de service hebt gemaakt, kunt u verbinding maken met het exemplaar in Azure Digital Twins Explorer, dat u in de quickstart gaat gebruiken om met het exemplaar te werken.

In de rest van deze sectie krijgt u stapsgewijze instructies.

Een Azure Digital Twins-exemplaar maken

In deze sectie maakt u een nieuw exemplaar van Azure Digital Twins met behulp van Azure Portal. Navigeer naar de portal en meld u aan met uw referenties.

1. Eenmaal in de portal selecteert u eerst Een resource maken in het menu op de startpagina van Azure-services.

   

2. Zoek naar Azure Digital Twins in het zoekvak en kies de Azure Digital Twins service in de resultaten. Selecteer de knop Maken om een nieuw exemplaar van de service te maken.

   

3. Vul de velden in op het tabblad Basisbeginselen van de installatie, met inbegrip van uw Abonnement, Resourcegroep, Locatie en een Resourcenaam voor uw nieuwe exemplaar. Vink het selectievakje Azure Digital Twins rol van gegevenseigenaar aan om uzelf machtigingen te geven voor het beheren van gegevens in het exemplaar.

   Notitie

   Als het vak Azure Digital Twins rol van gegevenseigenaar grijs wordt weergegeven, betekent dit dat u geen machtigingen hebt in uw Azure-abonnement om gebruikerstoegang tot resources te beheren. U kunt doorgaan met het maken van het exemplaar in deze sectie en vervolgens iemand met de benodigde machtigingen aan u deze rol laten toewijzen voor het exemplaar voordat u de rest van deze quickstart voltooit.

   Algemene rollen die aan deze vereiste voldoen, zijn Eigenaar, Accountbeheerder of de combinatie van Beheerder voor gebruikerstoegang en Inzender.

4. Selecteer Beoordelen en maken om het maken van uw exemplaar te voltooien.

   

5. U ziet een overzichtspagina met de details die u hebt ingevoerd. Bevestig en maak het exemplaar door Maken te selecteren.

Hiermee gaat u naar de pagina Overzicht om de implementatiestatus van het exemplaar bij te houden.

Instantie openen in Azure Digital Twins Explorer

Wanneer de implementatie van het exemplaar is voltooid, gebruikt u de knop Ga naar resource om naar de overzichtspagina van het exemplaar in de portal te navigeren.

Selecteer vervolgens de knop Azure Digital Twins Explorer (preview) openen.

Hiermee opent u een Azure Digital Twins Explorer is verbonden met uw exemplaar.

Upload voorbeeldmateriaal maken

Vervolgens importeert u de voorbeeldmodellen en grafiek in Azure Digital Twins Explorer. U gebruikt de modelbestanden en het grafiekbestand dat u naar uw computer hebt gedownload in de sectie Vereisten.

Modellen

De eerste stap bij het maken van een Azure Digital Twins-oplossing is het definiëren van de woordenlijst voor uw omgeving. Hiertoe maakt u aangepaste modellen waarin de typen entiteiten worden beschreven die in uw omgeving aanwezig zijn.

Elk model wordt geschreven in een taal, zoals JSON-LD. Deze taal noemen we de DTDL (Digital Twin Definition Language). In elk model wordt één type entiteit beschreven, in termen van de eigenschappen, telemetriegegevens, relaties en onderdelen. Later gaat u deze modellen gebruiken als de basis voor digitale tweelingen die specifieke instanties van deze typen vertegenwoordigen.

Normaal gesproken maakt u een model in drie stappen:

1. De modeldefinitie schrijven. In de quickstart is dit al gedaan als onderdeel van de voorbeeldoplossing.
2. Het model valideren om te controleren of de syntaxis klopt. In de quickstart is dit al gedaan als onderdeel van de voorbeeldoplossing.
3. Het model uploaden naar uw exemplaar van Azure Digital Twins.

In deze quickstart zijn de modelbestanden al voor u geschreven en gevalideerd. Ze zijn opgenomen bij de oplossing die u hebt gedownload. In deze sectie gaat u twee vooraf geschreven modellen uploaden naar uw exemplaar om deze onderdelen van een gebouwomgeving te definiëren:

• Floor
• Room

Upload modellen (JSON-bestanden)

Volg deze stappen om modellen te uploaden (de JSON-bestanden die u eerder hebt gedownload).

1. Selecteer in het deelvenster Modellen het Upload pictogram Model met een pijl die naar een cloud wijst.

   

2. Navigeer in het venster Openen dat wordt weergegeven naar de map met de bestanden Room.json en Floor.json die u eerder hebt gedownload.

3. Selecteer Room.json en Floor.json en selecteer Openen om beide te uploaden.

Azure Digital Twins Explorer worden deze modelbestanden geüpload naar uw Azure Digital Twins-exemplaar. Ze moeten worden weergegeven in het deelvenster Modellen en hun gebruiksvriendelijke namen en volledige model-ID's weergeven. U kunt de informatiepictogrammen View Model (Model bekijken) selecteren om de achterliggende DTDL-code te zien.

Twins en de tweelinggraaf

Nu er een paar modellen zijn geüpload naar uw exemplaar van Azure Digital Twins, kunt u digitale tweelingen toevoegen volgens de modeldefinities.

Digitale dubbels vertegenwoordigen de werkelijke entiteiten in uw bedrijfsomgeving. Dit kunnen sensoren in een farm, lichten in een auto of, zoals in deze quickstart, kamers op een verdieping zijn. U kunt veel dubbels maken van elk modeltype, zoals meerdere kamers die allemaal gebruikmaken van het model Room (Kamer). U verbindt deze met relaties in een dubbelgraaf die de volledige omgeving vertegenwoordigt.

In deze sectie uploadt u vooraf gemaakte tweelingen die zijn verbonden in een vooraf gemaakte grafiek. De graaf bevat twee verdiepingen en twee kamers, verbonden met de volgende indeling:

• Floor0
  • Contains Room0
• Floor1
  • Contains Room1

De graaf importeren (.xlsx bestand)

Volg deze stappen om de grafiek te importeren (het .xlsx bestand dat u eerder hebt gedownload).

1. Selecteer in het deelvenster Graph het pictogram Graph importeren met een pijl die naar een cloud wijst.

   

2. Navigeer in het venster Openen naar buildingScenario.xlsx bestand dat u eerder hebt gedownload. Dit bestand bevat een beschrijving van de voorbeeldgraaf. Selecteer Openen.

   Na een paar seconden wordt Azure Digital Twins Explorer importweergave geopend met een voorbeeld van de grafiek die moet worden geladen.

3. Als u het uploaden van de grafiek wilt bevestigen, selecteert u het pictogram Opslaan in de rechterbovenhoek van het voorbeeldvenster van de grafiek.

   

4. Azure Digital Twins Explorer gebruikt het geüploade bestand om de aangevraagde tweelingen en relaties ertussen te maken. Als dat is voltooid, wordt er een dialoogvenster weergegeven. Selecteer Close (Sluiten).

   

5. De grafiek is nu geüpload naar Azure Digital Twins Explorer. Ga terug naar het deelvenster Graph dubbel.

   

6. Als u de grafiek wilt zien, selecteert u de knop Query uitvoeren in het deelvenster Queryverkenner, bovenaan het Azure Digital Twins Explorer venster.

   

Met deze actie wordt de standaardquery uitgevoerd waarmee alle digitale dubbels worden geselecteerd en weergegeven. Azure Digital Twins Explorer haalt alle tweelingen en relaties op uit de service. Hiermee wordt de door hen gedefinieerde grafiek in het deelvenster Graph tekent.

De graaf verkennen

Nu ziet u de geüploade graaf van het voorbeeldscenario.

De cirkels (graafknooppunten) vertegenwoordigen digitale dubbels. De lijnen vertegenwoordigen relaties. U ziet dat de dubbel Floor0Room0 bevat, en dat de dubbel Floor1Room1 bevat.

Als u een muis gebruikt, kunt u delen van de graaf verslepen om ze te verplaatsen.

Tweelingeigenschappen weergeven

U kunt een tweeling selecteren om een lijst met de eigenschappen en de waarden ervan weer te geven in het deelvenster Eigenschappen.

Dit zijn de eigenschappen van Room0:

Room0 heeft een temperatuur van 70 °F.

Dit zijn de eigenschappen van Room1:

Room1 heeft een temperatuur van 80 °F.

Query uitvoeren op de graaf

Een hoofdfunctie van Azure Digital Twins is de mogelijkheid om gemakkelijk en efficiënt query's uit te voeren op uw tweelinggrafiek om vragen over uw omgeving te beantwoorden.

Een manier om de tweelingen in uw graaf op te vragen, is op basis van hun eigenschappen. Met query's op basis van eigenschappen kunnen vaak allerlei vragen worden beantwoord. U kunt bijvoorbeeld uitbijters in uw omgeving zoeken die mogelijk aandacht vereisen.

In deze sectie voert u een query uit om erachter te komen hoeveel dubbels in uw omgeving een temperatuur van meer dan 75 °F hebben.

Voer de volgende query uit in het deelvenster QueryVerkenner om het antwoord te zien.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Eerder hebben we in de tweelingeigenschappen gezien dat Room0 de temperatuur 70 °F heeft, en Room1 de temperatuur 80 °F. Daarom wordt alleen Room1 in de resultaten weergegeven.

Gegevens bewerken in de graaf

U kunt Azure Digital Twins Explorer om de eigenschappen te bewerken van de tweelingen die in uw grafiek worden weergegeven. In deze sectie gaan we de temperatuur van Room0 verhogen naar 76 °F.

Om te beginnen, moet u de volgende query opnieuw uitvoeren om alle digitale tweelingen te selecteren. Hiermee wordt de volledige grafiek nog een keer weergegeven in het deelvenster Graph Twin.

SELECT * FROM DIGITALTWINS

Selecteer Room0 om de eigenschappenlijst weer te geven in het deelvenster Eigenschappen.

De eigenschappen in deze lijst zijn bewerkbaar. Selecteer de temperatuurwaarde 70 om een nieuwe waarde te kunnen invoeren. Voer 76 in en selecteer het pictogram Save (Opslaan) om de temperatuur bij te werken naar 76.

Nu ziet u het venster Patch Information (Patchinformatie) met de patchcode die achter de schermen met de Azure Digital Twins-API's is gebruikt om de update te doen. Selecteer Close (Sluiten).

Query om het resultaat weer te geven

Verifieer dat de graaf uw update van de temperatuur voor Room0 inderdaad heeft geregistreerd door de eerdere query nogmaals uit te voeren om alle dubbels in de omgeving met een temperatuur van meer dan 75 op te halen.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Nu de temperatuur van Room0 is gewijzigd van 70 in 76, moeten beide tweelingen in het resultaat worden weergegeven.

Samenvatting en context

In deze quickstart hebt u een Azure Digital Twins gemaakt en Azure Digital Twins Explorer gebruikt om deze te vullen met een voorbeeldscenario.

Vervolgens hebt u de graaf verkend door:

• Een query te gebruiken om een vraag over het scenario te beantwoorden.
• Een eigenschap van een digitale tweeling te bewerken.
• De query opnieuw uit te voeren om te zien hoe het antwoord is veranderd als gevolg van uw update.

De intentie van deze oefening is te demonstreren hoe u de Azure Digital Twins-graaf kunt gebruiken om vragen over uw omgeving te beantwoorden terwijl de omgeving blijft veranderen.

In deze quickstart hebt u de temperatuur handmatig bijgewerkt. Normaal gesproken koppelt u digitale dubbels in Azure Digital Twins aan echte IoT-apparaten, zodat ze automatisch updates krijgen op basis van telemetriegegevens. Op deze manier kunt u een livegraaf maken die altijd de werkelijke status van uw omgeving weerspiegelt. U kunt query's gebruiken om informatie te krijgen over wat er in realtime in uw omgeving gebeurt.

Resources opschonen

Als u na deze quickstart wilt ops schonen, kiest u welke resources u wilt verwijderen op basis van wat u hierna wilt doen.

• Als u van plan bent om door te gaan met de Azure Digital Twins zelfstudies, kunt u het exemplaar in deze quickstart opnieuw gebruiken voor deze artikelen en hoeft u deze niet te verwijderen.

• Als u het Azure Digital Twins-exemplaar dat u in dit artikel hebt ingesteld, wilt blijven gebruiken, maar sommige of alle modellen, tweelingen en relaties wilt wissen, kunt u de az dt CLI-opdrachten in een Azure Cloud Shell-venster gebruiken om de elementen te verwijderen die u wilt verwijderen.

• Als u de resources die u in deze zelfstudie hebt gemaakt niet nodig hebt, kunt u de Azure Digital Twins-instantie en alle andere resources uit dit artikel verwijderen met de opdracht az group delete. Hiermee verwijdert u alle Azure-resources in een resourcegroep, evenals de resourcegroep zelf.

  Belangrijk

  Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle resources daarin worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert.

  Open Azure Cloud Shellen voer de volgende opdracht uit om de resourcegroep en alles wat deze bevat te verwijderen.

  az group delete --name <your-resource-group>
  

U kunt ook de voorbeeldprojectmap van uw lokale computer verwijderen.

Volgende stappen

Ga vervolgens verder met de zelfstudies over Azure Digital Twins om uw eigen Azure Digital Twins-scenario en-interactiehulpprogramma's samen te stellen.