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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • 定義された条件に基づいてテーブルからレコードを検索します。

    ロールと可用性

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

    フィールド

    フィールド 説明
    テーブル リストからテーブルを選択します。
    条件

    レコードをフィルタリングするための静的条件または動的条件を設定します。アクションが実行されるたびに適用される静的条件を定義するには、条件ビルダーで条件を定義します。フローデザイナーが条件を動的に適用できるようにするには、条件タイプの入力を定義し、入力データピルを [条件] フィールドにドラッグアンドドロップします。

    参照フィールドの値を検索する条件をビルドする場合は、システム ID 値を明示的に指定するデータピルを使用します。条件の形式が [参照フィールド][次の値に等しい][参照タイプデータピル->システム ID] であることを確認します。たとえば、変更テーブルとインシデントテーブルの両方に、ユーザーテーブルへの参照フィールドが含まれます。要求者が問い合わせユーザーである変更レコードをインシデントレコードから検索するには、条件 [要求者][次の値に等しい][トリガー->インシデントレコード->問い合わせユーザー->システム ID] を作成します。 [要求者][次の値に等しい][アクション->インシデント->問い合わせユーザー->システム ID]。ここでインシデントはインシデントレコードの入力変数です。

    順番 定義された条件に複数のレコードが一致する場合に結果をソートする方法を決定します。結果をソートするために使用するフィールドを選択します。
    ソートタイプ アルファベット順に昇順または降順でソートするかどうかを選択します。
    複数のレコードが見つかった場合 定義された条件に複数のレコードが一致する場合に返される内容を決定します。
    • 最初のレコードのみを返す
    • ステップを失敗させる
    エラーがあっても続行する (Don't fail on error) レコードが見つからない場合にフローを失敗させるかどうかを決定します。

    出力

    これらの出力は [データ] パネルに表示されます。フローの他の場所で入力として使用できます。

    レコード
    データタイプ:Record

    Conditions 入力で指定した条件に基づいて検出されたレコード。

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

    返されたレコードに関連付けられたテーブル名。

    ステータス
    データタイプ:Choice

    レコードが正常に見つかった場合は 1、エラーがあった場合は 0。

    エラーメッセージ
    データタイプ:String

    レコードが見つからなかった理由の詳細を含むメッセージ。

    注:
    この出力の値は、Status 出力の値が 0 の場合にのみ設定されます。

    アクションエラー評価

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

    次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「アクションエラー評価」を参照してください。

    アクション内の「レコードのルックアップ」ステップの例。