添加 Microsoft Exchange IMAP 应用程序
了解如何将 Microsoft™ Exchange 应用程序添加到 IBM RPA。 此应用程序使用 IMAP 从电子邮件服务访问数据。
如果要添加基于 Microsoft™ Exchange Web Service (EWS) 的应用程序,请参阅 添加 Microsoft Exchange 旧应用程序。
❕ 重要信息: 此过程仅适用于本地 IBM RPA 。缺省情况下,
IBM RPA SaaS 提供应用程序。 创建与此应用程序的连接以在 IBM RPA SaaS上使用此应用程序。 有关更多信息,请参阅 向应用程序添加连接。
开始之前
以下列表显示了创建 Microsoft™ Exchange 应用程序的先决条件:
- 本地环境中的 IBM RPA
- 具有 管理应用程序 许可权的用户
- 此应用程序使用 连接到 IMAP 电子邮件服务器 (
imapConnect) 和 连接到 SMTP 服务器 (smtpConnect) 命令。 - Microsoft™ Azure 🡥 帐户
过程
执行以下步骤以创建 Microsoft™ Exchange 应用程序:
创建 Microsoft Entra ID 应用程序
登录到 Azure 帐户 🡥。
在搜索栏中,搜索
Microsoft Entra ID,然后将其选中。从 管理 菜单中,单击 应用程序注册 > 新建注册。
在 名称 字段中,输入应用程序的名称,例如
Microsoft Exchange app。在支持的帐户类型中,单击任何组织目录中的帐户(任何 Microsoft Entra ID 租户 - 多租户)和个人 Microsoft 帐户(如 Skype、Xbox) 选项。
在 重定向 URI 部分中,输入以下值:
- 从 选择平台 列表中,选择 Web。
- 在 URL 字段中,输入 API URL ,如
https://192.158.1.38:7790,其中192.158.1.38是服务器 IP,7790是 IBM RPA 的 API 使用的端口, OAuth2 规范/integration/oauth2。 以下是具有 OAuth2 规范的有效 URL 的示例:https://192.51.100.38:7790/integration/oauth2https://api.example.com/integration/oauth2
🛈 记住: 将 URL 替换为相应的服务器 API URL。
单击注册。
获取客户机值和应用程序标识
- 可选:搜索您创建的 Microsoft Entra ID 应用程序。
- 从 管理 菜单中,单击 证书和私钥。
- 单击新建客户机密钥按钮。
- 在 描述 字段中,输入凭证的描述。
- 在 到期 列表中,选择凭证的到期日期。
- 单击添加。
- 复制 值 列中的值,例如
b47ga196-5d6a-5842-be6c-13f6d6525630。 - 从 " 概述 " 页面,复制 应用程序 (客户机) 标识 值,例如
abc-xyz-3e3s-grgr234-dfedvcefger。
添加应用程序
登录到 IBM RPA Control Center。
执行下列其中一项操作:
- 如果在 V 21.0.7上,请单击主菜单上的 应用程序 。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单上的 连接 ,然后单击 应用程序 选项卡。
单击添加应用程序。
在 名称 字段中,输入应用程序名称。
在 描述 字段中,输入应用程序描述。
在 应用程序标记 字段中,选择用于标识应用程序的标记。 该标记用于过滤应用程序。
单击下一步。
在客户端 ID 字段中,输入从 Microsoft Entra ID 应用程序获得的应用程序(客户端)ID,例如
abc-xyz-3e3s-grgr234-dfedvcefger。在客户端秘密字段中,输入从 Microsoft Entra ID 应用程序中获取的客户端值,例如
b47ga196-5d6a-5842-be6c-13f6d6525630。在重定向 URL 字段中,输入您提供给 Microsoft Entra ID 应用程序的重定向 URL ,例如
https://192.51.100.38:7790/integration/oauth2。在授权 URL 字段中,输入
https://login.microsoftonline.com/common/oauth2/v2.0/authorize。在 授权模板参数 字段中,输入以下代码片段:
client_id={clientId}&response_type=code&redirect_uri={redirectUri}🛈 请记住: IBM RPA 会自动将
{clientId}和{redirectUri}的值分别替换为客户 ID 和重定向 URL 中定义的值。在令牌 URL 字段中,输入
https://login.microsoftonline.com/common/oauth2/v2.0/token。在 API URL 字段中,输入
https://graph.microsoft.com/v1.0/。在 作用域 字段中,输入
openid email offline_access https://outlook.office.com/User.Read https://outlook.office.com/IMAP.AccessAsUser.All https://outlook.office.com/SMTP.Send。单击下一步。
查看您输入的数据的摘要,然后单击 添加。
结果
因此,您可以查看声明已成功添加应用程序的通知。 您还可以在应用程序列表中查看应用程序。
如果失败,您还可以查看通知。 在这种情况下,请查看您输入的数据,然后重试创建应用程序。
下一步
创建连接
创建连接以授权应用程序。 有关更多信息,请参阅 连接。编辑应用程序
如果要编辑应用程序,请执行下列其中一项操作:- 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略号按钮,以进行编辑 > 编辑。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以进行编辑 > 编辑。
⚠ 注意: 如果更改应用程序数据,那么必须重新授权与其绑定的连接。
- 在 IBM RPA Control Center上,执行下列其中一项操作:
- 如果在 V 21.0.7上,请单击 连接 菜单。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 连接。
- 在连接上,单击 垂直省略号按钮, > 重新授权。
使应用程序过时
如果要将应用程序标记为过时,请执行下列其中一项操作:- 如果在 V 21.0.7上,单击主菜单中的 应用程序 ,然后单击 垂直省略符按钮,即表示 > 使其过时。
- 如果在 V 21.0.5 或 21.0.6上,请单击主菜单中的 连接 ,然后单击 应用程序 > 垂直省略号按钮,以用于 > 使其过时。
⚠ 注意: 将应用程序标记为过时不会将其永久移除。 使用该应用程序的所有现有连接都保持活动状态,尽管您无法创建与该应用程序的新连接。
重新激活过时的应用程序
从 21.0.7: 如果要重新激活过时的应用程序,请在 应用程序 菜单中单击 垂直省略符按钮, > 重新激活。删除应用程序
从 21.0.7: 如果要删除未与之连接的应用程序或过时的应用程序,请在 应用程序 菜单中单击 垂直省略号按钮, > 删除。⚠ 注意: 这将从系统中永久除去应用程序。