Microsoft 宣布用于连接到 Exchange Online 的 EWS API 的生命周期终止。 此弃用可能会改变使用 EWS 选项的自动化 (bots),包括 Email packageEmail 触发器。 查看常见问题解答,获取有关 EWS API 弃用的详细信息。

EWS API 弃用是什么?
自 2022 年 3 月 31 日起,Microsoft 已弃用 25 个使用率最低的 EWS API。 这是一项持续性的弃用工作,当相应的 Graph API 可用时,Microsoft 将继续弃用其他 EWS API。

要了解有关 EWS API 弃用的更多信息,请参阅 Upcoming API Deprecations in Exchange Web Services for Exchange Online

为什么会有此改变?
EWS 是一个旧版 API,安全性较低,无法满足现代应用程序开发的安全性和可管理性需求。 根据 Microsoft 的要求,如果客户端或应用程序使用 EWS API 通过 Exchange Online 连接到 Exchange 服务器,则需要将基于 SOAP 的 EWS API 切换为基于 REST 的 Graph API。
Microsoft Graph 相较于 EWS 具有以下优势:
  • 安全性: 与 EWS 中的 全部或无访问模式相比,Microsoft Graph 更为安全,具有更严格的 OAuth 治理策略,并能限制邮箱中的数据访问。
  • 简洁: Microsoft Graph 提供用于轻松快速地发现和测试 API 的 Graph Explorer、不同编程语言的 SDK 以及活跃的开发人员社区。
  • 效率: Microsoft Graph API 基于 REST,而 EWS API 基于 SOAP。 使用基于 REST 协议的优势包括更快的 JSON 序列化和更低的网络使用量。
注: EWS API 的弃用仅适用于 Exchange Online,不适用于本地版本的 Exchange。
这次弃用对我有什么影响?
目前,您不会受到影响,因为 Automation 360 没有使用任何被 Microsoft 弃用的 EWS API。 根据 Microsoft 的说法,未弃用的 EWS API 将继续支持在实际正式环境中使用,我们尚未确定这些 API 未来何时会被弃用的固定时间表。

如果将来用于 Automation 360 的特定 EWS API 被弃用,并且您使用 Email packageEmail 触发器 actions 与 EWS 选项自动处理电子邮件,则由于与 Exchange Online 的连接失败,这些自动化将会中断。

Automation 360 在哪里使用 EWS API?
Automation 360Email package 中使用 EWS API,并在 Email 中触发 EWS 选项,这使您能够连接到在 Azure 云上托管的 Exchange Online,并访问 Microsoft 365 的电子邮件。
如何识别使用 Email EWS 选项的受影响 bots
您可以使用 Automation 360 Bot Scanner 实用工具扫描和识别使用 EWS 的受影响 bots。 请参阅 扫描机器人以进行基本身份验证
Automation 360 客户从 EWS API 切换到 Graph API 可以参考什么指导?
我们发布了一个新的 Microsoft 365 Outlook package,其中包含基于最新版本的 Graph API 的 Automation 360 v.29 版本。 您可以使用此 package 自动处理 Exchange Online 的 Outlook 电子邮件。 此 package 包含所有类似于 Email package 中提供的 actions。 您可以通过 EWS 选项从 EWS API 切换到 Graph API,使用 Microsoft 365 Outlook package 替代 Email package
如何将现有的 bots 更新为 Microsoft 365 Outlook package
要将您现有的受影响 bots 更新为 Microsoft 365 Outlook package,请参阅 Exchange Online 中 EWS API 的弃用
Automation Anywhere 是否会为 Automation 360 客户提供任何工具,以便将他们的 bots 从 EWS API 更新到 Graph API?
不。您必须手动更新受影响的 bots 以切换到 Graph API (Microsoft 365 Outlook package)。
EmailMicrosoft 365 Outlook packages 之间是否存在一对一映射,还是有任何差异?
Email package 中的所有 actionsMicrosoft 365 Outlook package 中也包含。 但是,当您使用新的 Microsoft 365 Outlook package 构建机器人时,必须考虑以下差异:
  • Email package 中,发送转发回复全部回复 actions具有连接参数,因此当您创建自动化时,可以独立于连接 action使用这些 actions。 但是,在 Microsoft 365 Outlook package 的情况下,您必须在每个 actions 之前使用连接 action 操作,因为它们指的是由连接 action 创建的会话,请参见 Microsoft 365 Outlook package
  • 新的 Microsoft 365 Outlook package 支持两种身份验证模式: 使用 PKCE 和客户端凭据的授权码。 带有 EWS 选项的 Email package 支持四种身份验证模式: ROPC、隐式、带有 PKCE 的授权码和客户端凭据。
    注: ROPC 和隐式身份验证模式已弃用,因此在 Microsoft 365 Outlook package 中不受支持。 您必须使用更安全的授权码,使用 PKCE 流程进行有人值守的自动化,使用客户凭据流程进行无人值守的自动化。