キュー アイテムを待機

UiPath.Core.Activities.WaitQueueItem

説明

指定されたキューから Orchestorator のキュー アイテムを取得し、QueueItem 型変数に格納します。このアクティビティは、[トランザクション アイテムを取得] アクティビティとは異なり、実行時に、指定したキューが空になっている場合、キュー受け入れ準備完了のメッセージを Orchestrator に送信し、指定したキューに新しいキュー アイテムが追加されるのを待ちます。アイテムを取得すると、そのキュー アイテムのステータスは [進行中] に設定されます。

プロジェクトの対応 OS

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

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

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

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

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

  -right: / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。

  -right: . で始まるパス - 周囲のフォルダーから開始します。

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

  末尾にスラッシュを付けることはできませんのでご注意ください。

• キュー名 - キュー アイテムの検索を行うキューの名前です。このフィールドは、文字列と String 型変数のみをサポートします。

  注: [キュー アイテムを待機] アクティビティがロボットのリアルタイムの通信方法を使用するには、システム アクティビティ パッケージのバージョンと Orchestrator のバージョンが両方とも v20.10 より古いか、両方とも v20.10 より新しい必要があります。それ以外の場合、[キュー アイテムを待機] アクティビティはロボットのリアルタイムの通信方法を使用せず、このアクティビティの最大遅延はハートビート間隔の持続時間に等しくなります。ハートビート間隔の既定の持続時間は 30 秒で、Orchestrator で設定できます。

詳細オプション

オプション

• ポーリング時間 (ミリ秒) - 新しいアイテムの取得を試行する間隔 (ミリ秒) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

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

  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• Reference - 参照に従って項目をフィルター処理します。
• タイムアウト (ミリ秒) - エラーがスローされるまでアクティビティの実行を待機する時間 (ミリ秒単位) を指定します。既定値は 300000 ミリ秒 (300 秒) です。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。その結果、フィールドを設定していない場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、エラーの発生に関係なくプロジェクトの実行は継続されます。

出力

• 結果 - 取得したキュー アイテムです。QueueItem 変数に格納されます。

Windows - レガシでの設定

プロパティ パネル

共通

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

• タイムアウト (ミリ秒) - エラーがスローされるまでアクティビティの実行を待機する時間 (ミリ秒単位) を指定します。既定値は 300000 ミリ秒 (300 秒) です。

  注: [キュー アイテムを待機] アクティビティがロボットのリアルタイムの通信方法を使用するには、システム アクティビティ パッケージのバージョンと Orchestrator のバージョンが両方とも v20.10 より古いか、両方とも v20.10 より新しい必要があります。それ以外の場合、[キュー アイテムを待機] アクティビティはロボットのリアルタイムの通信方法を使用せず、このアクティビティの最大遅延はハートビート間隔の持続時間に等しくなります。ハートビート間隔の既定の持続時間は 30 秒で、Orchestrator で設定できます。

入力

• ポーリング時間 (ミリ秒) - 新しいアイテムの取得を試行する間隔 (ミリ秒) を指定します。既定値は 30000 ミリ秒 (30 秒) です。
• キュー名 - キュー アイテムの検索を行うキューの名前です。このフィールドは、文字列と String 型変数のみをサポートします。

その他

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

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

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

  -right: / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。

  -right: . で始まるパス - 周囲のフォルダーから開始します。

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

  末尾にスラッシュを付けることはできませんのでご注意ください。

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

出力

• 結果 - 取得したキュー アイテムです。QueueItem 変数に格納されます。

参照

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

  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• Reference - 参照に従って項目をフィルター処理します。