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 を返します。
• 主エンティティの結合フィールド - 結合関係の確立に使用する主エンティティのフィールドを指定します。
• セカンダリ エンティティの結合フィールド - 結合関係の確立に使用するセカンダリ エンティティのフィールドを指定します。
• Filter conditions - Define filtering criteria for records from the primary and/or secondary entity. The filter builder works like the one in Query Entity Records, and field names are drawn from both the primary and secondary entities.

The Filter Builder provides a set of operators that you can use to filter records based on the values of entity fields. The operators available for a field depend on its data type.

The following table describes each supported operator and the data types it applies to.

For the In and Not In operators, enter values as a comma-separated list. Field names are prefixed with the entity name — for example, the Name field in the Student entity appears as Student_Name, and relationship fields use the dotted notation from Query Entity Records. To return only records where Student_Name is John or Jane, enter John,Jane.

演算子	説明	Applicable data types
Equals (=)	Matches records where the field value is exactly equal to the specified value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Not Equals (!=)	Matches records where the field value is not equal to the specified value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Less Than (<)	Matches records where the field value is less than the specified value. For date fields, this returns records with an earlier date or time.	Number, Date-Time
Less Than Or Equal (<=)	Matches records where the field value is less than or equal to the specified value.	Number, Date-Time
Greater Than (>)	Matches records where the field value is greater than the specified value. For date fields, this returns records with a later date or time.	Number, Date-Time
Greater Than Or Equal (>=)	Matches records where the field value is greater than or equal to the specified value.	Number, Date-Time
次の値を含む	Matches records where the field value contains the specified text as a substring.	テキスト
次を含まない	Matches records where the field value does not contain the specified text.	テキスト
次の値で始まる	Matches records where the field value begins with the specified text.	テキスト
行末	Matches records where the field value ends with the specified text.	テキスト
In	Matches records where the field value is equal to any value in a specified list.	Text, Number, Date-Time, ChoiceSet
Not In	Matches records where the field value is not equal to any value in the specified list.	Text, Number, Date-Time, ChoiceSet
Is Null	Matches records where the field value is null. This operator does not require an input value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Is Not Null	Matches records where the field contains a non-null value. This operator does not require an input value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Is True	Matches records where a Yes/No field is True. This operator does not require an input value.	Yes/No
Is False	Matches records where a Yes/No field is False. This operator does not require an input value.	Yes/No

オプション

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

出力

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