教程：使用逻辑应用从 Azure 数字孪生空间接收通知

项目
01/10/2020

重要

Azure 数字孪生服务的新版本已发布。鉴于新服务的扩展功能，本文档集中介绍的原始 Azure 数字孪生服务 (已停用) 。

若要查看新服务的文档，请访问活动的 Azure 数字孪生文档。

部署 Azure 数字孪生实例、预配空间并实现用于监视特定条件的自定义函数以后，即可在受监视的条件满足时通过电子邮件通知办公室主任。

在第一个教程中，你配置了一栋虚构大楼的空间图，其中一个房间包含用于移动、二氧化碳和温度的传感器。在第二个教程中，你预配了图形和一个用户定义函数，用于监视这些传感器值并在房间为空且温度和二氧化碳处于某个令人舒适的范围内时触发通知。

本教程介绍如何将这些通知与 Azure 逻辑应用集成，以便在此类房间可用时发送电子邮件。办公室主任可以根据此信息帮助员工预订工作效率最高的会议室。

在本教程中，你将了解如何执行以下操作：

将事件与 Azure 事件网格集成。
使用逻辑应用发出事件通知。

先决条件

本教程假定你已配置和预配 Azure 数字孪生设置。在继续操作之前，请确保已具备以下条件：

Azure 帐户。
一个正在运行的数字孪生实例。
在工作计算机上下载和提取的数字孪生 C# 示例。
在用于运行示例的开发计算机上安装的 .NET Core SDK 2.1.403 或更高版本。请运行 dotnet --version 以验证是否安装了正确的版本。
用于发送通知电子邮件的Office 365帐户。

提示

如果要预配新实例，请使用唯一的数字孪生实例名称。

将事件与事件网格集成

在此部分，请设置一个事件网格，以便从 Azure 数字孪生实例收集事件，然后将事件重定向到事件处理程序，例如逻辑应用。

创建事件网格主题

事件网格主题提供一个界面，用于路由用户定义的函数生成的事件。

登录 Azure 门户。
在左窗格中，选择“创建资源”。
搜索并选择“事件网格主题”。选择“创建”。
为事件网格主题输入一个“名称”，然后选择“订阅”。选择用于数字孪生实例的或者为其创建的“资源组”，然后选择“位置”。选择“创建”。
从资源组浏览到事件网格主题，选择“概览”，将“主题终结点”的值复制到某个临时文件。下一部分将需要此 URL。
选择“访问密钥”，将密钥 1 和密钥 2 复制到某个临时文件。在下一部分，将需要这些值来创建终结点。

为事件网格主题创建终结点

在命令窗口中，确保当前位置为数字孪生示例的 occupancy-quickstart\src 文件夹。

在 Visual Studio Code 编辑器中打开 actions\createEndpoints.yaml 文件。确保其包含以下内容：

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

将占位符 <Primary connection string for your Event Grid> 替换为密钥 1 的值。
将占位符 <Secondary connection string for your Event Grid> 替换为密钥 2 的值。
将路径的占位符替换为事件网格主题的路径。从主题终结点 URL 中删除 https:// 以及尾随的资源路径即可获取此路径。它看起来应该类似于此格式：yourEventGridName.yourLocation.eventgrid.azure.net。

重要

输入所有值，不带任何引号。在 YAML 文件中，请确保在冒号之后至少有一个空格字符。还可以使用任何联机 YAML 验证程序（如此工具）来验证 YAML 文件内容。
保存并关闭该文件。在命令窗口中，当出现提示时，请运行以下命令并登录。
```
dotnet run CreateEndpoints
```
此命令为事件网格创建终结点。

使用逻辑应用发出事件通知

可以通过 Azure 逻辑应用服务为从其他服务接收的事件创建自动化任务。在此部分，请设置逻辑应用，以便借助事件网格主题为从空间传感器路由的事件创建电子邮件通知。

在 Azure 门户的左窗格中，选择“创建资源”。
搜索并选择新的“逻辑应用”资源。选择“创建”。
为逻辑应用资源输入一个名称，然后选择你的订阅、资源组和位置。选择“创建”。
部署逻辑应用时打开逻辑应用资源，然后打开 “逻辑应用设计器 ”窗格。
选择“当事件网格资源事件发生时”触发器。展开“Azure 事件网格”选项，并在系统提示时使用 Azure 帐户登录到租户。如果系统提示，针对事件网格资源选择“允许访问”。选择“继续”。
在“当资源事件发生时”窗口中，执行以下操作：

a. 选择曾经用于创建事件网格主题的订阅。

b. 选择 Microsoft.EventGrid.Topics 作为资源类型。

c. 从资源名称对应的下拉框中选择事件网格资源。
选择“新步骤”按钮。

在“选择操作”窗口中，执行以下操作：

a. 搜索“分析 json”短语，然后选择“分析 JSON”操作。

b. 在“内容”字段的“动态内容”列表中选择“正文”。

c. 选择“使用示例有效负载生成架构”。粘贴以下 JSON 有效负载，然后选择“完成”。

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

此有效负载包含虚构值。逻辑应用使用此示例有效负载生成一个架构。

选择“新步骤”按钮。
在“选择操作”窗口中，执行以下操作：

a. 从“操作”列表中选择“控制>条件”或“搜索条件”。

b. 在第一个“选择值”文本框的“分析 JSON”窗口的“动态内容”列表中选择“eventType”。

c. 在第二个“选择值”文本框中输入“UdfCustom”。
在 If true 窗口中，执行以下操作：

a. 选择“添加操作”，然后选择“Office 365 Outlook”。

b. 从“操作”列表中选择“发送电子邮件 (V2)”。选择“登录”，使用电子邮件帐户凭据。如果系统提示，请选择“允许访问”。

c. 在“收件人”框中，输入用于接收通知的电子邮件 ID。在“主题”中输入文本“有关空间中空气质量差的数字孪生通知”，然后从分析 JSON 的“动态内容”列表中选择“TopologyObjectId”。

d. 在同一窗口中的正文下，输入类似于以下内容的文本： 在房间里检测到的空气质量差，需要调整温度。请根据需要使用“动态内容”列表中的元素进行详细阐述。
选择逻辑应用设计器窗格顶部的“保存”按钮。
确保模拟传感器数据，方法是：在命令窗口中浏览到数字孪生示例的 device-connectivity 文件夹，然后运行 dotnet run。