上下文 Outlook 加载项

上下文加载项是一些根据邮件或约会中的文本进行激活的 Outlook 外接程序。 通过使用上下文加载项，用户无需离开邮件本身即可启动与邮件相关的任务，这会带来更便捷、更丰富的用户体验。

重要

基于实体的上下文 Outlook 加载项将在 2024 年第 2 季度停用。 停用此功能的工作将于 5 月开始，并持续到 6 月底。 6 月之后，上下文加载项将无法再检测邮件项目中的实体以对其执行任务。 以下 API 也将停用。

• Office.context.mailbox.item.getEntities ()
• Office.context.mailbox.item.getEntitiesByType (entityType)
• Office.context.mailbox.item.getFilteredEntitiesByName (名称)
• Office.context.mailbox.item.getSelectedEntities ()

为了帮助最大程度地减少潜在的中断，在基于实体的上下文加载项停用后，仍支持以下内容。

• 正在开发由联机会议加载项激活的 “加入 会议”按钮的替代实现。 结束对基于实体的上下文加载项的支持后，联机会议加载项将自动转换为替代实现，以激活“ 加入会议 ”按钮。
• 基于实体的上下文加载项停用后，将继续支持正则表达式规则。 建议更新上下文加载项，以使用正则表达式规则作为替代解决方案。 有关如何实现这些规则的指南，请参阅 使用正则表达式激活规则显示 Outlook 加载项。

有关详细信息，请参阅 基于实体的上下文 Outlook 加载项的停用。

下面是上下文加载项的示例。

• 选择地址以打开位置地图。
• 选择会打开会议建议加载项的字符串。
• 选择要添加到你的联系人的电话号码。

如何生成上下文加载项

注意

当外接程序使用 Microsoft 365 的统一清单时，不支持上下文 Outlook 加载项。

上下文外接程序的清单必须包含将 xsi:type 属性设置为 DetectedEntity 的 ExtensionPoint 元素。 在 <ExtensionPoint> 元素中，外接程序指定可以激活它的实体或正则表达式。 如果指定实体，则该实体可以是 Entities 对象中的任何属性。

因此，外接程序清单必须包含类型为 ItemHasKnownEntity 或 ItemHasRegularExpressionMatch 的规则。 以下示例演示如何指定外接程序应在检测到的实体为电话号码的邮件上激活。

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="contextLabel" />
  <!--If you opt to include RequestedHeight, it must be between 140px to 450px, inclusive.-->
  <!--<RequestedHeight>360</RequestedHeight>-->
  <SourceLocation resid="detectedEntityURL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message" />
    <Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />
  </Rule>
</ExtensionPoint>

在上下文加载项与帐户关联后，当用户单击突出显示的实体或正则表达式时，加载项会自动启动。 若要详细了解 Outlook 加载项正则表达式，请参阅使用正则表达式激活规则显示 Outlook 加载项。

上下文加载项有一些限制：

• 上下文外接程序可以仅存在于阅读加载项中（而不是撰写加载项中）。
• 不能指定突出显示的实体颜色。
• 未突出显示的实体无法启动卡片中的上下文外接程序。

由于未突出显示的实体或正则表达式无法启动上下文外接程序，因此外接程序至少必须包含一个将 Highlight 属性设置为 all 的 Rule 元素。

注意

EmailAddress和 Url 实体类型不支持突出显示，因此它们不能用于启动上下文加载项。 但是，它们也可以组合在 RuleCollection 规则类型中作为其他激活条件。

如何启动上下文外接程序

用户通过文本（可以是已知实体或开发人员的正则表达式）启动上下文外接程序。 用户通常标识某个上下文外接程序的原因是该实体突出显示。 以下示例显示了在邮件中突出显示的样子。 此处，地址 (实体) 的颜色为蓝色，并带有蓝色虚线下划线。 用户通过单击突出显示的实体即可启动上下文加载项。

当邮件中含有多个实体或上下文外接程序时，用户交互规则如下所示：

• 如果有多个实体，用户必须单击不同的实体才能启动对应的外接程序。
• 如果一个实体激活多个外接程序，则每个外接程序会打开一个新选项卡。用户可在选项卡之间切换，以在外接程序之间更改。例如，名称和地址可以触发电话外接程序和地图。
• 如果单个字符串中包含激活多个加载项的多个实体，则整个字符串将突出显示，单击字符串可在单独的选项卡上显示与此字符串相关的所有加载项。 例如，表达建议在餐厅集会的字符串将激活"建议的会议"加载项和餐厅评级加载项。

上下文外接程序的显示方式

激活的上下文外接程序显示在卡片中，该卡片是靠近实体的单独窗口。 该卡片通常会出现在实体下方，并尽可能地以实体为中心。 如果实体下方没有足够的空间，则卡位于该实体上方。

若要关闭卡片并结束该外接程序，用户可单击该卡片外的任意位置。

当前上下文外接程序

默认情况下，为具有 Outlook 加载项的用户安装以下上下文加载项。

• 必应地图
• 建议的会议

另请参阅

• Outlook 加载项：Contoso 订单编号（根据正则表达式匹配项激活的示例上下文加载项）
• 编写第一个 Outlook 加载项
• 使用正则表达式激活规则显示 Outlook 外接程序
• Entities 对象