Query Multiple Entity Records

プライマリ エンティティのレコードをクエリする要求を Data Fabric API に送信します。フィールド レベルのフィルターを使用して、必要に応じてセカンダリ エンティティに展開できます。

説明

プライマリ エンティティのレコードをクエリする要求を Data Fabric API に送信します。フィールド レベルのフィルターを使用して、必要に応じてセカンダリ エンティティに展開できます。

このアクティビティは、Data Service クラシック アクティビティ パッケージの同じ名前のアクティビティに相当します。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

サポートされているワークフロー

デスクトップ版の Studio と Studio Web のすべてのワークフロー。

プロパティ

• UiPath Data Fabric connection - Integration Service で確立した Data Fabric のコネクションを選択します。ドロップダウン メニューからコネクションを選択、追加、または管理します。
• 主エンティティ - レコードの取得元の主エンティティを指定します。
• 副エンティティ - 主エンティティと結合する関連エンティティを指定します。
• 結合の種類 - プライマリ エンティティとセカンダリ エンティティの間で行われる結合の種類を定義します。
  • 内部結合 - 選択すると、両方のエンティティに一致する値が存在するレコードのみが返されます。
  • 左結合 - 選択すると、主エンティティからはすべてのレコード、副エンティティからは一致するレコードが返されます。一致するものが存在しない場合、セカンダリ フィールドは null を返します。
• 主エンティティの結合フィールド - 結合関係の確立に使用する主エンティティのフィールドを指定します。
• セカンダリ エンティティの結合フィールド - 結合関係の確立に使用するセカンダリ エンティティのフィールドを指定します。
• フィルター条件 - 主エンティティおよび/または副エンティティのレコードのフィルター条件を定義します。フィルター ビルダーは [エンティティ レコードにクエリを実行] のフィルター ビルダーと同様に機能し、フィールド名は主エンティティと副エンティティの両方から取得されます。

フィルター ビルダーには、エンティティ フィールドの値に基づいてレコードをフィルター処理するために使用できる演算子が一式用意されています。フィールドで使用できる演算子は、そのデータ型によって異なります。

次の表で、サポートされている各演算子と、それが適用されるデータ型について説明します。

[入力] 演算子と [指定外] 演算子には、値をコンマ区切りリストとして入力します。フィールド名にはエンティティ名が先頭に付きます。たとえば、Studentエンティティの Name フィールドは Student_Nameと表示され、リレーションシップ フィールドでは「エンティティ レコードにクエリを実行」のドット記号が使用されます。Student_Nameが John または Jane のレコードのみを返すには、「John,Jane」と入力します。

演算子	説明	適用可能なデータ型
次の値と等しい (=)	フィールド値が指定した値と完全に等しいレコードに一致します。	テキスト、数値、Yes/No、Date-Time、ChoiceSet
等しくない (!=)	フィールド値が指定した値と等しくないレコードに一致します。	テキスト、数値、Yes/No、Date-Time、ChoiceSet
次の値より小さい (<)	フィールド値が指定した値より小さいレコードに一致します。日付フィールドの場合、日付または時刻が前のレコードが返されます。	数値、日付/時刻
次の値以下 (<=)	フィールド値が指定した値以下のレコードに一致します。	数値、日付/時刻
次の値より大きい (<=)	フィールド値が指定した値より大きいレコードに一致します。日付フィールドの場合、日付または時刻が後のレコードが返されます。	数値、日付/時刻
次の値以上 (>=)	フィールド値が指定した値以上のレコードに一致します。	数値、日付/時刻
次の値を含む	フィールド値に指定したテキストが部分文字列として含まれるレコードに一致します。	テキスト
次を含まない	フィールド値に指定したテキストが含まれていないレコードに一致します。	テキスト
次の値で始まる	フィールド値が指定したテキストで始まるレコードに一致します。	テキスト
行末	フィールド値が指定したテキストで終わるレコードに一致します。	テキスト
In	フィールド値が指定したリスト内の任意の値と等しいレコードに一致します。	テキスト、数値、Date-Time、ChoiceSet
次に存在しない	フィールド値が指定したリストのどの値とも等しくないレコードに一致します。	テキスト、数値、Date-Time、ChoiceSet
次の値は null である	フィールド値が null のレコードに一致します。この演算子には入力値は必要ありません。	テキスト、数値、Yes/No、Date-Time、ChoiceSet
次の値は null ではない	フィールドに null 以外の値が含まれているレコードに一致します。この演算子には入力値は必要ありません。	テキスト、数値、Yes/No、Date-Time、ChoiceSet
True である	Yes/No フィールドが True のレコードに一致します。この演算子には入力値は必要ありません。	Yes/No
False である	[はい]/[いいえ] フィールドが [False] のレコードに一致します。この演算子には入力値は必要ありません。	Yes/No

オプション

• スキップ - 先頭からスキップするレコードの数を指定します。
• 上位 - 返されるレコードの最大数を指定します。このプロパティは 1 から 1000 までの値をサポートしています。既定値は 100 です。
• 昇順に並べ替え - 昇順 (True) または降順 (False) のどちらで並べ替えるかを指定します。
• フィールドで並べ替え - 返されたレコードの並べ替えに使用するフィールドを指定します。

出力

• 複数のエンティティ レコードにクエリを実行 — 選択した 2 つのエンティティを結合し、指定したフィルターを適用することで生成されたレコードのリストを返します。各レコードには、呼び出し元が両方のエンティティでアクセスできるすべてのフィールドが含まれます。