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