快速入门 - 如何使用搜索 ServiceNow 记录

概述

本指南旨在引导您完成几个示例，说明如何使用“ 搜索 ServiceNow 记录” 活动查询数据。

您可以输入查询，例如 “名称-值对=状态=已关闭” ，用于筛选状态为已关闭的对象（例如 事件）列表。 这在 ServiceNow 的文档中进行了描述，您可以使用 ServiceNow REST API 资源管理器进行测试。 我们的活动接受用户提供的查询，并将其附加到相关的 ServiceNow REST API 调用，然后接收结果。

某些客户的问题是，他们并不容易理解如何创建查询、如何测试查询，或者他们的技术水平不高，因此学习和使用 ServiceNow REST API 资源管理器是可行的。

指南

ServiceNow 有关构建可与其 REST API 一起使用的查询的文档位于 编码查询字符串 文档中。 如果您想了解如何构建可与“搜索 ServiceNow 记录”活动一起使用的查询，这是一个非常有用的资源。

以下是一些可与“ 事件” 对象一起使用的查询示例：

查询	描述
sysparm_fields=number,sys_created_on,sys_created_by	返回所有记录，但仅返回指定的三列（number、sys_created_on 和 sys_created_by）
name-value pairs=state=closed	返回状态为 关闭的所有记录。
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	仅返回每条记录的三列（number、sys_created_on 和 sys_created_by），仅返回状态为 Open的记录，并将结果限制为 1 条记录。
priority=2	返回优先级为 2的所有记录。
sysparm_query=active=true&state=closed	返回简短描述为“ 网络”的所有记录
sysparm_query=short_descriptionLIKEnetwork	返回一条编号为 INC0010060 的记录，并且仅返回三列作为结果的一部分（sys_id、number、short_description）

还有两种方法可以创建和获取可用于此活动的有用查询。

1. 选项 A：从 ServiceNow 用户界面复制任何查询。
2. 选项 B：从浏览器复制查询字符串。

选项 A：从 ServiceNow 用户界面复制任何查询

您需要将文本“sysparm_query=”附加到根据以下步骤生成的任何查询中。

第 1 步

转到对象，在本例中为“ 事件 ”。

第 2 步

清除筛选器并创建新筛选器。 在本例中，我们要查找编号以字符串“100”结尾的任何事件。

步骤 3

使用“复制查询”菜单项复制查询。 它看起来像编号ENDSWITH100。

步骤 4

将其粘贴到“搜索 ServiceNow 记录”活动中。 您可以在如下所示的“测试查询” 窗口中执行此操作，也可以在活动的查询属性中执行此操作。

请务必在前面 附加 sysparm_query= ，使其看起来像 sysparm_query=numberENDSWITH100，否则它将无法正常工作。

选项 B：从浏览器复制查询字符串。

在此选项中，您不必记住将任何内容添加为前置步骤。 如果您使用“ 打开新窗口 ”选项，则可以复制并粘贴查询字符串，如下所示：

第 1 步：

像以前一样在选项 A 中创建要使用的筛选器。

  第 2 步：右键单击并选择“ 打开新窗口 ”菜单选项。

第 3 步：复制查询 字符串 （问号“?”之后的所有内容）。 然后将其直接粘贴到“搜索 ServiceNow 记录”活动的“测试查询”对话框中，如下所示。