Outlook 加载项和 Exchange 中的 EWS

查找有关 Outlook 加载项及其如何与 Exchange 中的 EWS 配合使用的信息。

Outlook 加载项提供单个接口和编程模型,使用 Web 标准为电子邮件用户创建自定义体验。 可以在托管在 Outlook 中的 HTML5 帧中创建显示上下文或有用信息的邮件应用;例如,邮件应用可以显示必应地图,其中在电子邮件包含地址时突出显示地址。 或者,当用户撰写邮件时,邮件应用可以显示有关收件人的其他信息,并在触摸按钮时将标准问候语插入电子邮件中。

注意

除非另有说明,否则本文中提及“Outlook”的地方也适用于 Outlook 富客户端、Outlook Web App 和适用于设备的 OWA。

邮件应用接口是适用于 Office 的 JavaScript API 的一部分。 可以使用 API 访问 Exchange 中的信息,使邮件应用能够:

  • 识别实体,如地址、电话号码、任务建议或电子邮件中的会议建议。

  • 在单独的视图中打开并显示现有的邮件约会,以便用户可以在一封或多封邮件中交叉引用信息。

  • 向托管用户邮箱的 Exchange 服务器发送 EWS 请求。 例如,邮件应用可以获取文件夹列表,以便用户可以选择一个文件夹来存储邮件,或显示对话中的所有项目,或将电子邮件标记为垃圾邮件。

  • 获取令牌以唯一标识电子邮件帐户,以在第三方服务上启用单一登录。

  • 获取令牌,使第三方服务能够代表用户发出 EWS 请求。例如,从项目中提取附件,或从 Exchange 服务器获取项以供进一步处理。

可以使用邮件应用为用户自定义 Outlook Web App 体验;但是,如果想要自定义 Outlook Web App 的外观,请参阅 TechNet 上的以下文章:

你的组织可以在内部服务器上安装邮件应用以限制对授权用户的访问,或者你和其他邮件应用开发人员可以将邮件应用放在 Office Microsoft Store 上,向公众出售。 运行 Outlook 的任何人都可以从市场下载、安装和使用邮件应用。

若要了解有关创建邮件应用的详细信息,请查看 Outlook 加载项文档创建 EWS 请求示例。

EWS 和 Outlook 加载项

可以在托管运行邮件应用的帐户的 Exchange 服务器上使用 EWS 操作的子集。

Mailbox.makeEwsRequestAsync 函数使你能够从邮件应用向托管用户邮箱的服务器发出 EWS 请求。 创建 SOAP 信封和 XML 请求,makeEwsRequestAsync 函数使用身份验证令牌调用 EWS,该令牌标识发出请求的邮箱和邮件应用。 为了帮助保护用户的邮箱,Exchange 服务器将拒绝来自邮件应用或未托管在服务器上的邮箱的任何请求。

与任何其他应用程序一样,邮件应用也需要权限才能正常工作。 管理员需要执行以下操作:

还需要确保应用请求应用中的读/写邮箱权限,才能使用 Office 权限模式

完成上述步骤后,可以使用一部分文件夹和项 EWS 操作供邮件应用使用。

表 1. 邮件应用可以使用的 EWS 文件夹和项目操作

文件夹操作 项操作
CreateFolder 操作
FindFolder 操作
GetFolder 操作
UpdateFolder 操作
CopyItem 操作
CreateItem 操作
FindItem 操作
FindConversation 操作
GetConversationItems 操作
GetItem 操作
MarkAsJunk 操作
MoveItem 操作
SendItem 操作
UpdateItem 操作

服务回调令牌

服务回调令牌使邮件应用能够将访问令牌传递给第三方服务,以便服务可以向托管邮箱的 Exchange 服务器发出 EWS 请求。 例如,邮件应用可以将服务回调令牌传递给第三方服务,以及附加到电子邮件的图片的附件 ID 列表。 然后,服务可以使用附件 ID 和回调令牌向用户的 Exchange 服务器发出 EWS 请求以获取附件中的图片。 邮件应用还可以将服务回调令牌与项目 ID 列表结合使用,从 Exchange 服务器获取电子邮件和约会项目。

服务回调令牌是第三方服务附加到持有者身份验证标头中的 EWS 请求的不透明令牌。 该令牌标识邮件应用和邮箱,以帮助保护 EWS 请求。 若要了解如何使用服务回调令牌,请参阅 Outlook加载项:从 Exchange 服务器获取附件示例。

另请参阅