Kurz: Příjem oznámení z prostorů Azure Digital Twins pomocí Logic Apps

Důležité

Byla vydána nová verze služby Azure Digital Twins. Vzhledem k rozšířeným funkcím nové služby se původní služba Azure Digital Twins (popsaná v této sadě dokumentace) vyřadila z provozu.

Pokud chcete zobrazit dokumentaci k nové službě, navštivte aktivní dokumentaci ke službě Azure Digital Twins.

Po nasazení instance služby Azure Digital Twins, zřízení prostorů a implementaci vlastních funkcí pro monitorování konkrétních podmínek můžete správce kanceláře informovat e-mailem, když dojde k monitorovaným podmínkám.

V prvním kurzujste nakonfigurovali prostorový graf imaginární budovy. Místnost v budově obsahuje senzory pro pohyb, oxidu uhličitého a teplotu. V druhém kurzujste zřídili graf a uživatelsky definovanou funkci pro monitorování těchto hodnot snímačů a aktivaci oznámení, když je místnost prázdná, a teplota i hladina oxidu uhličitého jsou v pohodlném rozsahu.

V tomto kurzu se dozvíte, jak můžete tato oznámení integrovat s Azure Logic Apps a odesílat e-maily, když je taková místnost dostupná. Správce kanceláře může tyto informace použít k tomu, aby zaměstnanci mohli rezervovat nejproduktivnější zasedací místnost.

V tomto kurzu se naučíte:

• Integrace událostí s Azure Event Gridem
• Upozorněte události pomocí Logic Apps.

Požadavky

V tomto kurzu se předpokládá, že máte nakonfigurované a zřízené vaše prostředí Azure Digital Twins. Než budete pokračovat, ujistěte se, že máte:

• Účet Azure.
• Instance služby Digital Twins spuštěná.
• Ukázky Digital Twins C# byly staženy a extrahovány na vašem pracovním počítači.
• .NET Core SDK verze 2.1.403 nebo novější na vývojovém počítači pro spuštění ukázky. Spuštěním dotnet --version ověřte, že je nainstalovaná správná verze.
• Účet Office 365 k odesílání e-mailů s oznámeními.

Návod

Pokud zřizujete novou instanci, použijte jedinečný název instance Služby Digital Twins.

Integrace událostí s Event Gridem

V této části nastavíte Event Grid tak, aby shromažďovala události z vaší instance Azure Digital Twins a přesměrovávala je na obslužnou rutinu událostí, jako je Logic Apps.

Vytvořit téma pro Event Grid

Téma event gridu poskytuje rozhraní pro směrování událostí generovaných uživatelem definovanou funkcí.

1. Přihlaste se do Azure Portalu.

2. V levém podokně vyberte Vytvořit prostředek.

3. Vyhledejte a vyberte téma Event Grid. Vyberte Vytvořit.

4. Zadejte Název tématu Event Grid a vyberte Subscription. Vyberte skupinu prostředků , kterou jste použili nebo vytvořili pro instanci služby Digital Twins, a umístění. Vyberte Vytvořit.

   

5. Přejděte k tématu událostní mřížky ve skupině prostředků, vyberte Přehleda zkopírujte hodnotu Koncový bod tématu do dočasného souboru. Tuto adresu URL budete potřebovat v další části.

6. Vyberte Přístupové klíčea zkopírujte Klíč 1 a Klíč 2 do dočasného souboru. Tyto hodnoty budete potřebovat k vytvoření koncového bodu v další části.

   

Vytvořte koncový bod pro téma gridu událostí

1. V příkazovém okně se ujistěte, že jste ve složce occupancy-quickstart\src ukázkové aplikace Digital Twins.

2. Otevřete soubor actions\createEndpoints.yaml v editoru Visual Studio Code. Ujistěte se, že obsahuje následující obsah:

   - type: EventGrid
     eventTypes:
     - SensorChange
     - SpaceChange
     - TopologyOperation
     - UdfCustom
     connectionString: <Primary connection string for your Event Grid>
     secondaryConnectionString: <Secondary connection string for your Event Grid>
     path: <Event Grid Topic Name without https:// and /api/events, e.g. eventgridname.region.eventgrid.azure.net>
   

3. Nahraďte zástupný symbol <Primary connection string for your Event Grid> hodnotou Klíč 1.

4. Nahraďte zástupný symbol <Secondary connection string for your Event Grid> hodnotou Key 2.

5. Nahraďte zástupný symbol pro cestu cestou k tématu Event Grid. Tuto cestu získáte tak, že odeberete https:// a na konci umístěné cesty prostředků z adresy URL koncového bodu tématu . Měl by vypadat podobně jako tento formát: yourEventGridName.yourLocation.eventgrid.azure.net.

   Důležité

   Zadejte všechny hodnoty bez uvozovek. Ujistěte se, že za dvojtečkami v souboru YAML je alespoň jeden znak mezery. Obsah souboru YAML můžete také ověřit pomocí libovolného online validátoru YAML, jako je tento nástroj.

6. Uložte a zavřete soubor. V příkazovém okně spusťte následující příkaz a po zobrazení výzvy se přihlaste.

   dotnet run CreateEndpoints
   

   Tento příkaz vytvoří koncový bod pro Event Grid.

   koncové body

Upozorňovat události pomocí Logic Apps

Službu Azure Logic Apps můžete použít k vytváření automatizovaných úloh pro události přijaté z jiných služeb. V této části nastavíte Logic Apps tak, aby vytvářela e-mailová oznámení pro události směrované z prostorových senzorů pomocí tématu event gridu.

1. V levém podokně portálu Azure vyberte Vytvořit prostředek.

2. Vyhledejte a vyberte nový prostředek Logic App. Vyberte Vytvořit.

3. Zadejte Název pro svůj prostředek Logic App, a poté vyberte své předplatné, skupinu prostředků a umístění . Vyberte Vytvořit.

   

4. Po nasazení otevřete prostředek Logic Apps a otevřete podokno návrháře aplikací logiky.

5. Vyberte Když dojde k události prostředku Event Gridu trigger. Rozbalte možnost Azure Event Grid a po zobrazení výzvy se přihlaste ke svému tenantovi pomocí svého účtu Azure. Pokud se zobrazí výzva, vyberte Povolit přístup pro váš prostředek Event Grid. Zvolte Pokračovat.

6. V okně Když dojde k události prostředku:

   a. Vyberte předplatné, které jste použili k vytvoření tématu event gridu.

   b) Vyberte Microsoft.EventGrid.Topics pro typ prostředku.

   c. V rozevíracím seznamu vyberte prostředek Event Grid s názvem prostředku .

   Podokno návrháře Logic Apps

7. Vyberte tlačítko Nový krok.

8. V okně Zvolte akci:

   a. Vyhledejte frázi parse jsona vyberte akci Parsovat JSON.

   b) V poli Obsah vyberte Tělo ze seznamu Dynamický obsah.

   c. Vyberte Použít ukázkovou datovou část k vygenerování schématu. Vložte následující JSON payload a poté vyberte Hotovo.

   {
   "id": "32162f00-a8f1-4d37-aee2-9312aabba0fd",
   "subject": "UdfCustom",
   "data": {
     "TopologyObjectId": "20efd3a8-34cb-4d96-a502-e02bffdabb14",
     "ResourceType": "Space",
     "Payload": "\"Air quality is poor.\"",
     "CorrelationId": "32162f00-a8f1-4d37-aee2-9312aabba0fd"
   },
   "eventType": "UdfCustom",
   "eventTime": "0001-01-01T00:00:00Z",
   "dataVersion": "1.0",
   "metadataVersion": "1",
   "topic": "/subscriptions/a382ee71-b48e-4382-b6be-eec7540cf271/resourceGroups/HOL/providers/Microsoft.EventGrid/topics/DigitalTwinEventGrid"
   }
   

   Tato datová část má fiktivní hodnoty. Logic Apps používá tuto ukázkovou datovou část k vygenerování schématu.

   Okno analýzy JSON pro Službu Event Grid

9. Vyberte tlačítko Nový krok.

10. V okně Zvolte akci:

    a. Vyberte Podmínka > nebo vyhledejte Podmínku ze seznamu Akcí.

    b) V prvním Zvolte hodnotu textovém poli, vyberte eventType ze seznamu Dynamický obsah pro okno Parse JSON.

    c. Do druhého Zvolte hodnotu textové pole zadejte UdfCustom.

    

11. V okně Pokud je pravda:

    a. Vyberte Přidat akcia vyberte Office 365 Outlook.

    b) V seznamu Akce vyberte Odeslat e-mail (V2). Vyberte Přihlásit se a použijte přihlašovací údaje k vašemu e-mailovému účtu. Pokud budete vyzváni, vyberte Povolit přístup.

    c. V poli až zadejte své ID e-mailu, abyste dostávali oznámení. Do Předmětzadejte text Oznámení služby Digital Twins o nízké kvalitě ovzduší v prostoru. Potom v seznamu Dynamický obsah vyberte TopologyObjectId pro Parsovat JSON.

    d. V části Tělo ve stejném okně zadejte text podobný následujícímu: Špatná kvalita vzduchu byla zjištěna v místnosti, a teplota musí být upravena. Nebojte se rozvést pomocí prvků ze seznamu Dynamický obsah .

    

12. Vyberte tlačítko Uložit v horní části podokna návrhář logické aplikace.

13. Nezapomeňte simulovat data ze snímačů přechodem do složky zařízení-připojení v ukázce Digital Twins v příkazovém okně a spuštěním dotnet run.

Během několika minut byste měli začít dostávat e-mailová oznámení z tohoto prostředku Logic Apps.

Pokud chcete přestat přijímat tyto e-maily, přejděte na portálu k prostředku Logic Apps a vyberte podokno Přehled. Vyberte Zakázat.

Uklidit zdroje

Pokud v tuto chvíli chcete zastavit zkoumání služby Azure Digital Twins, můžete odstranit prostředky vytvořené v tomto kurzu:

1. V nabídce vlevo na Azure portalvyberte Všechny prostředky, vyberte skupinu prostředků Digital Twins a vyberte Odstranit.

   Návod

   Pokud jste měli potíže s odstraněním instance Digital Twins, byla nasazena aktualizace služby s opravou. Zkuste znovu odstranit svou instanci.

2. V případě potřeby odstraňte ukázkové aplikace na pracovním počítači.

Další kroky

Pokud chcete zjistit, jak vizualizovat data snímačů, analyzovat trendy a odhalit anomálie, přejděte k dalšímu kurzu:

kurz : Vizualizace a analýza událostí z prostorů služby Azure Digital Twins pomocí služby Time Series Insights

Další informace o grafech prostorové inteligence a objektových modelech v Azure Digital Twins:

Pochopení objektových modelů digitálních dvojčat a grafu prostorové inteligence