「レコードのルックアップ」アクション

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

    ロールと可用性

    ワークフロースタジオ ServiceNow コアアクションとして利用可能です。flow_designer または admin ロールを持つユーザーは、アクションをフローに追加し、構成の詳細を定義できます。

    フィールド

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

    返されるレコードが満たす必要がある条件。

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

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

    出力

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

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

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

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

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

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

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

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

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

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

    フロー内の [レコードを検索] アクションの例。