「複数レコードのルックアップ」アクション
定義された条件を使用して、任意のテーブルで複数のレコードを検索します。
ロールと可用性
ワークフロースタジオ ServiceNow コアアクションとして利用可能です。flow_designer または admin ロールを持つユーザーは、アクションをフローに追加し、構成の詳細を定義できます。
入力
フローに必要な各入力の値を指定します。動的な値を追加するには、[データ] パネルからピルをドラッグするか、ピルピッカーから選択します。
- テーブル
- データタイプ：Table Name
検索するレコードを含むテーブル名。
- 条件
- データタイプ：Conditions
レコードの検索に使用するフィールド名とフィールド値。インラインスクリプトを使用して条件を指定する場合は、GlideRecord クラスおよび GlideQueryCondition クラスを使用してクエリをビルドすることを検討してください。「GlideRecord - Global」および「GlideQueryCondition - Global」を参照してください。
- 順番
- データタイプ：Field Name
結果をソートするために使用するフィールド。
- ソートタイプ
- データタイプ：Choice
アルファベット順に昇順または降順でソートするためのオプション。
- 結果の最大数
- データタイプ：Integer
アクションが返すことができるレコード結果の最大数。
出力
これらの出力は [データ] パネルに表示されます。フローの他の場所で入力として使用できます。
- レコード
- データタイプ：Records
指定したルックアップ条件に基づいて見つかったレコードのシステム ID のリスト。詳細については、「レコード.[テーブル] データ型」を参照してください。
- テーブル
- データタイプ：Table Name
レコードリストを含むテーブル。
- カウント
- データタイプ：Integer
アクションによって返されたレコードの数。
一般的なガイドライン
[レコードを検索] アクションを操作するときは、次の一般的なガイドラインを使用してください。
- For Each フローロジックでレコードを処理する
- For Each フローロジックを使用してレコードリストを反復処理します。For Each フローロジックの使用の詳細については、「For Each フローロジック」を参照してください。
- 結果の最大数を設定してパフォーマンスを向上させる
- フローのパフォーマンスを向上させるには、[結果の最大数] 入力を 1,000 レコード以下に設定します。システムが検索する必要があるレコードが多いほど、それらの識別と処理に必要なシステムリソースが増大します。
- 条件を使用してレコードをフィルタリング
- 条件を使用して、アクションから返されるレコードの数を制限します。指定できる条件が具体的であればあるほど、フローのパフォーマンスは向上します。
変更要求ユーザーにアサインされた構成アイテムを検索
この例では、[ネットワーク] カテゴリで緊急の変更要求がオープンされると、フローが開始されます。[レコードの検索] アクションは、構成アイテム [cmdb_ci] テーブルをテーブルの入力として使用します。[条件] の入力は、変更要求の要求者にアサインされた構成アイテムを検索します。[順番] の入力では、[名前] フィールドを使用してアルファベットの昇順のソートを実行します。
実行の詳細では、[カウント] の出力には、変更要求の要求者にアサインされた 3 つの構成アイテムが示されます。[レコード] の出力では、実行の詳細ページに構成アイテムが名前で表示されますが、データピルには一連の Sys ID 値が含まれています。[テーブル] の出力は構成アイテム [cmdb_ci] テーブルです。