エンティティ レコードにクエリを実行

[エンティティ レコードにクエリを実行] ノード: Integration Service のコネクションなしで、フロー内の Data Fabric エンティティから 1 つ以上のレコードを読み取るために使用します。

Data Fabric エンティティから 1 つ以上のレコードを読み取ります。これはネイティブのフロー ノードであり、Integration Service (IS) のコネクションは必要ありません。Data Fabric プラットフォームの既存のエンティティ (テナント エンティティとフォルダー エンティティの両方) および VS Code ソリューションで定義されたエンティティで機能します。「 VS Code のエンティティ」をご覧ください。

構成

フィールド	Required	説明
Data Fabric エンティティ	はい	クエリを実行するエンティティです。ノードの追加後にエンティティのフィールドが変更された場合は、[ スキーマを更新 ] を選択します。
返すレコードの数	はい	単一のレコードは 1 つのレコードを返し、フィルターが複数のレコードと一致すると失敗します。[Multiple records] は、一致するレコードの配列を返します。
フィルター条件	いいえ	1 つ以上のフィールド/演算子/値の条件に、[ すべて] (AND) または [任意] (OR) と組み合わされています。
並べ替え (複数のレコードのみ)	いいえ	結果を並べ替える条件と方向 (昇順 または降 順) です。ソートを指定しない場合、クエリは毎回異なるレコード セットを返す可能性があります。
スキップするレコード (複数のレコードのみ)	いいえ	結果を返す前にスキップする一致するレコードの数です。既定 0です。
レコードの制限 (複数のレコードのみ)	いいえ	返すレコードの最大数既定値は 100、最大 1000です。

[ 条件をフィルター] 内で、同じレベルの別の条件の [条件を追加] を選択するか、[ グループを追加 ] を選択して、独自の AND/OR ロジックを持つ条件グループを入れ子にします。

このノードは [ エラー処理 ] タブをサポートしていません。

出力

単一レコードの場合、出力フィールドはエンティティのスキーマを直接反映します。[複数レコード] の場合、出力はresults配列で、各項目はエンティティのスキーマを反映しています。下流で $vars.<nodeId>.output.<fieldName> (単一のレコード) または $vars.<nodeId>.output.results[<index>].<fieldName> (複数のレコード) としてアクセスします。

ライブ リファレンスの動作

出力はクエリへの ライブ参照 であり、結果の保存コピーではありません。それを読み取るすべての式、条件、またはスクリプトは、その時点でクエリを再実行するため、常にエンティティの現在のデータを参照できます。スキーマ・ツリーの LIVE QUERY チップは、このように動作する出力をマークします。

たとえば、[エンティティ レコードを検索] ノードで [チケットを探す] ノードがステータスが Openのチケットを返し、フロー内の後のノードでそのチケットを Closedに設定した場合、その時点以降に式$vars.Find ticket.output.Statusを読み取ると、クエリで最初に検出されたOpen値ではなく、Closed が返されます。保存されたコピーでは、引き続き と表示されます Open。

[エンティティ 参照] に設定された [ エンティティ レコードを更新] と[エンティティ レコード を削除] は、エンティティとフィルターを再指定せずに、このクエリで見つかったレコードに対して動作します。

ループ コレクションとデータ変換コレクションは例外です。彼らは、クエリを再実行するのではなく、ノードの実行時に取得された結果のスナップショットを読み取ります。