キュー アイテムを待機

[キュー アイテムを待機] アクティビティ。指定したキューから Orchestorator のキュー アイテムを取得し、QueueItem 変数に格納します。

UiPath.Core.Activities.WaitQueueItem

説明

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

注:

Orchestrator の権限

このアクティビティは、実行するロボットの Orchestrator アカウントで実行されます。ターゲット フォルダーに対する以下の Orchestrator ロールの権限 を保持している必要があります。

• Queues.View: 対象のキューを解決するために使用します
• Transactions.View: キュー アイテムとトランザクション データを読み取るために使用します
• Transactions.Create: キュー アイテムの作成またはトランザクションの開始に使用します
• Transactions.Edit: トランザクションを更新またはロックするために使用します。
• Folders.View: Orchestrator フォルダーを参照して選択するために使用します

プロジェクトの対応 OS

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

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

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

  注:

  Orchestrator FolderPath パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。フォルダー外にデータを渡せるのは、モダン フォルダー内のロボットだけです。X-UIPATH-FolderPath-Encoded ヘッダーでは、次のように相対フォルダー パスがサポートされています。

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

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

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

  注:

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

¹For cross-platform projects created in Studio Web as part of a solution, the Orchestrator folder path field is unavailable. If the activity had a folder path before it became part of the solution, the field is displayed as read-only, and that folder overrides the solution resource. Selecting the resource again removes the folder.

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

詳細オプション

オプション

• ポーリング時間 (ミリ秒) - 新しいアイテムの取得を試行する間隔 (ミリ秒) を指定します。既定値は 30000 ミリ秒 (30 秒) です。
• フィルター方法 - 参照に従ってフィルター処理するときに使用する戦略です。このフィールドは、リテラル値または式を受け入れます。次のオプションが利用できます。
  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• 参照 - 参照に従って項目をフィルター処理します。式は 128 文字までで、一重引用符 ( ') を含めることもできません。
• タイムアウト (ミリ秒) - アクティビティの実行が完了するまで待機する時間をミリ秒単位で指定します。指定した時間が経過しても実行が完了しない場合には例外をスローします。既定値は 300000 ミリ秒 (300 秒) です。Orchestrator への接続を開く時間は、この値に関係なく、常に 30 秒に制限されます。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションの実行を継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。このフィールドが設定されていない場合、エラーが発生するとプロジェクトの実行は停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
• Convert dates to local time - When on, the dates on the returned queue item (deadline, postpone date, transaction start, and last processing time) are converted from UTC to the local time of the robot machine. When left empty, the project setting Convert dates to local time under Project Settings > System > Queues applies. That setting is on by default for new projects and off for projects created with an earlier System package version, so existing workflows keep receiving UTC values. The project settings for queues are available in Windows projects.

出力

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

Windows - レガシでの設定

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
• 表示名 - アクティビティの表示名です。
• タイムアウト (ミリ秒) - アクティビティの実行が完了するまで待機する時間をミリ秒単位で指定します。指定した時間が経過しても実行が完了しない場合には例外をスローします。既定値は 300000 ミリ秒 (300 秒) です。Orchestrator への接続を開く時間は、この値に関係なく、常に 30 秒に制限されます。
  注:

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

入力

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

その他

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

  注:

  Folder Path パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。フォルダー外にデータを渡せるのは、モダン フォルダー内のロボットだけです。X-UIPATH-FolderPath-Encoded ヘッダーでは、次のように相対フォルダー パスがサポートされています。

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

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

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

出力

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

参照

• フィルター ストラテジ - 参照に従ってフィルター処理するときに使用する方法です。次のオプションを使用できます。
  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• 参照 - 参照に従って項目をフィルター処理します。式は 128 文字までで、一重引用符 ( ') を含めることもできません。