Snabbstart – Komma igång med ett exempelscenario i Azure Digital Twins Explorer

I den här snabbstarten utforskar du ett förbyggt Azure Digital Twins med hjälp av Azure Digital Twins Explorer. Med det här verktyget kan du visualisera och interagera med Azure Digital Twins data i Azure Portal.

Med Azure Digital Twins kan du skapa och interagera med live-modeller av dina verkliga miljöer, som kan vara en del av bredare IoT-lösningar. Först modellerar du enskilda element som digitala tvillingar. Sedan ansluter du dem till ett kunskapsdiagram som kan svara på livehändelser och tillfrågas om information.

Du utför följande steg:

1. Skapa en Azure Digital Twins-instans och anslut den i Azure Digital Twins Explorer.
2. Upload fördefinierade modeller och grafdata för att konstruera exempelscenariot.
3. Utforska scenariodiagrammet som skapas.
4. Gör ändringar i diagrammet.
5. Granska dina lärdomar från upplevelsen.

Den Azure Digital Twins exempeldiagram som du kommer att arbeta med representerar en byggnad med två våningar och två rum. Floor0 innehåller Room0 och Floor1 innehåller Room1. Diagrammet ser ut som på bilden:

Förutsättningar

Du behöver en Azure-prenumeration för att slutföra den här snabbstarten. Om du inte redan har en kan du skapa en kostnadsfritt nu.

Du måste också ladda ned materialen för exempeldiagrammet som används i snabbstarten. Använd länkarna och anvisningarna nedan för att ladda ned de tre nödvändiga filerna från digital-twins-explorer-GitHub-lagringsplatsen. Senare följer du fler instruktioner för att ladda upp dem till Azure Digital Twins.

• Room.json:Det här är en modellfil som representerar ett rum i en byggnad. Gå till länken, högerklicka var som helst på skärmen och välj Spara som i webbläsarens snabbmeny. Använd följande Spara som-fönster för att spara filen någonstans på datorn med namnet Room.json.

• Floor.json:Det här är en modellfil som representerar en våning i en byggnad. Gå till länken, högerklicka var som helst på skärmen och välj Spara som i webbläsarens snabbmeny. Använd följande Spara som-fönster för att spara filen på samma plats som Room.json, under namnet Floor.json.

• buildingScenario.xlsx: Den här filen innehåller en graf över rums- och golvtvillingarna samt relationerna mellan dem. Gå till länken och välj knappen Ladda ned. Då laddas filen ned till din standardplats för nedladdning.

  

Konfigurera Azure Digital Twins

Det första steget i att arbeta Azure Digital Twins är att skapa en Azure Digital Twins instans. När du har skapat en instans av tjänsten kan du ansluta till instansen i Azure Digital Twins Explorer, som du använder för att arbeta med instansen i hela snabbstarten.

Resten av det här avsnittet går igenom de här stegen.

Skapa en Azure Digital Twins-instans

I det här avsnittet skapar du en ny instans av Azure Digital Twins med hjälp av Azure Portal. Gå till portalen och logga in med dina autentiseringsuppgifter.

1. När du är i portalen börjar du med att välja Skapa en resurs på startsidan för Azure-tjänster.

   

2. Sök efter Azure Digital Twins i sökrutan och välj Azure Digital Twins tjänsten i resultaten. Välj knappen Skapa för att skapa en ny instans av tjänsten.

   

3. Fyll i fälten på fliken Grundläggande inställningar, inklusive prenumeration, resursgrupp, plats och resursnamn för den nya instansen. Markera rutan Tilldela Azure Digital Twins dataägare för att ge dig själv behörighet att hantera data i instansen.

   Anteckning

   Om rutan Azure Digital Twins dataägare är nedtonad innebär det att du inte har behörighet i din Azure-prenumeration för att hantera användaråtkomst till resurser. Du kan fortsätta att skapa instansen i det här avsnittet och sedan ha någon med de behörigheter som krävs tilldela dig den här rollen på instansen innan du slutför resten av den här snabbstarten.

   Vanliga roller som uppfyller det här kravet är Ägare, Kontoadministratör eller en kombination av Administratör för användaråtkomst och Deltagare.

4. Välj Granska + skapa för att slutföra skapandet av din instans.

   

5. En sammanfattningssida visas med den information som du har angett. Bekräfta och skapa instansen genom att välja Skapa.

Då kommer du till en översiktssida som spårar distributionsstatus för instansen.

Öppna instansen i Azure Digital Twins Explorer

När instansen har distribuerats använder du knappen Gå till resurs för att gå till instansens översiktssida i portalen.

Välj sedan knappen Öppna Azure Digital Twins Explorer (förhandsversion).

Då öppnas ett Azure Digital Twins Explorer som är anslutet till din instans.

Upload exempelmaterial

Därefter importerar du exempelmodellerna och grafen till Azure Digital Twins Explorer. Du använder modellfilerna och graffilen som du laddade ned till datorn i avsnittet Förutsättningar.

Modeller

Det första steget i en Azure Digital Twins lösning är att definiera vokabulären för din miljö. Du skapar anpassade modeller som beskriver de typer av entiteter som finns i din miljö.

Varje modell är skriven på ett språk som JSON-LD som kallas Digital Twin Definition Language (DTDL). Varje modell beskriver en enskild typ av entitet vad gäller dess egenskaper, telemetri, relationer och komponenter. Senare kommer du att använda dessa modeller som grund för digitala tvillingar som representerar specifika instanser av dessa typer.

När du skapar en modell utför du vanligtvis tre steg:

1. Skriv modelldefinitionen. I snabbstarten är det här steget redan gjort som en del av exempellösningen.
2. Verifiera den för att kontrollera att syntaxen är korrekt. I snabbstarten är det här steget redan gjort som en del av exempellösningen.
3. Upload till din Azure Digital Twins instans.

För den här snabbstarten är modellfilerna redan skrivna och verifierade åt dig. De ingår i den lösning som du laddade ned. I det här avsnittet laddar du upp två förskrivna modeller till din instans för att definiera dessa komponenter i en byggmiljö:

• Floor
• Rum

Upload modeller (.json-filer)

Följ de här stegen för att ladda upp modeller (JSON-filerna som du laddade ned tidigare).

1. I panelen Modeller väljer du ikonen Upload modellikon som visar en pil som pekar på ett moln.

   

2. I fönstret Öppna som visas navigerar du till mappen som innehåller filerna Room.json och Floor.json som du laddade ned tidigare.

3. Välj Room.json och Floor.json och välj Öppna för att ladda upp båda.

Azure Digital Twins Explorer dessa modellfiler till din Azure Digital Twins instans. De bör visas i panelen Modeller och visa sina egna namn och fullständiga modell-ID:er. Du kan välja ikonerna visa modellinformation för att se DTDL-koden bakom dem.

Tvillingar och tvillingdiagrammet

Nu när vissa modeller har laddats upp till din Azure Digital Twins instans kan du lägga till digitala tvillingar som följer modelldefinitionerna.

Digitala tvillingar representerar de faktiska entiteterna i din företagsmiljö. De kan till exempel vara sensorer på en farm, lampor i en bil eller– i den här snabbstarten – rum på en byggnad. Du kan skapa många tvillingar av valfri modelltyp, till exempel flera rum som alla använder rumsmodellen. Du ansluter dem med relationer till en tvillinggraf som representerar den fullständiga miljön.

I det här avsnittet laddar du upp förskapade tvillingar som är anslutna till en förskapad graf. Diagrammet innehåller två våningar och två rum som är anslutna i följande layout:

• Floor0
  • Innehåller Room0
• Floor1
  • Innehåller Room1

Importera diagrammet (.xlsx fil)

Följ de här stegen för att importera grafen (.xlsx som du laddade ned tidigare).

1. I panelen Twin Graph väljer du ikonen Importera Graph som visar en pil som pekar på ett moln.

   

2. I fönstret Öppna navigerar du till den buildingScenario.xlsx som du laddade ned tidigare. Den här filen innehåller en beskrivning av exempeldiagrammet. Välj Öppna.

   Efter några sekunder öppnar Azure Digital Twins Explorer en importvy som visar en förhandsgranskning av diagrammet som ska läsas in.

3. Bekräfta grafuppladdningen genom att välja ikonen Spara i det övre högra hörnet på panelen för diagramförhandsgranskning.

   

4. Azure Digital Twins Explorer använder den uppladdade filen för att skapa de begärda tvillingarna och relationerna mellan dem. En dialogruta visas när den är klar. Välj Stäng.

   

5. Diagrammet har nu laddats upp till Azure Digital Twins Explorer. Gå tillbaka till panelen Twin Graph.

   

6. Om du vill se diagrammet väljer du knappen Kör fråga i frågeutforskaren, längst upp i Azure Digital Twins Explorer fönstret.

   

Den här åtgärden kör standardfrågan för att välja och visa alla digitala tvillingar. Azure Digital Twins Explorer hämtar alla tvillingar och relationer från tjänsten. Den ritar grafen som definieras av dem i Graph twin-panelen.

Utforska diagrammet

Nu kan du se den uppladdade grafen för exempelscenariot.

Cirklarna (grafen "noder") representerar digitala tvillingar. Raderna representerar relationer. Floor0-tvillingen innehåller Room0 och Floor1-tvillingen innehåller Room1.

Om du använder en mus kan du dra delar av grafen för att flytta runt dem.

Visa tvillingegenskaper

Du kan välja en tvilling för att se en lista över dess egenskaper och deras värden på panelen Egenskaper.

Här är egenskaperna för Room0:

Rum0 har en temperatur på 70.

Här är egenskaperna för Room1:

Rum1 har en temperatur på 80.

Fråga i grafen

En viktig funktion i Azure Digital Twins är möjligheten att köra frågor mot tvillingdiagrammet enkelt och effektivt för att besvara frågor om din miljö.

Ett sätt att fråga tvillingarna i grafen är med deras egenskaper. Frågor baserat på egenskaper kan hjälpa dig att besvara en mängd olika frågor. Du kan till exempel hitta extremvärden i din miljö som kan behöva uppmärksammas.

I det här avsnittet kör du en fråga för att besvara frågan om hur många tvillingar i din miljö som har en temperatur över 75.

Om du vill se svaret kör du följande fråga i frågeutforskaren.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Som du kanske minns från visningen av tvillingegenskaperna tidigare har Room0 en temperatur på 70 och Room1 har en temperatur på 80. Därför visas endast Room1 i resultatet här.

Redigera data i diagrammet

Du kan använda Azure Digital Twins Explorer redigera egenskaperna för tvillingarna som visas i diagrammet. I det här avsnittet höjer vi temperaturen för Rum0 till 76.

Börja genom att köra följande fråga igen för att välja alla digitala tvillingar. Då visas hela diagrammet en gång till i panelen Twin Graph.

SELECT * FROM DIGITALTWINS

Välj Room0 för att visa egenskapslistan på panelen Egenskaper.

Egenskaperna i den här listan kan redigeras. Välj temperaturvärdet 70 för att aktivera att ange ett nytt värde. Ange 76 och välj ikonen Spara för att uppdatera temperaturen till 76.

Nu visas ett fönster med korrigeringsinformation där korrigeringskoden visas som användes i bakgrunden med Azure Digital Twins-API:er för att göra uppdateringen. Välj Stäng.

Fråga för att se resultatet

Kontrollera att grafen registrerade din uppdatering till temperaturen för Room0 genom att köra frågan igen från tidigare för att hämta alla tvillingar i miljön med en temperatur över 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Nu när temperaturen för Rum0 har ändrats från 70 till 76 bör båda tvillingarna visas i resultatet.

Granska och kontextualisera inlärningar

I den här snabbstarten skapade du en Azure Digital Twins instans och använde Azure Digital Twins Explorer för att fylla den med ett exempelscenario.

Sedan utforskade du diagrammet genom att:

• Använda en fråga för att besvara en fråga om scenariot.
• Redigera en egenskap på en digital tvilling.
• Köra frågan igen för att se hur svaret ändrades till följd av uppdateringen.

Syftet med den här övningen är att demonstrera hur du kan använda Azure Digital Twins för att besvara frågor om din miljö, även när miljön fortsätter att ändras.

I den här snabbstarten har du gjort temperaturuppdateringen manuellt. Det är vanligt i Azure Digital Twins att ansluta digitala tvillingenheter till verkliga IoT-enheter så att de får uppdateringar automatiskt baserat på telemetridata. På så sätt kan du skapa en live-graf som alltid återspeglar det verkliga tillståndet för din miljö. Du kan använda frågor för att få information om vad som händer i din miljö i realtid.

Rensa resurser

Om du vill rensa efter den här snabbstarten väljer du vilka resurser du vill ta bort baserat på vad du vill göra härnäst.

• Om du planerar att fortsätta till Azure Digital Twins självstudier kan du återanvända instansen i den här snabbstarten för dessa artiklar och du behöver inte ta bort den.

• Om du vill fortsätta att använda den Azure Digital Twins-instans som du konfigurerade i den här artikeln, men ta bort vissa eller alla dess modeller, tvillingar och relationer, kan du använda az dt CLI-kommandona i ett Azure Cloud Shell-fönster för att ta bort de element som du vill ta bort.

• Om du inte behöver någon av de resurser som du skapade i den här självstudien kan du ta bort Azure Digital Twins-instansen och alla andra resurser från den här artikeln med kommandot az group delete. Detta tar bort alla Azure-resurser i en resursgrupp, samt själva resursgruppen.

  Viktigt

  Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser som ingår i den tas bort permanent. Var noga så att du inte tar bort fel resursgrupp eller resurser av misstag.

  Öppna Azure Cloud Shelloch kör följande kommando för att ta bort resursgruppen och allt som den innehåller.

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

Du kanske också vill ta bort exempelprojektmappen från den lokala datorn.

Nästa steg

Fortsätt sedan till självstudierna om Azure Digital Twins att bygga ut dina egna Azure Digital Twins och interaktionsverktyg.