Microsoft Office 365 作用域

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

描述

使用 Microsoft 身份平台在 UiPath 和您的 Microsoft 365 应用程序之间建立经过身份验证的连接。此经过身份验证的连接使机器人能够调用 Microsoft Graph API，以代表您读取和写入资源。

重要提示：从版本 2.5.5 开始，您可以在“作用域”活动中使用较新的 Microsoft 365 活动。要了解如何将 Integration Service 活动与 Microsoft 365 作用域一起使用，请参阅如何在没有 Integration Service 连接的情况下使用 Microsoft 365 活动。

项目兼容性

Windows - Legacy | Windows

配置

提示：本页面介绍了 Microsoft 365 作用域活动中可用的身份验证参数。有关每个身份验证选项的更多详细信息，请参阅如何连接到 Microsoft 365 活动指南。

要开始配置此活动，您必须先选择连接方法。根据所选方法，“属性”面板将显示不同的字段。

• “连接方法”- 选择要使用的连接方法。 下拉菜单中的可用选项包括：
  • “属性面板”- 在“属性”面板中配置连接详细信息。
  • “资产” - 使用 Orchestrator 凭据资产。 我们建议您使用此选项。

资产连接方法

注意：选择此选项时，通常在“属性”面板中显示的大多数身份验证字段都将隐藏，因为身份验证信息存储在资产中。

• 连接资产- 浏览 Orchestrator 文件夹以选择资产。 此字段支持IResource变量。 选择“管理资产” 按钮以打开 Orchestrator。 可用资产列表取决于 Studio 和机器人连接到的 Orchestrator。
  • 如果您已在 Orchestrator 中更新资产，请使用加号按钮菜单选择“重新加载资产”。 请注意，如果您在使用 Studio Desktop 时在 Orchestrator 中添加新资产，则无法立即在“作用域”活动中使用该资产。

• 请参阅如何在没有 Integration Service 连接的情况下使用 Microsoft 365 活动中的资产格式。

根据资产中配置的身份验证类型，您还必须在“属性”面板中配置以下可用字段：

身份验证

• 模拟用户电子邮件地址 - 模拟用户的电子邮件地址。用于“应用程序 ID 和密码”以及“应用程序 ID 和证书”身份验证方法。

用户名和密码（无人值守）

• 用户名 - 您的 Microsoft 365 帐户的用户名。用于“用户名和密码”身份验证方法。
• 密码 - 您的 Microsoft 365 帐户密码。

常见

• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后引发错误，您将无法完成交互式身份验证（同意对话框）。 此字段仅支持整数和Int32变量。 默认值为 30000 毫秒（30 秒）。

运行时

• 运行时连接资产- 浏览以选择资产。 此字段可用于为运行时选择不同的资产。 使用加号按钮菜单以选择“相对路径”，然后输入包含连接详细信息的 Orchestrator 资产的完整路径。

属性面板连接方法

注意：选择此选项时，必须在“属性”面板中配置可用的身份验证字段。

首先，配置以下字段：

• 连接- 从列表中选择一个帐户。 您可以添加、删除连接，以及选择要使用的连接。
• 身份验证作用域- 请参阅下面的使用身份验证作用域向导部分。

使用身份验证作用域向导

注意：此向导将替换此包的以前版本中提供的“服务”参数。使用交互式令牌身份验证时，可使用“身份验证作用域”向导。

“作用域”活动包含一个通用权限选取器，可提供活动正常运作所需的所有已使用的身份验证作用域的清晰画面。

“Microsoft 365 作用域”活动中包含的所有子活动都会自动检测为必需的作用域。

如果未从“作用域”向导中手动选择任何作用域，则默认情况下会在运行时应用“自动检测”功能，并且无需配置向导。 在运行时选择所有最低要求的作用域。

您也可以在将子活动添加到 Microsoft 365 作用域后，手动添加作用域。

接下来，您必须从“属性”面板中选择“身份验证类型”，并配置首选身份验证方法所需的字段。以下部分列出了每个菜单下的可用字段。

身份验证

• 身份验证类型 - 已注册的应用程序所需的身份验证类型。选择以下五个选项之一：“交互式令牌”、“集成 Windows 身份验证 (IWA)”、“用户名和密码”、“应用程序 ID 和密码”或“应用程序 ID 和证书”。默认值为“交互式令牌”。
• 环境 - 环境。可以是 Azure Global 或是与 Azure Global 不同的独特国家云环境。选择以下五个选项之一：“默认”、“全球”、“中国”、“德国”或“美国政府”。默认值为“全球”。
• 应用程序 ID - 您在设置过程中注册应用程序时，Azure Active Directory 分配的唯一应用程序（客户端）ID。应用程序（客户端）ID 表示 Microsoft 365 应用程序的实例。
• 租户 - 您在设置期间注册应用程序时，由 Azure Active Directory 分配的唯一目录（租户）ID。多租户应用程序和集成的 Windows 身份验证为必要项。目录（租户）ID 可以在已注册应用程序的概述页面（在应用程序（客户端）ID 下）中找到。
• 模拟用户电子邮件地址 - 模拟用户的电子邮件地址。用于 Unattended 场景（“应用程序 ID 和密码”以及“应用程序 ID 和证书”身份验证方法）。

交互式令牌

注意：这与 Integration Service 中支持的身份验证方法相同，即通过公共 UiPath 应用程序或私有自定义应用程序（自带应用程序方法）进行身份验证。

有关详细信息，请参阅交互式令牌。

• OAuth 客户端- 指定要使用的应用程序（客户端）。此字段仅支持 OAuthApplication 变量。选择以下选项之一：
  • UiPath - 默认。当您要使用 UiPath 创建的应用程序（UiPath 公共应用程序注册）时。如果选中，“身份验证”部分中提供的“应用程序 ID”和“租户”字段将被忽略。
  • 自定义 - 当您要创建自己具有特定权限的应用程序时。在这种情况下，您必须为“应用程序 ID”字段设置值。请参阅如何为 Microsoft 365 作用域连接创建应用程序。

应用程序 ID 和证书（无人值守）

有关详细信息，请参阅应用程序 ID 和证书。

• Base64 证书 - 证书的 Base64 表示形式。

• 证书密码- 使用证书时可能需要的可选密码， Secure String形式。

Application ID and Secret (Unattended)

有关详细信息，请参阅应用程序 ID 和密码。

• “应用程序密码” - 应用程序用于提供其身份的密码字符串。
• 安全应用程序密码 - 应用程序（客户端）密码，以 SecureString形式显示。

用户名和密码（无人值守）

有关详细信息，请参阅用户名和密码。

重要提示： Microsoft 已弃用在线 Exchange 的基本身份验证。 这会影响我们的一些活动，例如 Microsoft Office365 作用域。 我们建议在支持 OAuth 协议的活动中使用该协议。

• 密码 - 您的 Microsoft 365 帐户密码。
• 安全密码 - 您的 Microsoft 365 帐户密码，形式为 SecureString。
• 用户名 - 您的 Microsoft 365 帐户的用户名。

常见

• 超时（毫秒） - 指定最长等待时间（以毫秒为单位），如果超出该时间后交互式身份验证（同意对话框）未完成，便会引发错误。此字段仅支持整数和 Int32 变量。默认值为 30000 毫秒（30 秒）（未显示）。
• 出错时继续 - 指定即使在当前活动失败的情况下，仍继续执行其余活动。

故障排除

如果遇到任何身份验证问题，请参阅 “ 故障排除 - 身份验证”。