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

UiPath.DataService.Activities.QueryEntityRecords<UiPath.DataService.Definition.IEntity>

説明

選択されたエンティティに対し、指定されたフィルターに従ってレコードのリストを UiPath Data Service から取得します。

プロジェクトの対応 OS

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

デザイナー パネル

• エンティティ - アクティビティで使用するエンティティを選択します。このプロパティは、Data Service からインポートされたエンティティのみをサポートします。

• クエリ - エンティティを選択すると、クエリを設定するようウィザードで求められます。

  フィルター ビルダーでは次の手順を行います。

  1. [条件を追加] または [グループを追加] をクリックします。最初のドロップダウン メニューで、選択されたエンティティ型をフィルター処理するときの基準となるフィールドを選択します。関連する任意のエンティティのフィールドを選択することもできます。

  2. 2 つ目のドロップダウン メニューで、選択されたフィールドを評価するための演算子を選択します。演算子のリストは、最初のドロップダウン メニューで選択されたフィールドの型によって変化します。

  3. 3 つ目の式フィールドには、選択されたフィールドに対する値または式を入力します。サポートされる値は、最初のドロップダウン メニューで選択されたフィールドの型によって変化します。

  4. 他の条件またはグループを追加する場合は [条件を追加] をクリックし、[すべて] または [いずれか] のどちらの条件を使用してフィルター処理するかを選択します。

プロパティ パネル

オプション

• 並べ替えフィールド - 取得したレコードを並べ替える基準となるフィールドの名前です。この名前は、大文字と小文字の区別も含め、選択したエンティティの型の有効なフィールド名と同一である必要があります。既定では、このフィールドは [Id] に設定されます。

• 昇順で並べ替え - [並べ替え] プロパティで指定したフィールドに基づいて、レコードを昇順に並べ替えます。このフィールドは Boolean 値 (True、False) のみをサポートします。既定値は True です。

• 上限 - すべてのレコードのうち、取得するレコードの最大数を指定します。このプロパティは 1 から 1000 までの値をサポートしています。このフィールドの既定値は 100 です。

• スキップ - 指定した件数だけレコードをスキップできます。指定された値がレコードの合計数より大きい場合、レコードは取得されません。このプロパティは、0 以上の値をサポートし、既定では、0 に設定されます。

• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

• 関連レコードの深さ - サービスから取得する関連レコードの深さを指定します。このプロパティは 1 から 3 までの値をサポートします。既定値は 2 です。

出力

• レコードの合計数 - 指定したクエリ フィルターに一致するレコードの合計数であり、Int64 型の変数に格納されます。このフィールドは Int64 型変数のみをサポートします。

• 出力レコード - Data Service から取得したレコードのリストです。このフィールドは、Data Service からインポートされる型の List オブジェクトのみをサポートし、選択されたエンティティの型と同じ型である必要があります。