トランザクション アイテムを取得

UiPath.Core.Activities.GetQueueItem

説明

処理ができるように Orchestrator のキューからアイテムを取得し (トランザクションを開始し)、そのステータスを進行中に設定します。 処理を開始すると、トランザクションになります。

The activity runs under the Robot which executes it. For the exact permissions it requires, see the Orchestrator permissions note below.

キューが空の場合、取得された TransactionItem にアクセスする際に次のエラーがスローされます：System.Exception: Object reference not set to an instance of an object.

注:

Orchestrator の権限

This activity runs under the Orchestrator account of the robot that executes it. It must hold the following Orchestrator role permissions on the target folder:

• Queues.View: used to resolve the target queue
• Transactions.View: used to read queue item and transaction data
• Transactions.Create: used to create the queue item or start its transaction
• Transactions.Edit: used to update or lock the transaction
• Folders.View: used to browse and select the Orchestrator folder

プロジェクトの対応 OS

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

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

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

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

  • / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。
  • / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。
  • . で始まるパス - 周囲のフォルダーから開始します。
  • .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。 末尾にスラッシュを付けることはできません。
• キュー名 - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。Orchestrator フォルダー内のキューを管理するには、[キューを管理] を選択します。

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

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

詳細オプション

オプション

• フィルター方法 - 参照に従ってフィルター処理するときに使用する戦略です。このフィールドは、リテラル値または式を受け入れます。次のオプションが利用できます。
  • Startwith - 参照が、[参照] フィールドに指定した値で開始される項目を検索します。
  • Equals - 参照が、[参照] フィールドに示されている値と同じ項目を検索します。
• Reference - 参照に従って項目をフィルター処理します。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でもプロジェクトの実行を継続するかどうかを指定します。このフィールドで使用できるのは Boolean 値 (True、False) のみです。既定値は False であるため、このフィールドを設定していない場合にエラーが発生すると、プロジェクトの実行は停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

出力

• トランザクション アイテム - 取得したトランザクション アイテムです。QueueItem 変数に格納されています。
• 固有データ - このプロパティは、スキーマ定義を持つキューで使用できます。キューの固有コンテンツのスキーマのプロパティにアクセスできます。 新しいスキーマ バージョンがキューに適用されている場合は、[更新] をクリックして最新の変更を取得します。

Windows - レガシでの設定

プロパティ パネル

オプション

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

入力

• キュー名 - QueueItem オブジェクトを追加するキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。

その他

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

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

  • / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。
  • . で始まるパス - 周囲のフォルダーから開始します。
  • .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。 末尾にスラッシュを付けることはできません。
• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• トランザクション アイテム - 取得したトランザクション アイテムです。QueueItem 変数に格納されています。

参照

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