キュー アイテムを取得

UiPath.Core.Activities.GetQueueItems

説明

指定した Orchestrator キューから、作成日、優先度、ステート、参照などの複数のフィルターに従って、100 件までのトランザクションのリストを取得できます。[ページネーション] プロパティを使用すると、異なるセットを取得できます。

このアクティビティの使用例については、こちらをご覧ください。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

クロスプラットフォーム、Windows での設定

• Orchestrator フォルダー パス - 指定したキューがあるフォルダーのパスです (プロセスが実行されているフォルダーと異なる場合)。このフィールドでは文字列値のみがサポートされており、サブフォルダーを示す区切り文字として / を使用します。例: "Finance/Accounts Payable"

  注:

  Orchestrator Folder Path パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。モダン フォルダー内のロボットのみが、フォルダー外にデータを渡すことができます。

  X-UIPATH-FolderPath-Encoded ヘッダーでは、以下のように相対フォルダー パスがサポートされています。

  • / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。
  • . で始まるパス - 周囲のフォルダーから開始します。
  • .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。

  末尾にスラッシュを付けることはできません。

• キュー名 - データの抽出元のキューの名前です。この名前は、大文字と小文字の表記も含め、Orchestrator での名前と同じにする必要があります。

¹ソリューションの一部として Studio Web で作成されたクロスプラットフォーム プロジェクトの場合、[ Orchestrator のフォルダー パス ] フィールドは利用できません。

²ソリューションの一部として Studio Web で作成されたクロスプラットフォーム プロジェクトの場合、[ 名前 ] フィールドには、設計時にキュー、アセット、ストレージ バケットなどの 新しい Orchestrator リソースを定義するか、リソース管理のために [Orchestrator を開く] を選択する オプションが用意されています。

詳細オプション

オプション

• 期間 - 前の試行に費やした最小時間を使用して、トランザクションをフィルター処理します。
• 最大作成日時 - 最小作成日までのトランザクションをフィルター処理します。DateTime 値を受け入れます。
• 最大作成日時 - 最大作成日に応じて、トランザクションをフィルター処理します。DateTime 値を受け入れます。

• 優先度 - 優先度に従ってトランザクションをフィルター処理します。このフィールドでは整数と整数の変数のみサポートされています。優先度は次のとおりです。

  • 0 - 高
  • 1 - 普通
  • 2 - 低

• キュー アイテム ステート - キュー アイテムのステートをフィルター処理します。次のオプションが利用できます。

  • All - 既定のオプションです。
  • New
  • InProgress
  • 失敗
  • 成功
  • Abandoned
  • Retried
  • Deleted

• フィルター ストラテジ - 参照に従ってフィルター処理するときに使用する方法です。次のオプションを使用できます。

  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• 参照 - Orchestrator キュー アイテムを参照でフィルター処理します。式は 128 文字までで、一重引用符 (') を含めることもできません。
• スキップ - 最初の「n」個の項目をスキップできます。このプロパティでは整数と整数の変数のみサポートされています。
• 上 - 合計から指定された数の項目だけを返します。最大値は 100 です。このプロパティでは整数と整数の変数のみサポートされています。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でもプロジェクトの実行を継続するかどうかを指定します。このフィールドで使用できるのは Boolean 値 (True、False) のみです。既定値は False であるため、このフィールドを設定していない場合にエラーが発生すると、プロジェクトの実行は停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

出力

• キュー アイテム - Orchestrator から取得済みとしてマークする項目のリストです。このプロパティでは IEnumerable<QueueItem> 変数のみサポートされています。

Windows - レガシでの設定

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
• 表示名 - アクティビティの表示名です。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

入力

• キュー名 - データの抽出元のキューの名前です。この名前は、大文字と小文字の表記も含め、Orchestrator での名前と同じにする必要があります。

その他

• フォルダー パス - 指定されたキューがあるフォルダーのパスです (プロセスが実行されているフォルダーと異なる場合)。このフィールドでは文字列値のみがサポートされており、サブフォルダーを示す区切り文字として / を使用します。例: "Finance/Accounts Payable"

  注:

  Folder Path パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。モダン フォルダー内のロボットのみが、フォルダー外にデータを渡すことができます。

  X-UIPATH-FolderPath-Encoded ヘッダーでは、以下のように相対フォルダー パスがサポートされています。

  • / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。
  • . で始まるパス - 周囲のフォルダーから開始します。
  • .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。

  末尾にスラッシュを付けることはできません。

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

• 期間 - 前の試行に費やした最小時間を使用して、トランザクションをフィルター処理します。
• 最大作成日時 - 最小作成日までのトランザクションをフィルター処理します。DateTime 値を受け入れます。

• 優先度 - 優先度に従ってトランザクションをフィルター処理します。このフィールドでは整数と整数の変数のみサポートされています。優先度は次のとおりです。

  • 0 - 高
  • 1 - 普通
  • 2 - 低

• キュー アイテム ステート - キュー アイテムのステートをフィルター処理します。次のオプションが利用できます。

  • All - 既定のオプションです。
  • New
  • InProgress
  • 失敗
  • 成功
  • Abandoned
  • Retried
  • Deleted
• 最大作成日時 - 最大作成日に応じて、トランザクションをフィルター処理します。DateTime 値を受け入れます。

出力

• キュー アイテム - Orchestrator から取得済みとしてマークする項目のリストです。このプロパティでは IEnumerable<QueueItem> 変数のみサポートされています。

ページネーション

• スキップ - 最初の「n」個の項目をスキップできます。このプロパティでは整数と整数の変数のみサポートされています。
• 上 - 合計から指定された数の項目だけを返します。最大値は 100 です。このプロパティでは整数と整数の変数のみサポートされています。

参照

• フィルター ストラテジ - 参照に従ってフィルター処理するときに使用する方法です。次のオプションを使用できます。

  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• 参照 - Orchestrator キュー アイテムを参照でフィルター処理します。式は 128 文字までで、一重引用符 (') を含めることもできません。