ServiceNow 应用程序作用域

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

提示：虽然“ServiceNow 应用程序作用域”活动可以使用标准身份验证 (UserName) 和 (Password)，但强烈建议按照以下步骤对所有连接使用 OAuth 安全性。

ServiceNow 活动使用 OAuth 1.0 协议在 UiPath 和 ServiceNow 实例之间建立经过身份验证的连接。此连接授权机器人代表您调用 ServiceNow API 并访问资源。

要启用授权，请为 ServiceNow 实例创建一个 OAuth 应用程序端点。创建此端点会生成 OAuth 客户端应用程序记录、客户端 ID 和客户端密码，以启用对实例的身份验证访问。

创建端点后，在“ ServiceNow 应用程序作用域 ”活动中输入 ServiceNow 凭据以及应用程序端点 URL、客户端 ID 和客户端密码。

提示：

仅应向集成用户角色分配执行此包中的活动启用的任务所需的最低权限（例如， admin、itil、soap_ecc 等不应用于集成用户角色）。修改表格的入站网页服务应仅限于相应的系统角色。

有关更多信息，请参阅 ServiceNow 文档中的“角色”部分。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

完成设置步骤。
为每个 SecureString 输入属性添加一个活动 (例如，总共两个 - 一个用于密码，另一个用于客户端密码)
将“ ServiceNow 应用程序作用域 ”活动添加到您的项目中。
输入“ 身份验证 ”和“ 连接 ”属性的值。
为“输出”属性创建并输入IConnection变量。
- 您可以在后续使用“ ServiceNow 应用程序作用域 ”活动时使用此变量。

如果您在使用标准身份验证时遇到问题，请参阅标准身份验证提示。

在活动正文中

要构建项目并在其他活动中启用“ 对象向导 ”，您必须通过单击“ 配置 ”按钮来使用“连接向导”。

要了解更多信息，请参阅 “关于”页面中的 “ 向导 ”部分。

属性

身份验证

“用户名” - ServiceNow 实例的用户名。输入 String 变量。
- 如果您有多个实例，则此值可能与您的 ServiceNow 帐户不同。
- 用户名与密码相关联。建议您按照设置指南的创建凭据资产部分生成 String 变量。
- 要输入 String 变量，请使用输出凭据资产的活动（请参阅下面的示例）。
“密码 ” - ServiceNow 实例的密码（与“ 用户名” 关联）。输入 String 或 String 变量。
- 如果您有多个实例，则此值可能与您的 ServiceNow 帐户不同。
- 用户名与密码相关联。建议您按照设置指南的创建凭据资产部分生成 String 变量。
- 要输入 String 变量，请使用输出凭据资产的活动（请参阅下面的示例）。
客户端密码 - SecureString ，用于授权 UiPath 与 ServiceNow 实例之间的通信。输入 SecureString 变量。
- 完成应用程序注册表后，将为 ServiceNow 实例生成客户端密码。有关更多信息，请参阅设置指南的设置 OAuth 部分。
- 要生成 SecureString 变量，请参阅设置指南的 “ 创建凭据资产 ”部分。
- 要输入 SecureString 变量，请使用输出凭据资产的活动（请参阅下面的示例）。
“客户端 ID” - 应用程序注册表自动生成的唯一 ID。输入 String 变量。
- 完成应用程序注册表后，将为您的 ServiceNow 实例生成客户端 ID。有关更多信息，请参阅设置指南的设置 OAuth 部分。
- 客户端 ID 与客户端密码相关联。建议您按照设置指南的创建凭据资产部分生成 String 变量。
- 要输入 String 变量，请使用输出凭据资产的活动（请参阅下面的示例）。
使用 OAuth 2.0 - 选中此项可使用 ServiceNow 的 OAuth2 代码授予流程。

常见

“显示名称 ” - 活动的显示名称。输入 String 或 String 变量。

连接

端点 URL - ServiceNow 实例的 URL。输入 String 或 String 变量。该 URL 应指向您的 ServiceNow 实例，而不是应用程序注册表中的 重定向 URL 。

其他

“私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

“ReportApiErrorAsException” - 选中后，使用此应用程序作用域的所有子活动都会在 BusinessActivityExecutionException 中报告 API 错误响应。清除后，子活动将在“响应状态”输出属性中填充 API 错误消息，并继续执行工作流。检查 ResponseStatus 属性以确认成功执行。

输出

ServiceNow 连接 - 已建立连接的记录，可在后续的 ServiceNow 应用程序作用域 活动中使用。输入 IConnection 变量 (UiPath.BAF.Models.Connection.IConnection)。

使用现有连接

“现有服务连接” - 来自父“ ServiceNow 应用程序作用域 ”活动的连接记录，您可以使用它来代替建立新连接。输入 IConnection 变量 (UiPath.BAF.Models.Connection.IConnection)。
- IConnection 变量必须来自先前运行的 “ServiceNow 作用域” 活动（父级），该活动仍具有活动连接。
- 如果无法使用此属性建立连接，请尝试重新运行父级 ServiceNow 应用程序作用域 活动。

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅快速入门指南。

标准身份验证提示

在 ServiceNow 活动包中，基本身份验证（用户名和密码）可用于运行活动。步骤如下：

设计时

在设计时，输入用户名和密码以及端点 URL，系统将保存这些详细信息。请注意，对于作用域级别的基本身份验证，不会使用 ServiceNow 验证凭据。只有在稍后阶段，当在单个活动中提取 ServiceNow 实体时，或在运行活动时在运行时提取这些基本身份验证凭据时，才会使用这些基本身份验证凭据进行身份验证。