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 等 用于集成用户角色）。修改表格的入站 Web 服务应仅限于相应的系统角色。

有关更多信息，请参阅 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 变量，请使用输出凭据资产的活动（请参阅下面的示例）。
本地端口（可选） - 用于重定向的本地端口。默认值为10001 。输入字符串或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 实体时，或在运行活动时在运行时提取这些基本身份验证凭据时，才会使用这些基本身份验证凭据进行身份验证。