通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure 数字孪生连接器与 Power Platform 和逻辑应用集成

  • 项目

可以使用 Azure 数字孪生 Power Platform连接器将 Azure 数字孪生集成到 Microsoft Power Platform 或 Azure逻辑应用流中。

该连接器是用于孪生、模型和查询操作的 Azure 数字孪生 数据平面 API 的包装器，它允许基础服务与 Microsoft Power Automate、 Microsoft Power Apps 和 Azure 逻辑应用通信。 该连接器为用户提供了一种连接其帐户并利用一组预生成操作来生成其应用和工作流的方法。

有关连接器的介绍（包括快速演示），请观看以下 IoT 演示视频：

还可以在博客文章 简化由 Azure 数字孪生提供支持的自动化工作流和应用的构建中完成基本演练。 有关连接器的详细信息，包括连接器操作及其参数的完整列表，请参阅 Azure 数字孪生连接器参考文档。

先决条件

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。 使用帐户登录到Azure 门户。

若要在本文中使用 Azure 数字孪生，你需要有一个 Azure 数字孪生实例，还需具备使用它所必需的权限。 如果你已设置了一个 Azure 数字孪生实例，则可以使用该实例并跳到下一部分。 如果没有，请按照设置实例和身份验证中的说明操作。 该说明中包含可帮助你验证是否已成功完成每个步骤的信息。

设置实例后，记下实例的主机名。 可以在 Azure 门户中找到该主机名。

最后，需要设置要使用连接器的任何 Power Platform 服务。

设置连接器

对于 Power Automate 和 Power Apps，请先设置连接，然后再创建流。 按照以下步骤在 Power Automate 和 Power Apps 中添加连接。

  1. 在 Power Automate 中 (左侧导航菜单中选择 “连接” ，它位于 “数据 ”标题) 下。 在“连接”页上，选择“ + 新建连接”。
  2. 搜索 “Azure 数字孪生”，然后选择“ Azure 数字孪生 (预览版) 连接器。
  3. 如果连接器要求提供 ADT 实例名称，请输入 实例的主机名。
  4. 在请求完成连接设置时输入身份验证详细信息。
  5. 若要验证是否已创建连接，请在“连接”页上查找它。 Power Automate 的屏幕截图，其中显示了“连接”页上的 Azure 数字孪生连接。

对于逻辑应用，在下 一部分创建流 时，可以使用 Azure 数字孪生内置连接。 有关内置连接器的详细信息，请参阅 Azure 逻辑应用中的内置连接器。

创建流

可以将 Azure 数字孪生合并到 Power Automate 流、逻辑应用流或 Power Apps 应用程序中。 使用 Azure 数字孪生连接器和 700 多个其他 Power Platform 连接器，可以将其他系统中的数据引入孪生体，或响应系统事件。

按照以下步骤在 Power Automate 中使用连接器创建示例流。

  1. 在 Power Automate 中，从左侧导航菜单中选择“ 我的流 ”。 选择“ + 新建流 ”和 “即时云流”。
  2. 输入 流名称 ，然后从触发器列表中选择 “手动触发流 ”。 创建 流。
  3. 向流添加一个步骤，并搜索 Azure 数字孪生 以查找连接。 选择 Azure 数字孪生连接。 Power Automate 的屏幕截图，其中显示了新流中的 Azure 数字孪生连接器。
  4. 你将看到连接器可用的所有 操作 的列表。 选择其中一个来与 Azure 数字孪生 API 交互。 Power Automate 的屏幕截图，其中显示了 Azure 数字孪生连接器的所有操作。
  5. 可以继续编辑或向工作流添加更多步骤，使用其他连接器构建集成方案。 Power Automate 的屏幕截图，其中显示了流中 Azure 数字孪生连接器的“按 ID 获取孪生”操作。

按照以下步骤在 Power Apps 中使用连接器创建示例流。

  1. 在 Power Apps 中，从左侧导航菜单中选择“ + 创建 ”。 选择“ 空白应用 ”，并按照提示创建新应用。
  2. 在应用生成器中，从左侧导航菜单中选择“ 数据 ”。 选择“ 添加数据 ”并搜索 “Azure 数字孪生 ”以查找数据连接。 选择 Azure 数字孪生连接。 Power Apps 的屏幕截图，其中显示了 Azure 数字孪生连接器作为数据源。
  3. 现在，Azure 数字孪生连接器中的 操作 将作为函数在应用中使用。 Power Apps 的屏幕截图，其中显示了函数中使用的“按 ID 获取孪生体”操作。
  4. 可以继续构建可访问 Azure 数字孪生数据的应用程序。 有关生成 Power Apps 的详细信息，请参阅 在 Power Apps 中创建应用的概述。

按照以下步骤在逻辑应用中使用连接器创建示例流。

  1. 导航到Azure 门户中的逻辑应用。 从左侧导航菜单中选择“ 工作流 ”，然后选择“ + 添加”。 按照提示创建新工作流。
  2. 选择新流，然后输入 设计器。
  3. 将触发器添加到应用。
  4. 选择“ 选择操作 ”以从 Azure 数字孪生连接器添加操作。 在“Azure”选项卡上搜索“Azure数字孪生”以查找数据连接。 选择 Azure 数字孪生连接。 逻辑应用的屏幕截图，其中显示了 Azure 数字孪生连接器。
  5. 你将看到连接器可用的所有 操作 的列表。 选择其中一个来与 Azure 数字孪生 API 交互。
  6. 从 Azure 数字孪生连接器中选择操作后，系统会要求你输入身份验证详细信息以创建连接。
  7. 可以继续编辑或向工作流添加更多步骤，使用其他连接器构建集成方案。

限制和建议

下面是连接器的一些限制和使用它们的建议。

  • (某些连接器操作（如添加模型) ）需要以 开头 @的文本字符串形式的输入。 在这些情况下，请改用 来@@转义 @ 字符。 这将防止文本值被解释为 JSON 表达式。
  • 由于 Azure 数字孪生处理动态架构响应，因此应先分析从 API 收到的 JSON，然后再在应用程序中使用它。 例如，下面是一组在提取 dtId 值之前分析数据的调用： Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));。

后续步骤

有关 Power Platform 连接器的详细信息，包括如何在跨多个产品的工作流中使用它们，请参阅 Power Platform 和 Azure 逻辑应用连接器文档。