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 文档中的“ 角色 ”部分。

工作方式

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

1. 完成 设置 步骤。
2. 为每个 SecureString 输入属性添加一个活动 (例如，总共两个 - 一个用于 密码 ，另一个用于客户端 密码)
3. 将“ ServiceNow 应用程序作用域 ”活动添加到您的项目中。
4. 输入“ 身份验证 ”和“ 连接 ”属性的值。
5. 为“输出”属性创建并输入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 实体时，或在运行活动时在运行时提取这些基本身份验证凭据时，才会使用这些基本身份验证凭据进行身份验证。

如果提供的基本身份验证凭据不正确，则在加载实体列表时将引发错误，因为它使用保存的基本身份验证凭据连接到 ServiceNow 并获取实体/表名称。

如果凭据（Username、 Password、 EndpointUrl）正确，则将在活动下拉列表中填充实体，如下所示：

运行时

确保在右侧的属性窗格中填充凭据。

如果凭据正确，则活动将运行。 如果不正确，它将在运行时引发错误，如下所示：