Tutorial: Receba notificações dos seus espaços Azure Digital Twins utilizando Apps Lógicas

Importante

Foi lançada uma nova versão do serviço Azure Digital Twins. À luz das capacidades expandidas do novo serviço, o serviço original Azure Digital Twins (descrito neste conjunto de documentação) foi retirado.

Para ver a documentação do novo serviço, visite a Documentação ativa da Azure Digital Twins.

Depois de implementar a sua instância Azure Digital Twins, fornecendo os seus espaços e implementando funções personalizadas para monitorizar condições específicas, pode notificar o seu administrador de escritório por e-mail quando as condições monitorizadas ocorrerem.

No primeiro tutorial, configuraste o gráfico espacial de um edifício imaginário. Uma sala no edifício contém sensores para movimento, dióxido de carbono e temperatura. No segundo tutorial, adiscou o seu gráfico e uma função definida pelo utilizador para monitorizar estes valores do sensor e desencadear notificações quando a sala está vazia, e a temperatura e o dióxido de carbono estão numa gama confortável.

Este tutorial mostra-lhe como pode integrar essas notificações no Azure Logic Apps para enviar e-mails quando uma divisão que cumpra estes requisitos esteja disponível. Os administradores dos escritórios podem utilizar estas informações para ajudar os funcionários a reservar a sala de reuniões mais produtiva.

Neste tutorial, ficará a saber como:

• Integrar eventos com Azure Event Grid.
• Notifique eventos com Aplicações Lógicas.

Pré-requisitos

Neste tutorial, parte-se do princípio de que configurou e aprovisionou a sua configuração do Azure Digital Twins. Antes de avançar, confirme que tem:

• Uma conta de Azure.
• Uma instância do Digital Twins em execução.
• As amostras Digital Twins C# descarregadas e extraídas na sua máquina de trabalho.
• .NET Core SDK versão 2.1.403 ou posteriormente na sua máquina de desenvolvimento para executar a amostra. Corra dotnet --version para verificar se a versão certa está instalada.
• Uma conta Office 365 para enviar e-mails de notificação.

Dica

Use um nome único de instância digital gémeos se estiver a providenciar um novo exemplo.

Integrar eventos com o Event Grid

Nesta secção, você configura a Grade de Eventos para recolher eventos da sua instância Azure Digital Twins, e redirecioná-los para um manipulador de eventos como As Aplicações Lógicas.

Criar um tópico de grelha de eventos

Um tópico de grelha de eventos fornece uma interface para encaminhar os eventos gerados pela função definida pelo utilizador.

1. Inicie sessão no portal do Azure.

2. No painel esquerdo, selecione Criar um recurso.

3. Procure e selecione Event Grid Topic (Tópico do Event Grid). Selecione Criar.

4. Introduza Name (Nome) do tópico do Event Grid e escolha Subscrição. Selecione o grupo de Recursos que usou ou criou para a sua instância Digital Twins e a Localização. Selecione Criar.

   

5. Navegue no tópico da grelha de eventos a partir do seu grupo de recursos, selecione Overview e copie o valor do Ponto Final tópico para um ficheiro temporário. Vai precisar desta URL na próxima secção.

6. Selecione as teclas de acesso e copie a chave 1 e a chave 2 para um ficheiro temporário. Vai precisar destes valores para criar o ponto final na secção seguinte.

   

Crie um ponto final para o tópico da grelha de eventos

1. Na janela de comando, certifique-se de que está na pasta de arranque rápido da amostra dos Gémeos Digitais.

2. Abra o ficheiro actions\createEndpoints.yaml no editor do Visual Studio Code. Verifique se os conteúdos seguintes estão presentes:

   - 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. Substitua o espaço reservado <Primary connection string for your Event Grid> pelo valor da chave 1.

4. Substitua o espaço reservado <Secondary connection string for your Event Grid> pelo valor da chave 2.

5. Substitua o espaço reservado para o caminho com o caminho do tópico da grelha do evento. Obtenha este caminho removendo https:// e os caminhos de recursos de fuga do URL de ponto final tópico. Deverá ser semelhante ao formato NomedoEventGrid.asuaLocalização.eventgrid.azure.net.

   Importante

   Introduza todos os valores, sem aspas. Certifique-se de que há pelo menos um personagem espacial após os cólons no ficheiro YAML. Também pode validar o conteúdo do seu ficheiro YAML utilizando qualquer validador YAML online, como esta ferramenta.

6. Guarde e feche o ficheiro. Na janela de comandos, execute o comando seguinte e inicie sessão quando lhe for pedido.

   dotnet run CreateEndpoints
   

   Este comando cria o ponto final para a Grade de Eventos.

   

Notifique eventos com aplicações lógicas

Pode utilizar o serviço Azure Logic Apps para criar tarefas automatizadas para eventos recebidos de outros serviços. Nesta secção, cria Aplicações Lógicas para criar notificações de email para eventos encaminhados a partir dos seus sensores espaciais, com a ajuda de um tópico de grelha de eventos.

1. No painel esquerdo do portal do Azure, selecione Criar um recurso.

2. Procure e selecione o recurso Logic App. Selecione Criar.

3. Introduza um Nome para o seu recurso De aplicação lógica e, em seguida, selecione a sua Subscrição, Grupo de Recursos e Localização. Selecione Criar.

   

4. Abra o seu recurso De Aplicações Lógicas quando estiver implantado e, em seguida, abra o painel de designers de aplicativos Logic .

5. Selecione o detonador de recursos de grade de evento quando ocorre um evento de recurso de grade de evento . Expanda a opção Azure Event Grid e inscreva-se no seu inquilino com a sua conta Azure quando solicitado. Selecione Permitir o acesso ao seu recurso 'Grelha de Evento' se solicitado. Selecione Continuar.

6. Na janela Quando ocorre um evento de recurso :

   a. Selecione a Subscrição que usou para criar o tópico da grelha de eventos.

   b. Selecione Microsoft.EventGrid.Topics for Resource Type.

   c. Selecione o seu recurso 'Grelha de Evento' na caixa de entrega para o Nome de Recursos.

   

7. Selecione o botão novo passo .

8. Na janela de ação Escolher :

   a. Procure a expressão parse json (analisar json) e selecione a ação Parse JSON.

   b. No campo Conteúdo , selecione 'Corpo' na lista de conteúdos Dynamic .

   c. Selecione Utilizar o payload de exemplo para gerar esquema. Cole a carga útil JSON seguinte e, em seguida, selecione Fazer.

   {
   "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"
   }
   

   Este payload tem valores fictícios. A Logic Apps utiliza esta carga útil da amostra para gerar um esquema.

   

9. Selecione o botão novo passo .

10. Na janela de ação Escolher :

    a. Selecione Condição de Controlo > ou Condição de pesquisa da lista de Ações.

    b. Na primeira Escolha uma caixa de texto de valor , selecione eventType da lista de conteúdos Dynamic para a janela Parse JSON .

    c. Na segunda Escolha uma caixa de texto de valor, insira UdfCustom.

    

11. Na janela Se verdadeira :

    a. Selecione Adicionar uma ação e selecione Office 365 Outlook.

    b. Na lista de Ações , selecione Enviar um e-mail (V2). Selecione Iniciar sôms e use as credenciais da sua conta de e-mail. Selecione Permita o acesso se solicitado.

    c. Na caixa To (Para), introduza o ID do seu e-mail para receber notificações. Em Assunto, insira o texto Digital Twins notificação por má qualidade do ar no espaço. Em seguida, selecione TopologyObjectId da lista de conteúdos Dinâmicos para Parse JSON.

    d. Sob o Corpo na mesma janela, introduza texto semelhante ao seguinte: Má qualidade do ar detetada numa sala e temperatura precisa de ser ajustada. Sinta-se livre para elaborar usando elementos da lista de conteúdos Dynamic .

    

12. Selecione o botão Guardar no topo do painel de designers de aplicações Logic .

13. Certifique-se de que simula os dados do sensor navegando na pasta de conectividade do dispositivo da amostra Dos Gémeos Digitais numa janela de comando e em funcionamento dotnet run.

Em poucos minutos, deverá começar a receber notificações por e-mail deste recurso Logic Apps.

Para parar de receber estes e-mails, aceda ao recurso De Aplicações Lógicas no portal e selecione o painel de visão geral. Selecione Desativar.

Limpar os recursos

Se quiser parar de explorar as Gémeas Digitais Azure neste momento, sinta-se livre para eliminar os recursos criados neste tutorial:

1. A partir do menu esquerdo no portal do Azure, selecione Todos os recursos, selecione o seu grupo de recursos Digital Twins e selecione Delete.

   Dica

   Se sentiu problemas em eliminar a sua instância Digital Twins, foi lançada uma atualização de serviço com a correção. Por favor, ressalta o seu caso.

2. Se necessário, elimine as aplicações de amostra na sua máquina de trabalho.

Passos seguintes

Para aprender a visualizar os dados do sensor, analisar tendências e detetar anomalias, vá ao próximo tutorial:

Tutorial: Visualize and analyze events from your Azure Digital Twins spaces using Time Series Insights (Tutorial: Visualizar e analisar eventos dos seus espaços do Azure Digital Twins com o Time Series Insights)

Você também pode aprender mais sobre os gráficos de inteligência espacial e modelos de objetos em Azure Digital Twins:

Understanding Digital Twins object models and spatial intelligence graph (Compreender os modelos de objetos e o gráfico de inteligência espacial do Digital Twins)