任务模块

任务模块允许你在 Teams 应用程序中创建模式弹出体验。 在弹出窗口中,可以:

  • 运行自己的自定义 HTML 或 JavaScript 代码。
  • <iframe>显示基于 YouTube 或Microsoft Stream视频等小组件。
  • 显示 自适应卡片

任务模块可用于启动和完成任务或显示丰富的信息,例如视频或 Power Business Intelligence (BI) 仪表板。 与选项卡或基于聊天的机器人体验相比,启动和完成任务的用户通常更自然地使用弹出式体验。

任务模块以Microsoft Teams选项卡为基础构建。 它们本质上是弹出窗口内的选项卡。 它们使用相同的 SDK,因此,如果已生成选项卡,则你已熟悉如何创建任务模块。

可通过 3 种方式调用任务模块:

  • 频道或个人选项卡:使用Microsoft Teams选项卡 SDK,可以从选项卡上的按钮、链接或菜单调用任务模块。有关详细信息,请参阅选项卡中的使用任务模块
  • 机器人:在从机器人发送的 片上使用按钮。 当你不需要频道中的每个人查看你正在对机器人执行的操作时,这非常有用。 例如,让用户在频道中响应投票时,查看正在创建的轮询的记录是没用的。 有关详细信息,请参阅Teams机器人使用任务模块
  • 在深层链接Teams之外:还可以创建 URL 从任意位置调用任务模块。 有关详细信息,请参阅 任务模块深度链接语法

任务模块的组件

下面是从机器人调用任务模块时的外观:

任务模块示例

任务模块包括以下内容,如上图所示:

  1. 应用的 color 图标

  2. 应用的 short 名称

  3. 在 TaskInfo 对象的属性中title指定的任务模块的标题。

  4. 任务模块的关闭或取消按钮。 如果用户选择此按钮,应用将收到一个 err 事件。 有关详细信息,请参阅 提交任务模块结果的示例

    备注

    当前无法 err 检测从机器人调用任务模块时的事件。

  5. 如果要使用 url TaskInfo 对象的属性加载自己的网页,则会显示蓝色矩形。 有关详细信息,请参阅 任务模块大小调整。

  6. 如果使用 card TaskInfo 对象 的属性显示自适应卡片,则会为你添加填充。 有关详细信息,请参阅 HTML 或 JavaScript 任务模块的任务模块 CSS

  7. 选择 “注册”后,自适应卡片按钮呈现。 使用自己的页面时,请创建自己的按钮。

后续步骤

另请参阅

卡片