从 Azure 逻辑应用中的工作流连接到 Microsoft Dataverse

适用范围：Azure 逻辑应用（消耗型 + 标准型）

若要创建和运行在 Microsoft Dataverse 数据库中创建和管理行的自动化工作流，可以使用 Azure 逻辑应用和 Microsoft Dataverse 连接器。 这些工作流可以创建行、更新行，以及执行其他操作。 还可以从 Dataverse 数据库中获取信息，使输出可供工作流中的其他操作使用。 例如，在 Dataverse 数据库中添加、更新或删除行时，可以使用 Office 365 Outlook 连接器发送电子邮件。

本指南将演示如何创建在每次创建新的潜在顾客行时都创建任务行的工作流。

连接器参考

如需基于连接器的 Swagger 说明的技术信息，例如操作、限制和其他详细信息，请参阅托管连接器参考页。

先决条件

• Azure 帐户和订阅。 如果没有 Azure 订阅，请注册试用版 Azure 订阅。

• Dataverse Data Service 环境和数据库，这是组织在 Dataverse 数据库中存储、管理和共享业务数据的空间。 有关更多信息，请参见以下资源：

  • Learn：创建并管理 Dataverse 环境

  • Power Platform - 环境概述

• 有关消耗型或标准型逻辑应用工作流创建方法以及特定逻辑应用（你需要从中访问 Dataverse 数据库中的行）的基础知识。 若要使用 Dataverse 触发器，需要从空白工作流开始。 有关更多信息，请参见以下资源：

  • 创建示例“消耗”逻辑应用工作流

  • 创建示例标准逻辑应用工作流

添加 Dataverse 触发器

当你添加连接到服务或系统的触发器或操作时，如果没有现有连接或活动连接，Azure 逻辑应用会提示你提供连接信息，这些信息因连接类型而异，例如：

• 要用于连接的名称
• 帐户凭据
• 服务器或系统名称
• 一个连接字符串
• 要使用的身份验证类型

此示例使用的 Dataverse 触发器，它在添加、更新或删除行时启动工作流。

添加 Dataverse 操作

当你添加连接到服务或系统的触发器或操作时，如果没有现有连接或活动连接，Azure 逻辑应用会提示你提供连接信息，这些信息因连接类型而异，例如：

• 要用于连接的名称
• 帐户凭据
• 服务器或系统名称
• 一个连接字符串
• 要使用的身份验证类型

此示例使用向数据库添加新行的 Dataverse 操作。

测试工作流

若要测试和触发工作流，请遵循以下步骤：

基于筛选器返回行

对于返回行的操作（例如“列出行”操作），可使用基于指定筛选器返回行的 ODATA 查询。 例如，可将操作设置为仅返回活动帐户的行。 有关示例操作的详细信息，请参阅列出行。

基于排序顺序返回行

对于返回行的操作（例如“列出行”操作），可以使用一个按指定顺序（因操作返回的行而异）返回行的 ODATA 查询。 例如，可将操作设置为返回按帐户名称组织的行。 有关示例操作的详细信息，请参阅列出行。

字段数据类型

在触发器或操作中，字段值的数据类型必须与字段所需的数据类型匹配。 无论是手动输入值还是从动态内容列表中选择值，此要求都适用。

例如，假设有一个名为“任务”的表。 此表具有仅适用于该表的字段，而其他表具有自己的字段。 对于示例“任务”表，下表描述了一些示例字段类型以及这些字段的值所需的数据类型。

对于示例“任务”表，假设你使用“添加新行”操作来创建与其他实体行相关联的新行，特别是用户行和帐户行。 那么在此操作中，必须使用与相关属性的预期数据类型匹配的值来指定这些实体行的 ID 和查找类型。

• 该操作根据“所有者”属性（指定用户 ID）和“所有者类型”属性（指定 systemusers 查找类型），将新行与特定用户相关联。

• 该操作根据“相关”属性（指定行 ID）和“相关类型”属性（指定 accounts 查找类型），将新行与特定帐户相关联。

解决问题

来自多个环境的调用

Dataverse 连接器存储逻辑应用工作流的相关信息，这些工作流使用 Dataverse 数据库中的 callbackregistrations 实体获取和请求数据库实体变更通知。 如果你复制某个 Dataverse 组织，则还会复制任何 Webhook。 如果在禁用映射到组织的工作流之前复制组织，则任何复制的 Webhook 也会指向相同的逻辑应用工作流，后者随后会从多个组织获取通知。

若要停止不需要的通知，请按照以下步骤从发送这些通知的组织中删除 callbackregistrations 实体：

1. 确定要从中移除通知的 Dataverse 组织，并登录到该组织。

2. 在 Chrome 浏览器中，找到要删除的回调注册。

   1. 在以下 OData URI 上查看所有回调注册的泛型列表，以便你可以查看 callbackregistrations 实体内的数据：

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations：

      注意

      如果未返回任何值，表示你可能无权查看此实体类型，或者可能未登录到正确的组织。

   2. 请筛选触发实体的逻辑名称 entityname 以及与你的逻辑应用工作流（消息）匹配的通知事件。 每个事件类型都映射到消息整数，如下所示：

      事件类型	消息整数
      创建	1
      删除	2
      更新	3
      CreateOrUpdate	4
      CreateOrDelete	5
      UpdateOrDelete	6
      CreateOrUpdateOrDelete	7

      以下示例显示了如何为示例组织使用以下 OData URI 筛选名为 nov_validation 的实体上的 Create 通知：

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      注意

      如果同一个实体或事件存在多个触发器，则可以使用附加筛选器（例如 createdon 和 _owninguser_value 属性）来筛选列表。 所有者用户的名称将显示在 /api/data/v9.0/systemusers({id}) 下。

   3. 找到要删除的回调注册的 ID 后，执行以下步骤：

      1. 在 Chrome 浏览器中，打开“Chrome 开发人员工具”（键盘：F12）。

      2. 在窗口顶部，选择“控制台”选项卡。

      3. 在命令行提示符下，输入此命令，该命令将发送请求以删除指定的回调注册：

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         重要

         请确保从非统一的客户端界面 (UCI) 页面（例如，从 OData 或 API 响应页面本身）发出请求。 否则，app.js 文件中的逻辑可能会干扰此操作。

   4. 若要确认回调注册不再存在，请检查回调注册列表。

重复的“callbackregistrations”实体

在标准型逻辑应用工作流中，在实例重新分配或应用程序重启等特定条件下，Microsoft Dataverse 触发器会启动重复运行，这会在 Dataverse 数据库中创建重复的 callbackregistrations 实体。 如果编辑从 Dataverse 触发器开始的标准型工作流，请检查此 callbackregistrations 实体是否重复。 如果存在重复项，请手动删除重复 callbackregistrations 实体。

后续步骤

• 适用于 Azure 逻辑应用的托管连接器
• 适用于 Azure 逻辑应用的内置连接器
• 什么是 Azure 逻辑应用中的连接器