クイックスタート - [複数の ServiceNow レコードを検索] アクティビティの使用方法

概要

このガイドの目的は、[複数の ServiceNow レコードを検索] アクティビティを使用してデータにクエリを実行する方法について、複数の例を挙げて説明することです。

ステートが「closed」であるオブジェクト (Incident など) のリストをフィルター処理するよう指示する "name-value pairs=state=closed" などのクエリを入力できます。これは、ServiceNow のドキュメントで説明されており、ServiceNow REST API Explorer を使用してテストできます。このアクティビティは、ユーザーが入力したクエリを取得して、関連する ServiceNow REST API 呼び出しに追加し、結果を受け取ります。

お客様によっては、クエリの作成方法やクエリのテスト方法を簡単には理解できない、あるいは技術的知識がないので ServiceNow REST API Explorer を学習および使用することが実用的ではない、といった問題があります。

ガイド

REST API で使用できるクエリの構築に関する ServiceNow のドキュメントは、エンコードされたクエリ文字列についてのドキュメントにあります。これは、[複数の ServiceNow レコードを検索] アクティビティで使用できるクエリの構築方法を習得したい場合に便利なリソースです。

以下に、Incidents オブジェクトで使用できるクエリの例をいくつか示します。

クエリ	説明
sysparm_fields=number,sys_created_on,sys_created_by	すべてのレコードを返しますが、指定した 3 つの列 (number、sys_created_on、sys_created_by) のみを返します。
name-value pairs=state=closed	状態が「closed」であるレコードをすべて返します。
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	各レコードについて 3 つの列 (number、sys_created_on、sys_created_by) のみを返し、ステートが 「Open」であるレコードのみを返し、結果を 1 件に制限します。
priority=2	優先度が 2 であるレコードをすべて返します。
sysparm_query=active=true&state=closed	簡単な説明が「network」に似ているレコードをすべて返します。
sysparm_query=short_descriptionLIKEnetwork	number が INC0010060 であるレコードを 1 つ返し、3 つの列 (sys_id、number、short_description) のみを結果の一部として返します。

このアクティビティで使用できる便利なクエリを作成および取得する方法は、他に 2 つあります。

1. オプション A: ServiceNow UI からすべてのクエリをコピーする。
2. オプション B: ブラウザーからクエリ文字列をコピーする。

オプション A: ServiceNow UI からすべてのクエリをコピーする。

以下の手順に従って、生成されるクエリの先頭に「sysparm_query=」というテキストを付加する必要があります。

ステップ 1

オブジェクト (この場合 は Incidents ) に移動します。

ステップ 2

フィルターをクリアして、新しいフィルターを作成します。この例では、文字列「100」で終わる数字が含まれるインシデントを探します。

ステップ 3

メニュー項目 [クエリのコピー] を使用してクエリをコピーします。クエリは「numberENDSWITH100」のようになります。

手順 4

これを [複数の ServiceNow レコードを検索] アクティビティ内に貼り付けます。これは、以下に示すように [クエリをテスト] ウィンドウ、またはアクティビティの [クエリ] プロパティで行うことができます。

必ず先頭に「sysparm_query=」を付加し、「sysparm_query=numberENDSWITH100」のようにしてください。そうしないと、正しく機能しません。

オプション B: ブラウザーからクエリ文字列をコピーする。

このオプションでは、付加手順として何か追加することを覚えておく必要はありません。 [ 新規ウィンドウを開く ] オプションを使用する場合は、以下のようにクエリ文字列をコピーして貼り付けることができます。

ステップ１:

前述のオプション A と同様に、使用するフィルターを作成します。

  ステップ 2: 右クリックして、[新規ウィンドウを開く] メニュー オプションを選択します。

ステップ 3: クエリ文字列全体 (疑問符「?」より後のすべて) をコピーします。 次に、以下に示すように、これを [複数の ServiceNow レコードを検索] アクティビティの [クエリをテスト] ダイアログに直接貼り付けます。