Power Automate

警告

模型驱动应用程序的协作控件将于 2024 年 5 月停用。 退休将分两个阶段进行,以确保平稳过渡。 下表详细介绍了停用过程时间线及其影响:

Timeframe 操作 影响
2024 年 2 月 将不再可从 AppSource 安装协作控件。 - 无法在 Power Apps 环境中部署协作控件。
- 现有安装不受影响。
2024 年 5 月 为控件提供支持的内部服务将停用。 - 控件将停止支持与 Microsoft 365 的集成,并将错误返回给用户。
通过控件生成和管理的数据不会受到影响。 有关详细信息,请参阅本文后面的表。

通过控件创建和管理的项目在服务停用后将继续存在。

控制 影响
审批 在“审批”控件中创建的审批将保留在“审批”应用中,但不再可在“审批”控件中访问。
Files 在“文件”控件中管理的文件将保留在 SharePoint 中,但不再可在“文件”控件中访问。
会议 在“会议”控件中创建的会议将保留在 Outlook 和 Teams 日历中,但不再可在“会议”控件中访问。
注意 在 Notes 控件中创建的备注将保留在 Dataverse 备注表中。
Tasks 在任务控件中创建的任务将保留在 Planner 中,但不再可在 Task 控件中访问。

建议从所有 Power Apps 解决方案中删除协作控件和协作连接器,并为即将停用的协作控件的用户做好准备。

Power Automate 可用于自动执行Collaboration Manager应用程序周围的工作流。 例如,创建新记录时自动创建任务。

协作控制连接器使开发人员能够通过 Microsoft Power Automate、Microsoft Power Apps 和 Azure 逻辑应用中自动化工作流中的触发器或操作来访问协作控制 API。 协作控件仅在 公共开发人员预览版中可用。

在此版本中,连接器使制造商能够设置触发器:

  1. 创建协作会话时。
  2. 创建或修改规划器任务时。

它还包括一组协作控制 API 和可通过流调用的任务。 连接器操作在工作流步骤选择中找到。 连接器本身可在具有可配置选项的自定义连接器中找到。 若要在解决方案中使用连接器,必须创建环境信任的Azure 应用来执行流。

创建Azure 应用

Microsoft Entra管理Azure 门户中,使用以下步骤以足够的权限登录到帐户,以将用户应用程序添加到环境:

  1. 在Azure 门户的主页中,选择“Microsoft Entra ID”。

    屏幕截图显示如何添加新的应用注册。

  2. 选择“ +添加 ”下拉列表,然后选择“ 应用注册”。

    显示如何添加新应用注册的屏幕截图。

  3. 在应用注册中,设置应用程序名称并将 Web 重定向 URI 添加到 https://global.consent.azure-apim.net/redirect

    显示如何注册应用程序的屏幕截图。

  4. 在“隐式授予和混合流”部分中,选择“访问令牌”和“ID 令牌”。

    屏幕截图显示了令牌和 ID 令牌。

  5. 在左窗格中选择“API 权限”,选择“ 添加权限”,然后搜索 “动态 CRM 权限”。

    显示如何添加权限的屏幕截图。

  6. 选择 Dynamics CRM 后,请确保在“权限”中选择“ user_impersonation ”。

    屏幕截图显示如何启用user_impersonation复选框。

  7. 在“证书 & 机密”页中,添加 “新建客户端密码 ”,并保存该值以供以后在设置连接器安全性时使用。

    屏幕截图显示如何复制新的机密值。

  8. 在“应用程序概述”页中,复制 “应用程序 (客户端) ID ”,并保存它以供以后在设置连接器安全性时使用。

    显示如何保存客户端 ID 的屏幕截图

现在,Azure 应用已全部设置,需要将其添加为环境中的用户应用程序。

将 Azure 应用添加到 Power Automate 环境

  1. 打开 Power Apps 门户,在右上角选择“设置”并打开管理员中心

    屏幕截图显示了 Power apps 界面。

  2. 在管理中心,从左窗格中选择“ 环境 ”,然后在要添加连接器应用的列表中选择你的环境。

    显示如何添加连接器应用的屏幕截图。

  3. 在“环境详细信息”页中,选择“ 设置”。

    屏幕截图显示如何选择设置。

  4. 在设置详细信息页中,选择 “用户 + 权限 ”部分,然后选择“ 应用程序用户”。

    显示应用程序用户链接的屏幕截图。

  5. 在“应用用户”页中,选择“ + 新建应用用户”。 此时会显示“创建新应用用户”窗口。

    显示新应用用户的屏幕截图。

  6. 选择“ + 添加应用”。

    显示如何创建新应用用户的屏幕截图。

  7. 从搜索框中选择你的应用,然后再次选择“添加”。

    屏幕截图显示如何从 Microsoft Entra ID 添加应用。

添加应用后,将业务单元和安全角色设置为连接器应用程序。 选择“ 创建 ”,你的应用将出现在列表中。 在环境中设置应用用户后,我们可以继续自定义连接器配置。

自定义连接器配置

  1. 打开 PowerApps 或 Power Automate,然后选择“ 自定义连接器 ”菜单。 为协作连接器选择 “编辑 ”。

    屏幕截图显示如何为自定义连接器菜单选择“编辑”。

  2. 在“常规信息”选项卡中,输入地址为 Dynamic 365 实例域的主机, (不带 https://) 。

    屏幕截图显示了“常规”信息。

  3. 在“安全性”选项卡中,输入以下输入:

    • 客户端密码:使用输入中保存的应用机密值。
    • 客户端 ID:Azure 应用 (客户端 ID) 。
    • 资源 URL:Dynamic 365 实例 (https://org.crm.dynamics.com/) 的 URL。
    • 范围:与具有 .default 后缀 () https://org.crm.dynamics.com/.default 的资源 URL 相同。

    屏幕截图显示了 Dynamic 365 实例。

  4. 选择“ 更新连接器 ”以保存更改并允许流建立连接。

    显示自定义连接器的屏幕截图。

如何调用连接器

触发器和操作是预定义的,可配置的输入和输出作为工作流步骤。 使用正确的输入和输出配置将工作流步骤添加到适当的工作流位置,以定义何时调用触发器或操作。

显示如何调用连接器的屏幕截图。

连接器支持的触发器和操作

流中支持以下触发器和操作:

  • 触发器

    1. 创建协作会话时。

      屏幕截图显示了创建的协作会话。

      范围: 限制的范围,哪些行可以触发流。

      运行方式: 使用调用程序连接的步骤的正在运行的用户。

    2. 创建或修改任务时。

      屏幕截图显示任务已创建或修改。

      默认情况下,触发器规划器任务处于禁用状态,不会触发。 若要启用它,租户管理员必须执行以下步骤:

      1. 在“Power Apps/协作控件/设置”路径下创建支持票证。
      2. 请求为协作连接器启用环境,并提供环境 URL (首选) 或组织 ID。
      3. 可以将以下示例文本添加到支持请求:“为协作连接器启用环境 URL url ”。
      4. 若要打开支持票证,请参阅 获取帮助 + 支持
  • 操作

    1. 开始协作会话

      显示如何开始协作会话的屏幕截图。

      此步骤操作为 Dataverse 业务实体创建新的协作会话:

      • 应用程序名称:例如,关联应用程序的名称可以是“贷款Collaboration Manager”或“关闭贷款审核Collaboration Manager”。
      • 协作根实体名称:例如, (表名) 的应用程序记录类型对于贷款申请Collaboration Manager可以是“msfi_loanapplication”。
      • 协作根实体 ID: 关联的应用程序记录的 ID,例如可以是贷款申请记录的 ID。

      高级选项

      元数据 (高级) : 添加协作会话的元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与元数据属性关联的键。
      • 价值: 与元数据属性关联的值。
    2. 检索协作会话

      显示如何检索协作会话的屏幕截图。

      此步骤操作返回与提供的输入匹配的协作会话:

      • 应用程序名称: 协作会话的应用程序名称上下文。
      • 协作根实体 ID: 协作会话的业务实体 ID。
      • 协作根实体名称: 协作会话的业务实体类型。
    3. 更新协作会话

      屏幕截图显示如何更新协作会话。

      此步骤操作将更新现有协作会话:

      • 协作根 ID: 目标协作会话/根记录的 GUID。
      • 协作根实体 ID: 协作会话引用的业务实体 ID。
      • 协作根实体名称: 协作会话引用的业务实体类型名称。

      高级选项:

      创建元数据 (高级) : 向协作会话记录添加更多元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与元数据属性关联的键。
      • 价值: 与元数据属性关联的值。

      更新元数据 (高级) :汇报协作会话记录上的现有元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与要更新的元数据属性关联的键。
      • 价值: 与元数据属性关联的值。

      删除元数据 (高级) : 删除协作会话记录上的任何现有元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与要删除的元数据属性关联的键。
    4. 将协作映射 (外部) 关联

      屏幕截图显示如何关联协作映射。

      此步骤操作使用协作会话创建外部协作实体 (Dataverse) 外部的映射:

      • 协作根 ID: 要映射到协作实体的协作会话唯一标识符。
      • 协作映射外部 ID: 要映射的外部协作资源 ID。
      • 协作映射实体名称: 要映射的外部协作实体类型名称。

      高级选项:

      元: 为协作映射添加元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与元数据属性关联的键。
      • 价值: 与元数据属性关联的值。
    5. 将协作映射 (内部) 关联

      屏幕截图显示如何关联内部协作映射。

      此步骤操作使用协作会话创建协作实体 (Dataverse 表) 映射。 内部仅用于在内部 Dataverse 实体或表之间创建映射。

      • 协作根 ID: 要映射到协作实体的协作会话唯一标识符。
      • 协作映射实体 ID: 要映射的 Dataverse 协作实体 ID。
      • 协作映射实体名称: 要映射的 Dataverse 协作实体类型名称。

      高级选项:

      元数据 (高级) 为协作映射添加元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配,则需要提供此字段 #Microsoft.Dynamics.CRM.m365_collaborationmetadata
      • 关键: 与元数据属性关联的键
      • 价值: 与元数据属性关联的值
    6. 更新协作映射

      屏幕截图显示如何更新协作映射。

      此步骤操作将更新现有协作映射:

      • 协作映射 ID: 协作映射要更新的唯一标识符。
      • 协作映射实体 ID: 要映射的协作实体 ID。 如果提供外部 ID,此值必须为空
      • 协作映射实体名称
      • 协作映射外部 ID: 要映射的外部协作资源 ID。 如果提供了实体 ID,则此值必须为空。

      高级选项:

      创建元数据: 向协作地图记录添加更多元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与元数据属性关联的键。
      • 价值: 与元数据属性关联的值。

      更新元数据:汇报协作地图记录上的现有元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配,则需要提供此字段 #Microsoft.Dynamics.CRM.m365_collaborationmetadata
      • 关键: 与要更新的元数据属性关联的键
      • 价值: 与元数据属性关联的值

      删除元数据: 删除协作地图记录上的任何现有元数据。

      • OData 类型: 如果设置了其他键/值并且需要完全匹配 #Microsoft.Dynamics.CRM.m365_collaborationmetadata,则需要提供此字段。
      • 关键: 与要删除的元数据属性关联的键。
    7. 获取协作元数据

      屏幕截图显示如何获取协作元数据。

      此步骤操作列出与指定筛选器匹配的所有元数据。

      滤波器: 要应用于元数据查询的筛选器。 检索与协作映射实体 ID 相关的所有元数据的示例
      m365_entityname eq “m365_collaborationmap” 和 m365_entityid eq “GUID”

    8. 创建 Planner 任务

      屏幕截图显示如何创建规划器任务。

      此步骤操作使用协作控件 Planner 任务虚拟表创建 Graph Planner 任务:

      • 协作根 ID (必需) : 协作会话唯一标识符
      • 计划 ID (必需) : 任务所属的计划 ID
      • 标题 (必需) : 任务的标题
      • 作业: 表示 Task 的所有分配的 json 格式对象。 请参阅 plannerAssignments 资源类型
      • 存储桶 ID: 任务所属的存储桶 ID。
      • 优先: 任务的优先级。 0 和 10 (包含) 增加值是较低的优先级。

      高级选项:

      • 活动清单项计数 (高级) :值设置为 false 的清单项目数,表示不完整的项目。
      • 应用的类别: 一个 json 格式化程序对象,该对象表示要应用于任务的所有类别。 请参阅 plannerAppliedCategories 资源类型
      • 被分配者优先级: 用于在列表视图中对此类项进行排序的字符串值提示。 请参阅 在 Planner 中使用订单提示
      • 清单项计数: 任务上存在的清单项数。
      • 完成者: 一个 json 格式的对象,表示完成任务的用户的标识。 请参阅 identitySet 资源类型
      • 对话线程 ID: 任务上的会话的线程 ID。 这是组中创建的会话线程对象的 ID。
      • 创建者: 一个 json 格式的对象,表示创建任务的用户的标识。 请参阅 identitySet 资源类型
      • 截止日期时间: 任务的截止日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
      • 订单提示: 用于在列表视图中对此类项进行排序的提示。 在 Planner 中使用顺序提示时,将格式定义为概述。
      • 完成百分比: 任务完成百分比 (0-100)
      • 预览类型: 这将设置任务上显示的预览类型。 可能的值包括:automatic、noPreview、checklist、description、reference。
      • 引用计数: 任务上存在的外部引用数。
      • 开始日期时间: 任务开始的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
    9. 获取 Planner 任务

      屏幕截图显示了获取规划器任务。

      此步骤操作使用协作控制 Planner 任务虚拟表返回 Planner 任务数据:

      任务 ID (必需) : 任务唯一标识符

    10. 更新 Planner 任务

      屏幕截图显示更新规划器任务。

      此步骤操作使用协作控制规划器任务虚拟表更新规划器任务记录。

      • 任务 ID (必需) : 任务唯一标识符。
      • 作业: 表示 Task 的所有分配的 json 格式对象。 请参阅 plannerAssignments 资源类型 - Microsoft Graph v1.0 |Microsoft Docs。
      • 存储桶 ID: 任务所属的存储桶 ID。
      • Planner 任务详细信息: 表示有关任务的其他信息。
      • 截止日期时间: 任务的截止日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
      • 优先: 任务的优先级。 0 和 10 (包含) 增加值是较低的优先级。
      • 完成百分比: 任务完成百分比 (0-100) 。
      • 标题: 任务的标题。

      高级选项:

      • 应用的类别: 一个 json 格式的对象,表示要应用于任务的所有类别。 请参阅 plannerAppliedCategories 资源类型
      • 被分配者优先级: 用于在列表视图中对此类项进行排序的字符串值提示。 请参阅 使用 Planner 中的订单提示
      • 对话线程 ID: 任务上的会话的线程 ID。 这是组中创建的会话线程对象的 ID。
      • 协作根 ID: 协作会话唯一标识符。
      • 订单提示: 用于在列表视图中对此类项进行排序的提示。 格式在此处定义为大纲。
      • 开始日期时间: 任务开始的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。

示例流方案

下面是流的示例:

  1. 从 Microsoft 表单获取响应,创建协作会话和关联的任务。

    屏幕截图显示如何提交新响应。

  2. 每次创建协作会话时,捕获详细信息并发送电子邮件通知。

    屏幕截图显示了创建的协作会话。

注意

可以通过这种方式触发多个流,以使用协作会话创建响应中的数据执行不同的操作。

另请参阅