Oktatóanyag: az Azure digitális Twins előzetes verziójának üzembe helyezése és a térbeli gráf konfigurálása

• 01/10/2020
• 10 perc alatt elolvasható
• • a
  • o

Az Azure Digital ikrek előzetes verzió szolgáltatásával egy koherens térbeli rendszerbe rendezheti az embereket, a helyeket és az eszközöket. Ez az oktatóanyag azt mutatja be, hogyan használható az Azure Digital ikrek a helyiségek kihasználtságának észlelésére a hőmérséklet és a levegőminőség optimális feltételeivel.

Ezek az oktatóanyagok végigvezetik a .NET-konzol alkalmazásán, hogy létrejöjjön egy Office-építés forgatókönyve. Az épületen belül több emelet és szoba található. A helyiségek olyan csatlakoztatott érzékelőkkel rendelkező eszközöket tartalmaznak, amelyek a mozgást, a környezeti hőmérsékletet és a levegőminőség minőségét figyelik.

Megtudhatja, hogyan replikálhatja a fizikai területeket és entitásokat az épületben digitális objektumokként az Azure Digital Twins szolgáltatással. Az eszközök eseményeinek szimulálása egy másik konzolszoftver használatával végezhető el. Ezután megtudhatja, hogyan figyelheti a fizikai területekről és entitásokból származó eseményeket közel valós időben.

Egy irodai rendszergazda ezekkel az információkkal segíthet az épületben dolgozóknak az optimális feltételeknek megfelelő tárgyalótermek lefoglalásában. Az Office-létesítmények kezelője használhatja a telepítőt a szobák használati trendjeinek beszerzésére, valamint a karbantartási célokra használt munkafeltételek figyelésére.

A sorozat első oktatóanyagában az alábbiakkal ismerkedhet meg:

Ezek az oktatóanyagok ugyanazokat a mintákat használják és módosítják, mint a szabad helyiségek keresését bemutató rövid útmutató, amelyben megtalálhatja a fogalmak részletesebb leírását.

Előfeltételek

• Azure-előfizetés. Ha nem rendelkezik Azure-fiókkal, hozzon létre egy ingyenes fiókot.

• A .NET Core SDK. Az oktatóanyagokban használt Azure digitális Twins-mintákat C# nyelven írták. A minta létrehozásához és futtatásához győződjön meg arról, hogy a fejlesztői gépen .net Core SDK 2.1.403 vagy újabb verzió van telepítve. A parancs futtatásával győződjön meg arról, hogy a megfelelő verzió telepítve van a gépen dotnet --version .

• Visual Studio Code a mintakód vizsgálatához.

A Digital Twins üzembe helyezése

Az ebben a szakaszban ismertetett lépések segítségével hozza létre az Azure Digital Twins szolgáltatás egy új példányát. Egy előfizetéshez csak egy példány hozható létre. Ugorjon a következő szakaszra, ha már fut egy.

1. Jelentkezzen be az Azure Portalra.

2. Válassza ki a kezdőlapot, majd az + erőforrás létrehozásalehetőséget.

   

3. Keressen rá a digitális ikrekkifejezésre, és válassza a digitális ikreklehetőséget.

   

   Másik lehetőségként válassza a eszközök internetes hálózatalehetőséget, majd válassza a digitális Twins (előzetes verzió) lehetőséget.

4. Az üzembehelyezési folyamat elindításához válassza a Létrehozás elemet.

   

5. A Digital Twins panelen adja meg a következő adatokat:

   • Erőforrás neve: Adjon meg egy egyedi nevet a Digital Twins-példány számára.

   • Előfizetés: Válassza ki az adott Digital Twins-példány létrehozásához használni kívánt előfizetést.

   • Erőforráscsoport: A listából válasszon ki vagy hozzon létre egy erőforráscsoportot a Digital Twins-példány számára.

   • Hely: Válassza ki az eszközökhöz legközelebbi helyet.

     

6. Tekintse át a digitális ikrek adatait, majd válassza a Létrehozáslehetőséget. A digitális Twins-példány létrehozása eltarthat néhány percig. A létrehozás folyamatát az Értesítések panelen követheti nyomon.

7. Nyissa meg a Digital Twins-példány Áttekintés paneljét. Jegyezze fel a hivatkozást a Management APIalatt. A felügyeleti API URL-címe a következőképpen van formázva:

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

   Ez az URL-cím az Ön példányára vonatkozó Azure Digital Twins REST API-dokumentációra mutat. Az API-dokumentáció értelmezésével és használatával kapcsolatban tekintse át az Azure Digital Twins Swagger használatát ismertető cikket. Másolja és módosítsa a felügyeleti API URL-címét erre a formátumra:

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

   Az alkalmazás a módosított URL-címet használja majd kiindulási URL-címként a példány eléréséhez. Másolja ezt a módosított URL-címet egy ideiglenes fájlba. Ezt a következő szakaszban kell megadnia.

   

Engedélyek megadása az alkalmazásnak

A digitális Twins Azure Active Directory (Azure ad) használatával vezérli a szolgáltatás írási/olvasási hozzáférését . Minden olyan alkalmazást, amely a digitális Twins-példánnyal való kapcsolódásra van szüksége, regisztrálni kell az Azure AD-ben. A jelen szakaszban ismertetett lépések bemutatják a mintaalkalmazás regisztrálásának módját.

Ha már rendelkezik alkalmazásregisztrációval, újból felhasználhatja azt a mintához. De mindenképpen tekintse át ezt a szakaszt, hogy az alkalmazásregisztráció megfelelően legyen konfigurálva.

1. A Azure Portalnyissa meg Azure Active Directory a bal oldali menüben, majd nyissa meg a Alkalmazásregisztrációk ablaktáblát.

   

2. Válassza az + új regisztráció gombot.

   

3. Adjon egy rövid nevet az alkalmazás regisztrálásához a név mezőben.

   1. Az átirányítási URI (nem kötelező) szakaszban adja meg https://microsoft.com a szövegmezőt.

   2. Ellenőrizze, hogy a Azure Active Directory-alkalmazás támogatja-e a fiókokat és a bérlőket.

   3. Kattintson a Register (Regisztrálás) elemre.

   

4. A hitelesítés panelen a fontos hitelesítési konfigurációs beállítások adhatók meg.

   1. Adja hozzá az átirányítási URI-ket , és konfigurálja a hozzáférési jogkivonatokat a + platform hozzáadásalehetőség kiválasztásával.

   2. Válassza az Igen lehetőséget annak megadásához, hogy az alkalmazás nyilvános ügyféllegyen.

   3. Ellenőrizze, hogy a Azure Active Directory-alkalmazás támogatja-e a fiókokat és a bérlőket.

   

5. Miután kiválasztotta a megfelelő platformot, konfigurálja az átirányítási URI-ket és a hozzáférési jogkivonatokat a felhasználói felület jobb oldalán lévő oldalsó panelen.

   1. Az átirányítási URI-azonosítóknak meg kell egyezniük a hitelesítési kérelem által megadott címtől:

      • Helyi fejlesztési környezetben üzemeltetett alkalmazásokhoz válassza a nyilvános ügyfél (mobil & asztali) lehetőséget. Ügyeljen arra, hogy a nyilvános ügyfelet állítsa Igenértékre.
      • Azure App Serviceon üzemeltetett egylapos alkalmazások esetében válassza a weblehetőséget.

   2. Döntse el, hogy megfelelő-e a kijelentkezési URL-cím .

   3. Engedélyezze az implicit engedélyezési folyamatot a hozzáférési jogkivonatok vagy azonosító tokenekellenőrzésével.

   

   Kattintson a Konfigurálás, majd a Mentéselemre.

6. Nyissa meg a regisztrált alkalmazás Áttekintés paneljét, és másolja a következő entitások értékeit egy ideiglenes fájlba. Ezeket az értékeket fogja használni a minta alkalmazás konfigurálásához a következő fejezetekben.

   • Alkalmazás (ügyfél) azonosítója
   • Címtár (bérlő) azonosítója

   

7. Nyissa meg az API-engedélyek panelt az alkalmazás regisztrálásához. Válassza az + engedély hozzáadása gombot. A kérelem API-engedélyek ablaktáblán válassza ki a saját szervezet által használt API-kat , majd keressen rá a következők egyikére:

   1. Azure Digital Twins. Válassza ki az Azure Digital Twins API-t.

      

   2. Másik lehetőségként keresse meg a következőt: Azure Smart Spaces Service . Válassza ki az Azure Smart Spaces szolgáltatás API-ját.

      

   Fontos

   A megjelenő Azure AD API-név és-azonosító a bérlőtől függ:

   • Tesztelje a bérlői és az ügyfél-fiókokat Azure Digital Twins .
   • Más Microsoft-fiókoknak is keresniük kell Azure Smart Spaces Service .

8. Az API-k az Azure Digital Twins néven jelennek meg ugyanabban a kérési API-engedélyek ablaktáblán, ha ki van választva. Válassza a READ (olvasás ) legördülő lehetőséget, majd jelölje be az olvasás. írás jelölőnégyzetet. Kattintson az engedélyek hozzáadása gombra.

   

9. A szervezet beállításaitól függően előfordulhat, hogy további lépéseket kell tennie ahhoz, hogy rendszergazdai hozzáférést biztosítson ehhez az API-hoz. További információért forduljon a rendszergazdához. A rendszergazdai hozzáférés jóváhagyása után az API-engedélyek ablaktábla rendszergazdai jóváhagyás szükséges oszlopa megjeleníti az Ön engedélyeit.

   

   Ellenőrizze, hogy az Azure digitális Twins megjelenik-e.

A digitális ikrek mintájának konfigurálása

Ez a szakasz végigvezeti egy olyan Azure digitális Twins-alkalmazáson, amely a digitális ikrek REST API-kkal kommunikál.

A minta letöltése

Ha már letöltötte a szabad helyiségek keresésére szolgáló rövid útmutató mintáit, kihagyhatja ezeket a lépéseket.

1. Töltse le a digitális Twins .net-mintákat.
2. Bontsa ki a zip-mappa tartalmát a gépen.

A minta vizsgálata

A kicsomagolt mintamappában nyissa meg a digital-twins-samples-csharp\digital-twins-samples.code-workspace fájlt a Visual Studio Code-ban. Ez két projektet tartalmaz:

• A kiépítési minta kihasználtsága- rövid útmutató segítségével konfigurálhatja és kiépítheti a térbeli intelligencia gráfját. Ez a gráf a fizikai tárhelyek és a bennük lévő erőforrások digitalizált képe. Egy objektummodellhasználatával határozza meg az intelligens épületek objektumait. A Digital Twins-objektumok és REST API-k teljes listájáért nyissa meg ezt a REST API-dokumentációt vagy a példányhoz létrehozott felügyeleti API URL-címét.

  A minta megismeréséhez, hogy megtudja, hogyan kommunikál a digitális Twins-példánnyal, elkezdheti a src\actions mappát. A mappában található fájlok implementálják az alábbi oktatóanyagokban használt parancsokat:

  • A provisionSample.cs -fájl a térbeli gráf kiépítésének módját mutatja be.
  • A getSpaces.cs -fájl beolvassa a kiépített szóközökkel kapcsolatos információkat.
  • A getAvailableAndFreshSpaces.cs fájl egy felhasználó által definiált függvény nevű egyéni függvény eredményét jeleníti meg.
  • A createEndpoints.cs fájl végpontokat hoz létre a más szolgáltatásokkal való kommunikációhoz.

• A szimulációs minta eszköz kapcsolata szimulálja az érzékelő adatait, és elküldi azt a digitális Twins-példányhoz kiépített IoT hubhoz. Ezt a mintát a következő oktatóanyagban fogja használni a térbeli gráf kiépítése után. A minta konfigurálásához használt érzékelőnek és eszköz-azonosítóknak meg kell egyezniük a gráf kiépítéséhez használt érzékelőkkel és azonosítókkal.

A kiépítési minta konfigurálása

1. Nyisson meg egy parancssorablakot, és nyissa meg a letöltött mintát. Futtassa az alábbi parancsot:

   cd occupancy-quickstart/src
   

2. Az alábbi parancs futtatásával állítsa vissza a függőségeket a mintaprojektben:

   dotnet restore
   

3. A Visual Studio Code-ban nyissa meg a appSettings.js fájlt a Foglaltság-Gyorsindítás projektben. Frissítse a következő értékeket:

   • ClientId: adja meg az Azure ad-alkalmazás regisztrációjának alkalmazás-azonosítóját. Ezt az azonosítót az alkalmazás engedélyeinek beállításacímű szakaszban jegyezte fel.
   • Bérlő: adja meg az Azure ad-bérlőcímtár-azonosítóját. Ezt az azonosítót az alkalmazás engedélyeinek beállításaszakaszban is megjegyezte.
   • BaseUrl: Adja meg a Digital Twins-példány URL-címét. Az URL-cím lekéréséhez cserélje le az URL-ben lévő helyőrzőket a példány értékeire: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Ezt az URL-címet úgy is megtekintheti, hogy módosítja a felügyeleti API URL-címét az üzembe helyezés szakaszból. Cserélje le a hencegés/ API/v 1.0/.

4. Tekintse át a minta használatával feltárni kívánt digitális Twins-funkciók listáját. Futtassa az alábbi parancsot:

   dotnet run
   

A kiépítési folyamat ismertetése

Ez a szakasz egy épület térbeli diagramjának kiépítését mutatja be.

A Visual Studio Code-ban keresse meg a Occupancy-quickstart\src\actions mappát, és nyissa meg a provisionSample.csfájlt. Figyelje meg az alábbi függvényt:

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;
}

Ez a függvény a provisionSample. YAML -t használja ugyanabban a mappában. Nyissa meg ezt a fájlt, és jegyezze fel az irodaház hierarchiáját: helyszín, a padló, a területés a szobák. A fizikai területek bármelyike tartalmazhat eszközöket és érzékelőket. Minden bejegyzés előre definiálva van, type — például a padló, a szoba.

A minta YAML -fájl egy olyan térbeli diagramot mutat be, amely a Default digitális Twins-objektummodell használatával működik. Ez a modell általános neveket biztosít a legtöbb típushoz. Az általános nevek elegendőek egy adott épületben. Ilyenek például a SensorDataType hőmérséklete, és a SpaceBlobType leképezése. A szóköz típusa például a FocusRoom, a ConferenceRoom és más típusú altípusok.

Ha más típusú helyszínhez, például gyárhoz szeretne létrehozni térbeli diagramot, előfordulhat, hogy más objektummodellre lesz szüksége. Megtudhatja, hogy mely modelleket használhatja, ha a parancssorban futtatja a dotnet run GetOntologies kiépítési mintát.

A térbeli gráfokkal és az Object modellekkel kapcsolatos további információkért olvassa el a digitális Twins-objektumok modelljeinek és a térbeli intelligencia gráfjának megismerésétismertető témakört.

A minta térbeli diagramjának módosítása

A provisionSample. YAML fájl a következő csomópontokat tartalmazza:

• erőforrások: a resources csomópont egy Azure IoT hub-erőforrást hoz létre a telepítő eszközeivel való kommunikációhoz. A Graph legfelső csomópontján lévő IoT hub képes kommunikálni a gráf összes eszközével és érzékelővel.

• spaces: A Digital Twins-objektummodellben a spaces jelöli a fizikai helyeket. Minden területhez tartozik Type — például a régió, a helyszín, az ügyfél — és a felhasználóbarát Name . A szóközök más helyekhez is tartozhatnak, hierarchikus struktúra létrehozásával. A provisionSample. YAML fájl egy képzeletbeli épületben egy térbeli gráftal rendelkezik. Figyelje meg, hogy a helyek logikai beágyazásának típusa Floor belül Venue , Area egy emeleten és Room egy adott területen lévő csomópontokban.

• devices: A terek devices-elemeket tartalmazhatnak, amelyek érzékelőket kezelő fizikai vagy virtuális entitások. Előfordulhat például, hogy egy eszköz lehet egy felhasználó telefonja, egy málna PI szenzor Pod vagy egy átjáró. Figyelje meg a mintában lévő képzeletbeli épületben, hogy a Focus Room nevű helyiség egy Raspberry Pi 3 A1 eszközt tartalmaz. Minden eszközcsomópontot egyedi hardwareId azonosít, amely szoftveresen kötött a mintában. A minta tényleges éles környezethez való konfigurálásához cserélje le ezeket a környezetében lévő értékekre.

• érzékelők: az eszközök több eszközt is tartalmazhatnak sensors . Képesek a fizikai változások, például a hőmérséklet, a mozgás és az akkumulátor szintjének észlelésére és rögzítésére. Minden érzékelő-csomópontot egyedien azonosít egy hardwareId, amely itt szoftveresen kötött. Egy tényleges alkalmazás esetében cserélje le ezeket az érzékelők egyedi azonosítóinak használatával a telepítőben. A provisionSample.yaml fájl két érzékelőt tartalmaz a mozgás és a széndioxid értékének rögzítéséhez. Ha a hőmérséklet érzékelőjét is hozzá szeretné adni, adja a következő sorokat a széndioxid-érzékelő sorai alá. Ezeket a provisionSample. YAML a megjegyzésekkel ellátható sorokban biztosítjuk. Az egyes sorok elején lévő karakter eltávolításával törölheti a megjegyzéseket # .

          - dataType: Temperature
            hardwareId: SAMPLE_SENSOR_TEMPERATURE
  

  Megjegyzés

  Győződjön meg arról, hogy a dataType és a hardwareId kulcsok a kódrészlet fölötti utasításokkal vannak igazítva. Azt is ellenőrizze, hogy a szerkesztő nem cserélte-e le a szóközöket tabulátorokra.

Mentse és zárja be a provisionSample.yaml fájlt. A következő oktatóanyagban további információkat adhat hozzá a fájlhoz, majd kiépítheti az Azure-beli digitális Twins-minta felépítését.

Az erőforrások eltávolítása

Ha ezen a ponton szeretné leállítani az Azure digitális Twins felfedezését, nyugodtan törölheti az ebben az oktatóanyagban létrehozott erőforrásokat:

1. A Azure Portalbal oldali menüjében válassza a minden erőforráselemet, válassza ki a digitális Twins-erőforráscsoportot, és válassza a Törléslehetőséget.

   Tipp

   Ha hibát észlelt a digitális Twins-példány törlésével kapcsolatban, a javítás a szolgáltatásban frissült. Próbálkozzon újra a példány törlésével.

2. Ha szükséges, törölje a minta alkalmazást a munkahelyi gépen.

További lépések

Ha meg szeretné tudni, hogyan implementálhat egy egyéni logikát a minta-összeállítás feltételeinek figyeléséhez, ugorjon az adatsorozat következő oktatóanyagára: