トランザクション アイテムを追加

UiPath.Core.Activities.AddTransactionItem

説明

キューに新しいアイテムを追加し、トランザクションを開始します。項目のステータスは [進行中] に設定されます。項目を QueueItem 変数として返します。

注:

UiPath.Core.Activities.AddTransactionItem アクティビティがプロセスで機能するためには、ロボットが Orchestrator に接続されている必要があります。これは、キュー、アイテム、およびステータスに関する情報を送信および取得するために必要です。

プロジェクトの対応 OS

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

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

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

  注:

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

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

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

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

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

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

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

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

詳細オプション

入力

• Reference - 追加する QueueItem の参照です。
• トランザクション情報 - 追加する特定の TransactionItem に関するその他の情報のコレクションです。情報はアイテムに保存され、トランザクション処理中に使用されます。文字列引数の値に [ や " " は使用できません。また、引数名に :、.、,、@、" は使用できません。

その他

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

  このアクティビティが [トライ キャッチ] アクティビティに含まれており、[エラー発生時に実行を継続] プロパティの値が true である場合は、プロジェクトの実行時にエラーはキャッチされません。

出力

• トランザクション アイテム - 追加したトランザクション アイテムへの参照です。

Windows - レガシでの設定

プロパティ パネル

入力

• キュー名 - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。
• Reference - 追加する QueueItem の参照です。
• トランザクション情報 - 追加する特定の TransactionItem に関するその他の情報のコレクションです。情報はアイテムに保存され、トランザクション処理中に使用されます。文字列引数の値に [ や " " は使用できません。また、引数名に :、.、,、@、" は使用できません。

共通

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

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が true である場合、プロジェクトの実行時にエラーが捕捉されません。

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

その他

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

  注:

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

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

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

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

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

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

出力

• トランザクション アイテム - 追加したトランザクション アイテムです。