搜索 ServiceNow 记录

UiPath.ServiceNow.Activities.SearchRecords

“ 搜索 ServiceNow 记录” 活动使用 ServiceNow 表 - GET API 来使用 编码的查询字符串 (Query) 检索特定记录 (对象)。

检索记录后，该活动将查询结果输出为 DataTable 对象 (Result)，并在 ResponseStatus 对象 (ServiceNowStatus) 中输出请求状态（成功/失败信息）。 这两个输出都可以用作后续活动（例如条件逻辑）中的输入变量。

工作方式

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

1. 完成 设置 步骤。
2. 将“ ServiceNow 作用域 ”活动添加到项目中。
3. 在“ ServiceNow 作用域 ”活动中添加“搜索 ServiceNow 记录”活动。
4. 单击“ 搜索 ServiceNow 记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
5. 选择要检索的 对象 ，并输入“ 输入 ”属性的值。
6. 为 输出 属性创建并输入 DataTable 和 ResponseStatus 变量。
   • 您的输入属性值将发送到“ 表格 - GET ” API。
   • API 将 DataTable 和 ResponseStatus 值返回到您的输出属性变量。
     
     

     

     
     

在活动正文中

要输入 Search ServiceNow 记录 属性值和/测试 查询 输入，您可以通过单击“ 配置 ”按钮来使用“对象向导”。

要了解有关“ 对象向导”的更多信息，请参阅“ 业务活动框架 ”页面。

• “对象 ” - 要检索的 ServiceNow 对象的类型。 使用“ 对象向导 ”选择对象或输入有效的 String 或 String 变量。 如果使用“ 对象向导 ”来选择对象，则还必须使用它来更改选择。 未使用对象向导进行的更改会导致活动正常失败。

属性

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 和 String 变量。

输入

• “查询 ” - 筛选参数。 输入 String 或 String 变量。
  • 按照 ServiceNow 编码的查询字符串 格式输入查询（例如， "sysparm_query=short_descriptionLIKEUiPath&sysparm_fields=number,short_description"）。
  • 要构建查询，建议您按照 ServiceNow 文档中的步骤操作， 通过筛选器生成编码的查询字符串 。
  • 要测试查询，请打开“ 对象向导”，输入 String （不带引号 ("")），然后单击“ 测试查询 ” 按钮以查看结果。
  • 您在“ 对象向导 ”中输入的查询 String 也会填充“ 属性面板”中的“查询”属性。

    有关如何轻松创建查询的更多信息，请参阅如何使用搜索 ServiceNow 记录。

其他

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

输出

• “结果 ” - 查询的结果。 输入 DataTable 变量。
• ServiceNowStatus - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。

示例

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

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