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

Fontos

Megjelent az Azure Digital Twins szolgáltatás új verziója. Az új szolgáltatás kibővített képességeinek fényében az eredeti Azure Digital Twins szolgáltatás (amely ebben a dokumentáció-készletben szerepel) kivonásra került.

Az új szolgáltatás dokumentációjának megtekintéséhez tekintse meg az aktív Azure digitális Twins dokumentációját.

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:

  • Digitális Twins üzembe helyezése.
  • Engedélyek megadása az alkalmazás számára.
  • Digitális Twins-minta alkalmazás módosítása.
  • Építheti ki az építést.

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.

    Bontsa ki a Kezdőlap sávot, majd válassza az + erőforrás létrehozása lehetőséget.

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

    Új digitális Twins-példány létrehozásának kijelölése

    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.

    Az erőforrás központi telepítésének létrehozása és megerősítése

  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.

      Digitális Twins-ablaktábla megadott adatokkal

  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.

    Felügyeleti API – áttekintés

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.

Megjegyzés

Ez a szakasz az Azure ad-alkalmazás regisztrálásáravonatkozó utasításokat tartalmazza.

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

    Válassza ki a Azure Active Directory panelt

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

    Az új regisztráció gomb kiválasztása

  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.

    Létrehozás ablaktábla

  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.

    Nyilvános ügyfél konfigurációjának beállítása

  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.

    Átirányítási URI-k konfigurálása

    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

    Azure Active Directory alkalmazás 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.

      Keresés az API-ban vagy az Azure Digital Twins-ban

    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.

      Azure intelligens Spaces-API keresése

    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.

    API-engedélyek hozzáadása

  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.

    Rendszergazdai hozzájárulás jóváhagyása

    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.

Tipp

A térbeli gráfot az Azure Digital Twins Graph Viewerhasználatával tekintheti meg és módosíthatja.

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: