教程：创建和部署店内分析应用程序模板

若要生成端到端解决方案，请使用 IoT Central 店内分析签出 应用程序模板。 此模板允许通过各种传感器设备连接到和监视商店的环境。 这些设备生成遥测数据，可以转换为业务见解，以帮助降低运营成本并为客户创造出色的体验。

本教程中，您将学习如何：

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

先决条件

若要完成本教程，需要在本地计算机上安装 dmr-client 命令行工具：

dotnet tool install --global Microsoft.IoT.ModelsRepository.CommandLine --version 1.0.0-beta.9

应用程序体系结构

对于许多零售商来说，环境条件是区分其商店与竞争对手商店的关键方式。 最成功的零售商尽一切努力在其商店内保持愉快的条件，以方便客户。

应用程序模板附带一组设备模板，并使用一组模拟设备填充仪表板：

如前面的应用程序体系结构图所示，可以使用应用程序模板来：

• （1） 将各种 IoT 传感器连接到 IoT Central 应用程序实例。

  IoT 解决方案从一组传感器开始，这些传感器从零售店环境中捕获有意义的信号。 体系结构图最左侧的各种图标表示传感器。

• （2） 监视和管理环境中的传感器网络和任何网关设备的运行状况。

  许多 IoT 传感器可以直接将原始信号馈送到云或靠近它们的网关设备。 网关设备先在边缘聚合数据，然后再向 IoT Central 应用程序发送摘要见解。 网关设备还负责将命令和控制作中继到传感器设备（如果适用）。

• （3） 创建自定义规则，这些规则使用商店中的环境条件来触发商店经理的警报。

  Azure IoT Central 应用程序从零售店环境中的各种 IoT 传感器和网关设备引入数据，然后生成一组有意义的见解。

  Azure IoT Central 还为商店运营商提供了定制的体验，允许他们远程监视和管理基础结构设备。

• （4） 将商店内的环境条件转换为商店团队可用于改善客户体验的见解。

  可以在解决方案中配置 Azure IoT Central 应用程序，以将原始见解或聚合见解导出到一组 Azure 平台即服务（PaaS）服务。 在将数据导入业务应用程序之前，PaaS 服务可以执行数据操作并丰富这些见解。

• （5） 将聚合见解导出到现有或新的业务应用程序中，以便向零售人员提供有用且及时的信息。

  IoT 数据可为零售环境中部署的不同类型的业务应用程序提供支持。 零售店经理或员工可以使用这些应用程序可视化业务见解并实时执行有意义的作。 了解如何 在从 Azure IoT Central 导出数据 中生成实时 Power BI 仪表板，并在 Power BI 教程中直观显示见解。

创建店内分析应用程序

若要创建 IoT Central 应用程序，请执行以下作：

1. 导航到 Azure 门户中的 “创建 IoT Central 应用程序 ”页。 如果出现提示，请使用 Azure 帐户登录。

2. 输入以下信息：

   字段	Description
   Subscription	要使用的 Azure 订阅。
   资源组	要使用的资源组。 可以创建新的资源组或使用现有资源组。
   资源名称	有效的 Azure 资源名称。
   应用程序 URL	应用程序的 URL 子域。 IoT Central 应用程序的 URL 如下所示 https://yoursubdomain.azureiotcentral.com。
   Template	店内分析 - 结帐
   区域	要使用的 Azure 区域。
   定价计划	要使用的定价计划。

3. 选择“查看 + 创建”。 然后选择“创建”。

应用准备就绪后，可以从 Azure 门户导航到它：

若要了解详细信息，请参阅 创建 Azure IoT Central 应用程序。

浏览应用程序

以下部分介绍应用程序的主要功能。

自定义应用程序设置

可以更改多个设置以自定义应用程序中的用户体验。 使用自定义主题可以设置应用程序浏览器颜色、浏览器图标和显示在 masthead 中的应用程序徽标。

若要创建自定义主题，请使用示例图像自定义应用程序。 从 GitHub 下载四个 Contoso 示例映像 。

创建自定义主题：

1. 在左窗格中，选择 “自定义 > 外观”。

2. 若要更改 masthead 徽标，请选择“ 更改”，然后选择要上传 contoso_wht_mast.png 图像。 （可选）输入 徽标替换文字的值。

3. 若要更改浏览器图标，请选择“ 更改”，然后选择要显示在浏览器选项卡上 的contoso_favicon.png 图像。

4. 通过添加 HTML 十六进制颜色代码替换默认 浏览器颜色 ：

   • 对于 Header，请输入 #008575。
   • 对于 Accent，请输入 #A1F3EA。

5. 选择“保存”。 保存更改后，应用程序将更新浏览器颜色、masthead 中的徽标和浏览器图标。

若要更新显示在 Azure IoT Central 应用站点的“我的应用”页上的应用程序磁贴上的应用程序映像：

1. 选择 “应用程序 > 管理”。

2. 选择更改，然后选择contoso_main_lg.png图像作为应用程序映像进行上传。

3. 选择“保存”。

创建设备模板

使用设备模板可以配置和管理设备。 可以生成自定义模板、导入现有模板文件，或从精选设备模板列表中导入模板。 创建和自定义设备模板后，使用它将真实设备连接到应用程序。

（可选）可以使用设备模板生成模拟设备进行测试。

店内分析 - 签出应用程序模板具有多个预安装的设备模板。 RuuviTag 设备模板不包含在“店内分析 - 结帐”应用程序模板中。

在本部分中，将 RuuviTag 传感器的设备模板添加到应用程序。 为此，做以下事情：

1. 若要从模型存储库下载 RuuviTag 设备模板的副本，请运行以下命令：

   dmr-client export --dtmi "dtmi:rigado:RuuviTag;2" --repo https://raw.githubusercontent.com/Azure/iot-plugandplay-models/main > ruuvitag.json
   

2. 在左窗格中，选择 “设备模板”。

3. 选择 “+ 新建 ”以创建新的设备模板。

4. 选择 IoT 设备 磁贴，然后选择“ 下一步：自定义”。

5. 在 “自定义 ”页上，输入 RuuviTag 作为设备模板名称。

6. 选择下一步: 审查。

7. 选择 创建。

8. 选择“导入模型”磁贴。 然后浏览并导入您之前下载的 ruuvitag.json 文件。

9. 导入完成后，选择“ 发布 ”以发布设备模板。

10. 在左窗格中，选择 “设备模板”。

    该页显示应用程序模板中的所有设备模板和刚添加的 RuuviTag 设备模板。

自定义设备模板

可以通过三种方式自定义应用程序中的设备模板：

• 通过更改设备功能来自定义设备中的本机内置界面。

  例如，使用温度传感器，可以更改详细信息，例如显示名称和度量单位。

• 通过添加云属性自定义设备模板。

  云属性是 Azure IoT Central 应用程序创建、存储和与设备关联的自定义数据。 云属性的示例包括：

  • 计算值。
  • 元数据信息，例如您要与一组设备关联的位置。

• 通过生成自定义视图自定义设备模板。

  视图为操作员提供了一种可视化设备的遥测和元数据的方法，例如设备指标和运行状况。

在本部分中，使用前两种方法自定义 RuuviTag 传感器的设备模板。

自定义 RuuviTag 设备模板的内置接口：

1. 在左窗格中，选择 “设备模板”。

2. 选择 RuuviTag。

3. 隐藏左窗格。 模板的摘要视图显示设备功能。

   

4. 在 RuuviTag 设备模板菜单中选择 RuuviTag 模型。

5. 在功能列表中，滚动查看 RelativeHumidity 遥测类型。 它是具有可编辑显示名称值为RelativeHumidity的行项。

在以下步骤中，自定义 RuuviTag 传感器的 RelativeHumidity 遥测类型。 （可选）可以自定义一些其他遥测类型。

对于 RelativeHumidity 遥测类型，请进行以下更改：

1. 将 RelativeHumidity 中的显示名称值更新为自定义值，例如“湿度”。

2. 将 语义类型 选项从 相对湿度 更改为 湿度。

   （可选）在扩展的架构视图中为湿度遥测类型设置架构值。 通过设置架构值，可以为传感器跟踪的数据创建详细的验证要求。例如，可以为指定的接口设置最小和最大作范围值。

3. 选择 保存 以保存更改。

若要将云属性添加到应用程序中的设备模板，请执行以下作：

1. 选择 “添加功能”。

2. 对于 显示名称，请输入 位置。

   此值是属性的友好名称，会自动复制到 Name。 可以使用复制的值或更改该值。

3. 对于 功能类型，请选择 “云属性”。

4. 选择 “展开”。

5. 在 “架构 ”下拉列表中，选择“ 字符串”。

   使用此选项，可以根据模板将位置名称与任何设备相关联。 例如，可以将商店中的命名区域与每个设备相关联。

6. 将 最小长度 设置为 2。

7. 将 剪裁空格 设置为 开启。

8. 选择 “保存” 以保存自定义云属性。

9. 选择发布。

   发布设备模板会使更新对应用程序操作员可见。 发布模板后，使用它生成模拟设备以进行测试或将实际设备连接到应用程序。 如果已将设备连接到应用程序，则发布自定义模板会将更改推送到设备。

添加设备

创建和自定义设备模板后，可以添加设备。 在本教程中，你将使用以下一组模拟设备来生成应用程序：

• 一个 Rigado C500 网关。
• 两个 RuuviTag 传感器。
• 占用传感器。 此模拟传感器包含在应用程序模板中，因此无需创建它。

若要将模拟的 Rigado Cascade 500 网关设备添加到应用程序，请执行以下作：

1. 在左窗格中，选择 “设备”。

2. 在可用设备模板列表中选择 C500 ，然后选择“ 新建”。

3. 输入 C500 网关 作为设备名称和 网关-001 作为设备 ID。

4. 确保 C500 是所选设备模板，然后将 “模拟此设备” 设置为 “是”。

5. 选择 创建。 应用程序现在包含模拟的 Rigado Cascade 500 网关设备。

若要将模拟的 RuuviTag 传感器设备添加到应用程序，请执行以下作：

1. 在左窗格中，选择 “设备”。

2. 在可用设备模板列表中选择 RuuviTag ，然后选择“ 新建”。

3. 输入 RuuviTag 001 作为设备名称和 ruuvitag-001 作为设备 ID。

4. 请确保 RuuviTag 是所选设备模板，然后将 “模拟此设备” 设置为 “是”。

5. 选择 创建。 应用程序现在包含模拟的 RuuviTag 传感器设备。

重复上述步骤，将第二个模拟的 RuuviTag 传感器设备添加到应用程序。 输入 RuuviTag 002 作为设备名称， 将 ruuvitag-002 输入为设备 ID。

将两个 RuuviTag 传感器和占用率检测设备连接到网关设备：

1. 在左窗格中，选择 “设备”。

2. 在设备列表中，选择《RuuviTag 001》、《RuuviTag 002》和《占用》。 然后在命令栏中，选择“附加到网关”。

3. 在 “附加到网关 ”窗格中，选择 C500 作为设备模板，选择 C500 - 网关 作为设备。 然后选择 “附加”。

如果导航到 C500 - 网关 设备并选择“ 下游设备 ”选项卡，现在会看到附加到网关的三台设备。

添加规则和动作

在通过使用传感器监控条件的 Azure IoT Central 应用程序中，可以创建规则，以便在某些条件满足时运行操作。

规则与设备模板和一个或多个设备相关联，它包含必须基于设备遥测或事件满足的条件。 规则还具有一个或多个关联的动作。 这些操作可能包括发送电子邮件通知，或触发 Webhook 操作以将数据发送到其他服务。 店内分析 - 签出应用程序模板包括应用程序中设备的一些预定义规则。

在本部分中，将创建一个新规则，用于检查基于 RuuviTag 传感器遥测的最大相对湿度级别。 向规则添加一个动作，以便在湿度超过最大值时，应用程序发送电子邮件通知。

若要创建规则，请执行以下步骤：

1. 在左窗格中，选择“ 规则”。

2. 选择“新建”。

3. 输入 湿度级别 作为规则的名称。

4. 对于 设备模板，请选择 RuuviTag 设备模板。

   定义的规则适用于基于该模板的所有传感器。 （可选）可以创建一个筛选器，该筛选器将规则应用于传感器的已定义子集。

5. 对于 遥测，请选择 相对湿度。 这是你在前面的步骤中自定义的设备功能。

6. 对于 运算符，请选择 “大于”。

7. 对于 “值”，请输入环境的典型上限室内湿度级别（例如 65）。

   当任何 RuuviTag 传感器中的相对湿度超过该值时，此条件适用。 可能需要根据环境中的正常湿度范围来上下调整值。

如果要向规则添加操作，可以按以下步骤操作：

1. 选择 “电子邮件”。

2. 对于操作的友好“显示名称”，请输入“高湿度通知”。

3. 对于 “To”，请输入与帐户关联的电子邮件地址。

   如果您使用其他电子邮件地址，该电子邮件地址必须属于已添加到应用程序的用户。 用户还需要至少登录和注销一次。

4. （可选）输入要包含在电子邮件文本中的备注。

5. 选择 “完成 ”以完成作。

6. 选择 “保存 ”以保存并激活新规则。

   几分钟内，指定的电子邮件帐户应开始接收邮件。 每当传感器指示湿度级别超出条件中的值时，应用程序都会发送电子邮件。

清理资源

如果不打算完成任何进一步的 IoT Central 快速入门或教程，可以删除 IoT Central 应用程序：

1. 在 IoT Central 应用程序中，导航到 应用程序 > 管理。
2. 选择“删除”，然后确认操作。

后续步骤