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

概述

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

您可以输入诸如“name-value对=状态=已关闭”之类的查询，该查询表示要筛选状态为已关闭的对象列表（例如事件）。 ServiceNow 的文档对此进行了说明，您可以使用ServiceNow REST API Explorer对此进行测试。 我们的活动接受用户提供的查询，并将其附加到相关的ServiceNow REST API调用，然后接收结果。

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

指南

关于构建可与其 REST API 一起使用的查询的 ServiceNow 文档位于编码查询字符串文档中。 如果您想了解如何构建可与搜索 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 记录”活动的“测试查询”对话框中，如下所示。