---
sourceDocument: Yokohama ビルドのワークフロー
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama ビルドのワークフロー

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# 「複数レコードのルックアップ」ステップ

# 「複数レコードのルックアップ」ステップ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

定義された条件を使用して、任意のテーブルで複数のレコードを検索します。

## ロールと可用性 {#lookup-records-action-designer__section_pwq_rb5_kcb}

ワークフロースタジオ アクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。

## 入力 {#lookup-records-action-designer__section_lx4_cfl_kyb}

アクションに必要な各入力の値を指定します。動的な値を追加するには、\[データ\] パネルからピルをドラッグするか、ピルピッカーから選択します。{#lookup-records-action-designer__inputs-description}

テーブル
:   データタイプ：Table Name

    検索するレコードを含むテーブル名。

条件
:   データタイプ：Conditions

    レコードの検索に使用するフィールド名とフィールド値。インラインスクリプトを使用して条件を指定する場合は、GlideRecord クラスおよび GlideQueryCondition クラスを使用してクエリをビルドすることを検討してください。「[GlideRecord - Global](https://www.servicenow.com/docs/access?context=c_GlideRecordAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」および「[GlideQueryCondition - Global](https://www.servicenow.com/docs/access?context=c_GlideQueryConditionAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。

順番
:   データタイプ：Field Name

    結果をソートするために使用するフィールド。

ソートタイプ
:   データタイプ：Choice

    アルファベット順に昇順または降順でソートするためのオプション。

結果の最大数
:   データタイプ：Integer

    ステップが返すことができるレコード結果の最大数。

## アクションエラー評価 {#lookup-records-action-designer__id_lg2_4s3_15b}

このステップが失敗した場合
:   データタイプ：Choice

    次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「[アクションエラー評価](https://servicenow-prod.fluidtopics.net/I4OsrWdiNF4J~7LkWG~O7w "アクションを有効化してステップの失敗を検出し、実行を継続します。特定のエラー状態が発生するタイミングを特定して、独自のアクションステータスコード、ステータスメッセージ、エラー状態を返します。")」を参照してください。

## 出力 {#lookup-records-action-designer__section_zch_jln_lyb}

これらの出力は \[データ\] パネルに表示されます。フローの他の場所で入力として使用できます。{#lookup-records-action-designer__outputs-description}

レコード
:   データタイプ：Records

    指定したルックアップ条件に基づいて見つかったレコードのシステム ID のリスト。詳細については、「[レコード.\[テーブル\] データ型](R394d44Z849e1z_5acOAhA "レコードに対する 1 つ以上の Sys ID 参照を特定のテーブルに格納します。レコードデータ形式は、GlideRecord Sys ID 値のリストを格納するため、Glide リストとも呼ばれます。")」を参照してください。

テーブル
:   データタイプ：Table Name

    レコードリストを含むテーブル。

カウント
:   データタイプ：Integer

    ステップが返したレコードの数。

## 一般的なガイドライン {#lookup-records-action-designer__section_x2g_czf_gcc}

\[レコードを検索\] アクションを操作するときは、次の一般的なガイドラインを使用してください。  

For Each フローロジックでレコードを処理する
:   For Each フローロジックを使用してレコードリストを反復処理します。For Each フローロジックの使用の詳細については、「[For Each フローロジック](https://servicenow-prod.fluidtopics.net/A347a3jfRAndQ4Y3sA1uHg "レコードリスト内の各レコードに 1 つ以上のアクションを適用します。")」を参照してください。または、スクリプトステップを使用して、カスタムアクション内のレコードリストを処理することもできます。

結果の最大数を設定してパフォーマンスを向上させる
:   アクションのパフォーマンスを向上させるには、\[結果の最大数\] 入力を 1,000 レコード以下に設定します。システムが検索する必要があるレコードが多いほど、それらの識別と処理に必要なシステムリソースが増大します。

条件を使用してレコードをフィルタリング
:   条件を使用して、ステップが返すレコードの数を制限します。指定できる条件が具体的であるほど、アクションのパフォーマンスは向上します。

## 例 {#lookup-records-action-designer__section_zf4_dj5_kcb}