了解 Outlook 中可操作邮件的操作类型

  • 4 分钟

Outlook 中的可操作邮件基于自适应卡片格式构建。 Outlook 扩展了标准的自适应卡片架构，以定义其他操作来支持可操作邮件方案。

在此单元中，我们将了解以下特定于 Outlook 的操作。

  • Action.Http
  • Action.InvokeAddInCommand
  • Action.DisplayMessageForm
  • Action.DisplayAppointmentForm
  • Action.ToggleVisibility

Action.Http

Action.Http 操作是使可操作邮件与服务交互的核心操作。 此操作将 HTTP POST 发送到服务，并可以包含用户输入。

为响应此操作，你的服务可提供一张名为刷新卡片的新卡片。 刷新卡片将永久替换该电子邮件上的卡片。 刷新卡片通常用于报告该操作的状态。 例如，当收件人回复调查类可操作邮件时，你的服务可能会发回一张卡片，感谢收件人进行答复。

也可将 Action.Http 操作设置为在用户打开邮件时自动执行。 操作结果包含一张新卡片，该卡片已使用最新信息更新。 例如，如果费用报表工具向多个审批者发送审批请求，该卡可能会自动调用操作来查询服务以查看某人是否已经批准报表。 在这种情况下，该卡片可以用一张通知收件人谁给予了批准以及在何时批准的卡片替代要求收件人给予批准的卡片。

{
  "type": "Action.Http",
  "title": "Send Feedback",
  "method": "POST",
  "url": "https://...",
  "body": "{{feedbackText.value}}"
}

Action.InvokeAddInCommand

任务 Action.InvokeAddInCommand 调用任务窗格 Outlook 加载项。 它支持单击一次安装加载项，因此不要求收件人已安装该加载项。

此操作可用于：

  • 启用需要更复杂的用户交互，且不适用于可操作性邮件架构，但仍通过调用加载项在 Outlook 中保留用户的方案。
  • 通过为收件人提供单击一次即可安装加载项的选项并使用加载项响应操作请求，帮助促进 Outlook 加载项的采用。
{
  "type": "Action.InvokeAddInCommand",
  "title": "Create Support Ticket with Contoso Support",
  "addInId": "527104a1-f1a5-475a-9199-7a968161c870",
  "desktopCommandId": "openTicketPane",
  "initializationContext": {
    "referenceNumber": "REF039420",
    "bucketId": 2,
    "priority": "normal"
  }
}

Action.DisplayMessageForm 和 Action.DisplayAppointmentForm

使用 Action.DisplayMessageForm 和 Action.DisplayAppointmentForm 操作在收件人邮箱中打开现有电子邮件或约会。

{
  "type": "Action.DisplayMessageForm",
  "title": "Show me the message",
  "itemId": "AAMkAGUy...g3BZAAA="
}

Action.ToggleVisibility

使用 Action.ToggleVisibility 操作，用户在点击按钮或其他可操作元素时，可显示和/或隐藏卡片特定元素。

{
  "type": "Action.ToggleVisibility",
  "title": "Show only unassigned issues",
  "targetElements": [
    "assignedIssues"
  ]
}