Kurz: nasazení digitálních vláken Azure ve verzi Preview a konfigurace prostorového grafu

Důležité

Byla vydána nová verze služby digitálních vláken Azure. Na základě rozšířených možností nové služby je původní služba digitálních vláken Azure (popsaná v této sadě dokumentace) vyřazená.

Dokumentaci k nové službě najdete v dokumentaci k aktivním digitálním podkladům Azure.

Službu Azure Digital Replaces ve verzi Preview můžete použít k spojování osob, míst a zařízení v souvislém prostorovém systému. V této sérii kurzů se dozvíte, jak používat digitální vlákna Azure k detekci obsazení místností s využitím optimálních podmínek teploty a kvality ovzduší.

Tyto kurzy vás provedou pomocí konzolové aplikace .NET a vytvoří scénář budovy pro Office. Budova má v každé podlaze více podlah a místností. Místnosti obsahují zařízení s připojenými senzory, které zjišťují pohyb, okolní teplotu a kvalitu ovzduší.

Naučíte se, jak replikovat fyzické oblasti a entity do budovy jako digitální objekty pomocí služby Azure Digital Service. Události zařízení simulujete pomocí jiné konzolové aplikace. Pak se dozvíte, jak monitorovat události, které pocházejí z těchto fyzických oblastí a entit téměř v reálném čase.

Správce kanceláře může s využitím těchto informací pomáhat zaměstnancům pracujícím v budově s rezervací zasedacích místností s optimálními podmínkami. Správce zařízení Office může pomocí vaší instalace získat trendy využití místností a monitorovat pracovní podmínky pro účely údržby.

V prvním kurzu této série získáte informace o těchto tématech:

  • Nasaďte digitální vlákna.
  • Udělte aplikaci oprávnění.
  • Upravte ukázkovou aplikaci digitálních vláken.
  • Zřízení vaší budovy

V těchto kurzech se za účelem podrobnějšího pokrytí konceptů používají a upravují stejné ukázky jako v rychlém startu věnovaném zjištění dostupných místností.

Požadavky

  • Předplatné Azure. Pokud nemáte účet Azure, vytvořte si bezplatný účet.

  • .NET Core SDK. Ukázky digitálních vláken Azure, které se používají v těchto kurzech, jsou napsané v jazyce C#. Nezapomeňte ve vývojovém počítači nainstalovat .NET Core SDK verze 2.1.403 nebo novější a sestavte a spusťte ukázku. Ověřte, že je ve vašem počítači nainstalovaná správná verze spuštěním dotnet --version příkazu v příkazovém okně.

  • Visual Studio Code pro zkoumání vzorového kódu.

Nasazení služby Digital Twins

Postup v této části použijte k vytvoření nové instance služby Azure Digital revlákens. Pro každé předplatné se dá vytvořit jenom jedna instance. Pokud již máte spuštěnou službu, přejděte k další části.

  1. Přihlaste se k webu Azure Portal.

  2. Vyberte domovskou stránku domů a potom + vytvořit prostředek.

    Rozbalte postranní panel domů a potom vyberte + vytvořit prostředek.

  3. Vyhledejte digitální vláknaa vyberte digitální vlákna.

    Výběry pro vytvoření nové instance digitálního vlákna

    Případně vyberte Internet věcía vyberte digitální vlákna (Preview).

  4. Výběrem možnosti Vytvořit zahájíte proces nasazení.

    Vytvořte a potvrďte nasazení prostředku.

  5. V podokně Digital Twins zadejte následující informace:

    • Název prostředku: Vytvořte jedinečný název vaší instance služby Digital Twins.

    • Předplatné: Vyberte předplatné, které chcete použít k vytvoření této instance služby Digital Twins.

    • Skupina prostředků: Vyberte nebo vytvořte skupinu prostředků pro instanci služby Digital Twins.

    • Umístění: Vyberte pro zařízení nejbližší umístění.

      Podokno digitální vlákna s zadanými informacemi

  6. Projděte si informace o digitálním zaznamenání a pak vyberte vytvořit. Vytvoření instance digitálního vlákna může trvat několik minut. Průběh můžete sledovat v podokně Oznámení.

  7. Otevřete podokno Přehled vaší instance služby Digital Twins. Poznamenejte si odkaz v části rozhraní API pro správu. Adresa URL pro správu rozhraní API je naformátovaná takto:

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

    Tato adresa URL vás přesměruje na dokumentaci k rozhraní REST API služby Azure Digital Twins odpovídající vaší instanci. Informace o tom, jak číst a používat tuto dokumentaci k rozhraní API, najdete v článku Jak používat Swagger pro službu Azure Digital Twins. Zkopírujte a upravte adresu URL pro správu rozhraní API pro správu v tomto formátu:

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

    Vaše aplikace bude tuto upravenou adresu URL používat jako základní adresu URL pro přístup k vaší instanci. Zkopírujte tuto upravenou adresu URL do dočasného souboru. Budete ho potřebovat v další části.

    Přehled rozhraní API pro správu

Udělení oprávnění pro aplikaci

Digitální vlákna využívají Azure Active Directory (Azure AD) k řízení přístupu pro čtení a zápis ke službě. Všechny aplikace, které se musí připojit k instanci digitálního vlákna, musí být zaregistrované ve službě Azure AD. Postup v této části ukazuje, jak zaregistrovat ukázkovou aplikaci.

Pokud už máte registraci aplikace, můžete ji znovu použít jako ukázku. Projděte si však tuto část a ujistěte se, že je vaše registrace aplikace správně nakonfigurovaná.

Poznámka

V této části najdete pokyny k registraci aplikací Azure AD.

  1. V Azure Portalotevřete Azure Active Directory v nabídce rozbalitelné vlevo a otevřete podokno Registrace aplikací .

    Vyberte podokno Azure Active Directory

  2. Klikněte na tlačítko + Nová registrace .

    Vyberte tlačítko Nová registrace.

  3. Zadejte popisný název pro registraci této aplikace v poli název .

    1. V části URI přesměrování (volitelné) zadejte https://microsoft.com do textového pole.

    2. Ověřte, které účty a klienti podporuje vaše aplikace Azure Active Directory.

    3. Vyberte Zaregistrovat.

    Vytvořit podokno

  4. Okno ověřování určuje nastavení konfigurace pro ověřování.

    1. Přidejte identifikátory URI pro přesměrování a nakonfigurujte přístupové tokeny tak, že vyberete + Přidat platformu.

    2. Vyberte Ano , pokud chcete určit, že aplikace je veřejným klientem.

    3. Ověřte, které účty a klienti podporuje vaše aplikace Azure Active Directory.

    Nastavení konfigurace veřejného klienta

  5. Po výběru příslušné platformy nakonfigurujte identifikátory URI přesměrování a přístupové tokeny na bočním panelu napravo od uživatelského rozhraní.

    1. Identifikátory URI pro přesměrování se musí shodovat s adresou zadanou požadavkem ověřování:

      • Pro aplikace hostované v místním vývojovém prostředí vyberte možnost veřejný klient (mobilní & Desktop). Nezapomeňte nastavit veřejného klienta na Ano.
      • V případě aplikací s jednou stránkou hostovaných v Azure App Service vyberte Web.
    2. Určete, zda je Adresa URL pro odhlášení vhodná.

    3. Povolte tok implicitního udělení kontrolou přístupových tokenů nebo tokenů ID.

    Konfigurace identifikátorů URI pro přesměrování

    Klikněte na Konfigurovata pak na Uložit.

  6. Otevřete podokno Přehled vaší registrované aplikace a zkopírujte hodnoty následujících entit do dočasného souboru. Tyto hodnoty použijete ke konfiguraci ukázkové aplikace v následujících oddílech.

    • ID aplikace (klienta)
    • ID adresáře (tenanta)

    ID aplikace Azure Active Directory

  7. Otevřete podokno oprávnění rozhraní API pro registraci vaší aplikace. Klikněte na tlačítko + Přidat oprávnění . V podokně oprávnění API pro vyžádání vyberte rozhraní API moje organizace používá kartu a pak vyhledejte jednu z následujících možností:

    1. Azure Digital Twins. Vyberte rozhraní API digitálních vláken Azure .

      Prohledat rozhraní API nebo digitální vlákna Azure

    2. Případně vyhledejte Azure Smart Spaces Service . Vyberte rozhraní API služby Azure Smart Spaces .

      Vyhledat rozhraní API pro inteligentní prostory Azure

    Důležité

    Název a ID rozhraní API služby Azure AD, které se zobrazí, závisí na vašem tenantovi:

    • Testovací klient a účty zákazníka by měli hledat Azure Digital Twins .
    • Ostatní účty Microsoft by měly hledat Azure Smart Spaces Service .
  8. Po výběru se rozhraní API zobrazí jako digitální vlákna Azure ve stejném PODOKNĚ oprávnění API pro žádosti . Vyberte možnost číst rozevírací seznam a potom zaškrtněte políčko číst. zapsat . Klikněte na tlačítko Přidat oprávnění .

    Přidat oprávnění rozhraní API

  9. V závislosti na nastaveních vaší organizace možná budete muset provést další kroky, abyste tomuto rozhraní API udělili přístup správce. Pro další informace se obraťte na správce. Po schválení přístupu správce se v podokně oprávnění API zobrazí sloupec požadováno souhlasu správce , ve kterém se zobrazí vaše oprávnění.

    Schválení souhlasu správce

    Ověřte, že se zobrazí digitální vlákna Azure .

Konfigurace ukázky digitálních vláken

V této části se seznámíte s aplikací digitálních vláken Azure, která komunikuje s rozhraními REST API pro digitální vlákna.

Stažení ukázky

Pokud už máte stažené ukázky pro rychlý start věnovaný zjištění dostupných místností, můžete tyto kroky přeskočit.

  1. Stáhněte si ukázky digitálních vláken .NET.
  2. Extrahujte obsah složky zip na vašem počítači.

Zkoumání ukázky

Ve Visual Studio Code otevřete soubor digital-twins-samples-csharp\digital-twins-samples.code-workspace z extrahované složky s ukázkou. Obsahuje dva projekty:

  • K nakonfigurování a zřízení grafu prostorové logikymůžete použít ukázku zřizování – rychlý Start . Tento graf je numerická bitová kopie vašich fyzických prostorů a prostředků v nich. Používá objektový model, který definuje objekty pro inteligentní sestavení. Úplný seznam rozhraní REST API a objektů služby Digital Twins najdete v této dokumentaci k rozhraní REST API nebo na adrese URL rozhraní API pro správu vytvořené pro vaši instanci.

    Pokud chcete prozkoumat ukázku, abyste porozuměli tomu, jak komunikuje s instancí digitálního vlákna, můžete začít se složkou src\actions . Soubory v této složce implementují příkazy, které budete používat v těchto kurzech:

    • Soubor provisionSample.cs ukazuje, jak zřídit prostorový graf.
    • Soubor getSpaces.cs získává informace o zřízených prostorech.
    • Soubor getAvailableAndFreshSpaces.cs získá výsledky vlastní funkce označované jako uživatelsky definovaná funkce.
    • Soubor createEndpoints.cs vytvoří koncové body pro interakci s ostatními službami.
  • Ukázka simulace zařízení – připojení simuluje data senzorů a odesílá je do služby IoT Hub zřízené pro instanci digitálního vlákna. Tuto ukázku použijete v dalším kurzu po zřízení prostorového grafu. Identifikátory senzorů a zařízení, které použijete ke konfiguraci této ukázky, by měly být stejné jako to, co použijete ke zřízení grafu.

Konfigurace ukázky zřizování

  1. Otevřete příkazové okno a pokračujte na stažený vzorek. Spusťte následující příkaz:

    cd occupancy-quickstart/src
    
  2. Spuštěním následujícího příkazu obnovte závislosti ukázkového projektu:

    dotnet restore
    
  3. V Visual Studio Code otevřete appSettings.js v souboru v projektu pro rychlý Start pro obsazení . Aktualizujte následující hodnoty:

    • ClientID: Zadejte ID aplikace pro registraci vaší aplikace služby Azure AD. Toto ID jste si poznamenali v části, kde jste nastavili oprávnění aplikace.
    • Tenant: Zadejte ID adresáře vašeho tenanta Azure AD. Toto ID jste si také poznamenali v části, kde jste nastavili oprávnění aplikace.
    • BaseUrl: Zadejte adresu URL vaší instance služby Digital Twins. Tuto adresu URL získáte nahrazením zástupných textů v následující adrese URL za odpovídající hodnoty pro vaši instanci: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Tuto adresu URL můžete získat také změnou adresy URL rozhraní API pro správu v části nasazení. Nahraďte Swagger/ rozhraním API/v 1.0/.
  4. Projděte si seznam digitálních vlastností, které můžete prozkoumat pomocí ukázky. Spusťte následující příkaz:

    dotnet run
    

Pochopení procesu zřizování

Tato část ukazuje, jak ukázka zřizuje prostorový graf budovy.

V Visual Studio Code přejděte do složky Occupancy-quickstart\src\actions a otevřete soubor provisionSample.cs. Všimněte si následující funkce:

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

Tato funkce používá provisionSample. yaml ve stejné složce. Otevřete tento soubor a podívejte se na hierarchii kancelář budovy: místo, podlahováplocha, oblasta místnosti. Každý z těchto fyzických prostorů může obsahovat zařízení a senzory. Každá položka má předdefinovanou type — například Floor, Room.

Vzorový soubor YAML zobrazuje prostorový graf, který používá Default model digitálních vláken s objekty. Tento model poskytuje obecné názvy pro většinu typů. Obecné názvy jsou pro budova dostatečné. Příklady jsou teploty pro SensorDataType a mapují pro SpaceBlobType. Vzorový typ místa je místnost s podtypy FocusRoom, ConferenceRoom a tak dále.

Kdybyste potřebovali vytvořit prostorový graf pro jiný typ místa, například pro továrnu, pravděpodobně byste potřebovali jiný objektový model. Modely, které je možné použít, zjistíte spuštěním příkazu dotnet run GetOntologies na příkazovém řádku pro ukázku zřizování.

Další informace o prostorových grafech a objektových modelech najdete v tématu Principy digitálních objektů a grafů prostorové logiky.

Úprava ukázkového prostorového grafu

Soubor provisionSample. yaml obsahuje následující uzly:

  • prostředky: resources uzel vytvoří prostředek Azure IoT Hub ke komunikaci se zařízeními v instalačním programu. Centrum IoT v kořenovém uzlu grafu může komunikovat se všemi zařízeními a senzory v grafu.

  • spaces: V objektovém modelu služby Digital Twins představuje uzel spaces fyzická umístění. Každé místo má Type — například oblast, místo nebo zákazníka — a popis Name . Mezery můžou patřit do jiných mezer a vytvořit hierarchickou strukturu. Soubor provisionSample. yaml má prostorový graf imaginární budovy. Všimněte si logických vnoření mezer typu v Floor Venue , Area v podlaze a Room uzlech v oblasti.

  • devices: Prostory můžou obsahovat zařízení (devices), což jsou fyzické nebo virtuální entity, které spravují několik senzorů. Zařízení může být například telefon uživatele, jeho senzory maliny nebo brána. V imaginární budově v naší ukázce si všimněte, že místnost Focus Room obsahuje zařízení Raspberry Pi 3 A1. Jednotlivé uzly zařízení jsou identifikované jedinečnou hodnotou hardwareId (ID hardwaru), která je v této ukázce pevně zakódovaná. Pokud chcete tuto ukázku nakonfigurovat pro skutečný provoz v produkčním prostředí, nahraďte tyto hodnoty odpovídajícími hodnotami z vašeho systému.

  • senzory: zařízení může obsahovat víc sensors . Můžou detekovat a nahrávat fyzické změny, jako je teplota, pohyb a úroveň baterie. Každý uzel senzoru je jednoznačně identifikovaný hodnotou hardwareId (ID hardwaru), která je zde pevně zakódovaná. V případě vlastní aplikace je nahraďte pomocí jedinečných identifikátorů senzorů v nastavení. Soubor provisionSample.yaml obsahuje dva senzory pro zaznamenávání pohybu (Motion) a úrovně oxidu uhličitého (CarbonDioxide). Přidejte další senzor, který bude zaznamenávat teplotu (Temperature), a to přidáním následujících řádků pod řádky senzoru CarbonDioxide. Ty jsou k dispozici v provisionSample. yaml jako řádky s komentářem. Komentář lze odkomentovat odebráním # znaku před každým řádkem.

            - dataType: Temperature
              hardwareId: SAMPLE_SENSOR_TEMPERATURE
    

    Poznámka

    Zajistěte, aby byly dataType hardwareId klíče a zarovnané s příkazy nad tento fragment kódu. Také se ujistěte, že váš editor nenahrazuje mezery tabulátorem.

Uložte a zavřete soubor provisionSample.yaml. V dalším kurzu přidáte do tohoto souboru Další informace a potom zřídíte ukázkové sestavení digitálních vláken Azure.

Tip

Prostorový graf můžete zobrazit a upravit pomocí prohlížeče grafu digitálních vláken Azure.

Vyčištění prostředků

Pokud chcete přestat zkoumat digitální vlákna Azure v tomto okamžiku, můžete odstranit prostředky vytvořené v tomto kurzu:

  1. V nabídce vlevo v Azure Portalvyberte všechny prostředky, vyberte skupinu prostředků vaše digitální vlákna a vyberte Odstranit.

    Tip

    Pokud jste narazili na potíže s odstraněním instance digitálního vlákna, aktualizovala se aktualizace služby s touto opravou. Zkuste prosím instanci znovu odstranit.

  2. V případě potřeby odstraňte ukázkovou aplikaci v pracovním počítači.

Další kroky

Pokud se chcete dozvědět, jak implementovat vlastní logiku pro monitorování podmínek v sestavování vzorů, přečtěte si další kurz v řadě: