Outlook 加载项概述

  • 项目

Outlook 加载项由第三方使用基于 Web 的平台集成到 Outlook 中。 Outlook 加载项有三个主要方面：

  • 相同的加载项和业务逻辑可跨桌面（Windows 版和 Mac 版 Outlook）、Web（Microsoft 365 和 Outlook.com）和移动平台使用。
  • Outlook 外接程序包括一个清单，其中介绍了如何将外接程序集成到 Outlook（例如，按钮或任务窗格）中，以及构成外接程序 UI 和业务逻辑的 JavaScript/HTML 代码。
  • 最终用户或管理员可以从 AppSource 获取 Outlook 加载项，也可以进行旁加载。

Outlook 加载项不同于 COM 或 VSTO 的加载项，后者为特定于 Windows 版 Outlook的较旧集成。 Outlook 加载项与 COM 加载项不同，它在用户的设备或 Outlook 客户端上没有通过物理方式安装任何代码。 对于 Outlook 加载项，Outlook 读取清单，挂钩 UI 中的指定控件，然后加载 JavaScript 和 HTML。 Web 组件全部在沙盒中的浏览器或 Web 视图控件的上下文中运行。

重要

当前处于预览状态 的新 Outlook on Windows 不支持 COM 和 VSTO 加载项。 经典 Outlook on Windows 桌面客户端仍支持这些加载项。 若要了解详细信息，请参阅 开发适用于 Windows 上的新 Outlook 的 Outlook 加载项 (预览版) 。

支持加载项的 Outlook 项目包括电子邮件、会议请求、响应和取消及约会。 每个 Outlook 加载项均定义其可用的上下文，包括项目类型以及用户是在阅读还是撰写项目。

注意

如果你计划将加载项发布到 AppSource，并使其在 Office 体验中可用，请确保你遵守商业市场认证政策。 例如，加载项必须适用于支持你定义的方法的所有平台，才能通过验证（有关详细信息，请参阅第 1120.3 部分以及 Office 加载项应用程序和可用性页）。

扩展点

扩展点是外接程序与 Outlook 集成的方式。 以下是执行此操作的方法。

外接程序可用的邮箱项目

当用户正在撰写或阅读邮件或约会，而不是其他项目类型时，Outlook 加载项会激活。 但是，如果撰写或阅读窗体中的当前邮件项目为以下项之一，则 Outlook 不会激活邮件加载项：

  • 受信息权限管理 (IRM) 或以其他方式加密，以便在移动设备上通过 Outlook 进行保护和访问。 数字签名的消息就是一个示例，因为数字签名依赖于其中一种机制。 若要详细了解 Outlook 加载项中的 IRM 支持，请参阅 受 IRM 保护的邮件项目。

  • 一个受 IRM 保护的邮件项目，其敏感度标签将 “允许编程访问 自定义策略”选项设置为 false。 若要详细了解 Outlook 加载项中的 IRM 支持，请参阅 受 IRM 保护的邮件项目。

  • 具有邮件类别 IPM.Report.* 的送达报告或通知，包括送达和未送达报告 (NDR)，以及已读、未读和延迟通知。

  • 属于其他邮件的附件的 .msg 或 .eml 文件。

  • 从文件系统打开的 .msg 或 .eml 文件。

  • 在 组邮箱中、共享邮箱*、其他用户邮箱*、 存档邮箱或公用文件夹中。

    重要

    * 支持委托访问方案 (例如，要求 集 1.8 中引入了从其他用户邮箱) 共享的文件夹，而要求 集 1.13 中引入了共享邮箱支持。 若要了解详细信息，请参阅 启用共享文件夹和共享邮箱方案。

  • 使用自定义窗体。

  • 通过简单 MAPI 创建。 如果 Outlook 关闭时，Office 用户从 Windows 上的 Office 应用程序创建或发送电子邮件，则将使用简单 MAPI。 例如，用户在 Word 中工作时可以创建 Outlook 电子邮件，这会触发 Outlook 撰写窗口，而无需启动完整的 Outlook 应用程序。 但是，如果用户从 Word 创建电子邮件时 Outlook 已在运行，则这不属于简单 MAPI 方案，因此只要满足其他激活要求，Outlook 加载项就会在撰写窗体中工作。

通常，Outlook 可以为"已发送邮件"文件夹中的项目在阅读窗体中激活加载项，基于已知实体字符串匹配激活的加载项除外。 有关其背后的具体原因，请参阅 支持已知实体。

目前，设计和实现移动客户端的加载项时还有其他注意事项。 若要了解详细信息，请参阅 在移动设备上的 Outlook 中添加对外接程序命令的支持。

受 IRM 保护的邮件项目

当从以下受支持的客户端访问该项目时，Outlook 加载项在受 IRM 保护的邮件项目上激活。

  • 从版本 2009 开始的 Windows 版 Outlook (内部版本 13229.10000)

    注意

    数字签名依赖于保护机制，例如 IRM。 从与 Microsoft 365 订阅关联的 Windows 版本 1711 (内部版本 8711.1000) 开始，加载项会在数字签名的邮件上激活。

  • Outlook on Mac 版本 16.77.827.0 起

  • Outlook 网页版

  • 新的 Windows 版 Outlook (预览版)

但是，在以下情况下，加载项不会在受 IRM 保护的项上激活：

  • 可从移动设备上的 Outlook 访问受 IRM 保护的项目。
  • 受 IRM 保护的项具有敏感度标签，其中 “允许编程访问 自定义策略”选项设置为 false。 有关自定义策略选项的详细信息，请参阅 使用权限和说明。

支持的客户端

Outlook on Windows (经典版和新的 (预览版) ) 、Outlook on Mac、Outlook 网页版、Outlook on iOS、Outlook on Android 和 Outlook.com 中受支持。 不是所有最新功能都会同时在所有客户端中受到支持。 有关客户端和服务器上的功能支持的详细信息，请参阅 Exchange 服务器和 Outlook 客户端支持的要求集 和特定于这些功能的文章。

开始构建 Outlook 外接程序

要开始生成 Outlook 加载项，请尝试执行以下操作：

  • 快速入门 - 生成简单的任务窗格。
  • 教程 - 了解如何创建将 GitHub Gist 插入新邮件的加载项。

另请参阅