自适应卡的通用操作

  • 项目

自适应卡片的通用操作从开发人员反馈演变而来，即即使自适应卡片的布局和呈现是通用的，操作处理也不是。 即使开发人员想要将相同的卡发送到不同的位置，他们必须以不同的方式处理操作。

自适应卡片的通用操作将机器人作为处理操作的常见后端，并引入了一种新的操作类型， Action.Execute该类型适用于 Teams 和 Outlook 等应用。

本文档可帮助你了解如何使用通用操作模型来增强跨平台和应用程序与自适应卡片交互的用户体验。

使用自适应卡片的通用操作增强用户体验

自适应卡片的通用操作通过启用以下方案来增强用户体验：

通用操作

在自适应卡片的通用操作之前，不同的主机提供了不同的操作模型，如下所示：

  • 团队或机器人使用 Action.Submit，此方法将实际通信模型推迟到基础通道。
  • Outlook 用于 Action.Http 与自适应卡片有效负载中显式指定的后端服务通信。

下图显示了当前不一致的操作模型：

不一致的操作模型

借助自适应卡片的通用操作，可用于 Action.Execute 跨不同平台的操作处理。

Action.Execute 适用于所有中心（包括 Teams 和 Outlook），不能替代 Action.Submit。 例如，如果希望外部系统执行操作，并且操作的结果必须使用 消息传递扩展发送回对话， Action.Execute 则不支持。

对于 链接展开卡片 （如主图卡和缩略图卡），必须调用 Action.Submit。

此外，自适应卡可以作为触发的调用请求的 Action.Execute 响应返回。

下图显示了新的通用操作模型：

自适应卡片的新通用操作

现在可以向 Teams 和 Outlook 发送相同的卡，并使用基础机器人保持彼此同步。 在任一平台上执行的任何操作都通过此生成一次反映在另一个平台上， (自适应卡的通用操作) 模型 部署到任意位置 。

下图描绘了适用于 Teams 和 Outlook 的自适应卡片的通用操作：

用户特定视图

现在，Teams 聊天或频道中的每个用户都能在自适应卡片上看到完全相同的视图和按钮操作。 但是，在某些情况下，要求某些用户以不同的方式行事，并有权访问同一聊天或频道中的不同信息。

例如，如果在聊天或频道中发送事件报告卡，则只有分配了该事件的用户才能看到“解决”按钮。 另一方面，事件创建者必须看到 “编辑” 按钮，而所有其他用户必须只能查看事件的详细信息。 这可以通过 由 属性启用 refresh 的用户特定视图来实现。

下图显示了票证消息扩展 (ME) ，其中聊天中的不同用户根据要求显示不同的操作：

有关详细信息，请参阅 用户特定视图的示例。

顺序工作流支持

借助顺序工作流支持，用户无需单独发送不同的卡片即可完成一系列工作流。 这可以通过 Action.Execute 返回自适应卡片来响应操作而实现。 此外，聊天或频道中的任何用户都可以完成其工作流，而无需修改聊天中其他用户的卡。

下图演示了食品订购机器人示例：

顺序工作流

下图显示了聊天或频道中不同用户的各种状态：

餐饮机器人状态

有关详细信息，请参阅 顺序工作流的示例。

最新视图

可以创建自动更新的自适应卡片。 例如，它可以是用户发送的审批请求。 审批后，卡必须自动显示有关请求审批时间和批准请求的人员的详细信息。 刷新模型使你能够提供此类最新视图。 下图显示了多步骤审批流程以及如何显示不同用户的视图。

最新的用户特定视图

有关详细信息，请参阅 最新视图的示例。

现在，你可以了解如何使用新的通用操作模型转换自适应卡片，以提供独特且增强的用户体验。

自适应卡片和新的通用操作模型

自适应卡片是内容（如文本和图形）以及用户可以执行的操作的组合。 有关详细信息，请参阅 自适应卡片。 新的自适应卡片通用操作支持跨平台和应用程序通用处理自适应卡片操作。 有关详细信息，请参阅 通用操作模型。

可以使用 快速入门指南 更新方案，并利用通用操作来开始。

后续步骤

使用自适应卡的通用操作

另请参阅