トランザクションのステータスを設定

UiPath.Core.Activities.SetTransactionStatus

説明

Orchestrator のトランザクション アイテムのステータスを [失敗] または [成功] に設定します。このアクティビティの使用例については、こちらをご覧ください。

注:

• Orchestrator のキューに追加され、必須としてマークされたスキーマ定義値は、アクティビティのディクショナリ ビルダーに自動的にインポートされます。
• 必須ではないとマークされた値は、キュー アイテムに追加できますが、適用されません。

プロジェクトの対応 OS

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

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

• フォルダー パス - トランザクション アイテムがあるフォルダーのパスで、ププロセスが実行されているフォルダーと異なる場合に使用されます。このフィールドでは文字列値のみがサポートされており、サブフォルダーを示す区切り文字として / を使用します。例: "Finance/Accounts Payable"
  注:

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

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

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

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

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

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

• TransactionItem - ステータスを更新する TransactionItem です。
• Status - TransactionItem に設定するステータスです。

詳細オプション

入力

• キュー名 - スキーマ定義を選択するキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。最大文字数は 50 文字です。
• Analytics - ステータスを更新する特定の TransactionItem についての分析情報のコレクションです。
• Output - ステータスを更新する特定の TransactionItem についての補足情報のコレクションです。
  注: 失敗したトランザクションの Output プロパティを設定できるのは、2022.10 以降のバージョンの Orchestrator に接続されている場合のみです。

その他

• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。
• エラー発生時に実行を継続 - 現在のアクティビティが失敗した場合に残りのアクティビティの実行を継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。

トランザクション エラー

• 詳細 - 失敗したトランザクションに関する詳細です。このフィールドは、文字列と String 型変数のみをサポートします。ログ情報や、失敗に関するその他の詳細情報を配置できます。
• ErrorType - 失敗したトランザクションがスローしたエラーの種類です。Application - 技術的な問題 (たとえば、見つからないファイル)、この種類のエラーは、Orchestrator の設定に従ってトランザクションをリトライします。Business - 外部要因 (たとえば、支払えなかった請求書) に関するエラーです。この選択の詳細については、「ビジネス例外とアプリケーション例外」をご覧ください。
• 理由 - トランザクションが失敗した理由です。このフィールドは、文字列と String 型変数のみをサポートします。たとえば「文字 F を含まない」など、任意の簡潔な理由を配置できます。

Windows - レガシでの設定

プロパティ パネル

共通

• エラー発生時に実行を継続 - 現在のアクティビティが失敗した場合に残りのアクティビティの実行を継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。
• 表示名 - アクティビティの表示名です。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

入力

• Analytics - ステータスを更新する特定の TransactionItem についての分析情報のコレクションです。
• Output - ステータスを更新する特定の TransactionItem についての補足情報のコレクションです。
  注: 失敗したトランザクションの Output プロパティを設定できるのは、2022.10 以降のバージョンの Orchestrator に接続されている場合のみです。
• Status - TransactionItem に設定するステータスです。
• TransactionItem - ステータスを更新する TransactionItem です。

その他

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

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

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

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

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

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

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

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

トランザクション エラー

• 詳細 - 失敗したトランザクションに関する詳細です。このフィールドは、文字列と String 型変数のみをサポートします。ログ情報や、失敗に関するその他の詳細情報を配置できます。
• ErrorType - 失敗したトランザクションがスローしたエラーの種類です。Application - 技術的な問題 (たとえば、見つからないファイル)、この種類のエラーは、Orchestrator の設定に従ってトランザクションをリトライします。Business - 外部要因 (たとえば、支払えなかった請求書) に関するエラーです。この選択の詳細については、「ビジネス例外とアプリケーション例外」をご覧ください。
• 理由 - トランザクションが失敗した理由です。このフィールドは、文字列と String 型変数のみをサポートします。たとえば「文字 F を含まない」など、任意の簡潔な理由を配置できます。