通知を受け取る

UiPath Studio

UiPath Studio ガイド

グローバル例外ハンドラー

グローバル例外ハンドラーは、実行エラーが発生した場合にプロジェクトの動作を決定するよう設計されたワークフローの一種です。オートメーション プロジェクト 1 件につき、グローバル例外ハンドラー を 1 つだけ追加できます。

📘

注:

グローバル例外ハンドラーが使用できるのはプロセスのみです。ライブラリには使用できません。

グローバル例外ハンドラーには 2 個の引数があります。これらは削除してはいけません

1 つ目の引数は In 方向の errorInfo です。スローされたエラーと失敗したワークフローに関する情報を格納します。ログ対象とするエラーレベルは [メッセージをログ] アクティビティに設定できます。

📘

注:

errorInfoActivityInfo プロパティを使用して、例外をスローしたアクティビティの名前を取得し、[出力] パネルに表示します。

2 つ目の引数は、出力方向の result です。エラー発生時に、この引数を使用してプロセスの次の動作を決定します。次の値が result 引数に割り当てられます。

  • Continue - 例外が再度スローされます。
  • 無視 - 例外を無視して、次のアクティビティから実行を続行します。
  • リトライ - 例外をスローしたアクティビティがリトライされます。errorInfoRetryCount メソッドを使用して、アクティビティのリトライ回数をカウントします。
  • 中止 - 現在のグローバル例外ハンドラーを実行した後に、実行が中止されます。

📘

注:

Studio では、ライブラリ プロジェクト以外の任意のプロジェクトをグローバル例外ハンドラーとしてフラグ付けすることができます。

エラー発生時のこのワークフローの動作を制御するために、グローバル例外ハンドラー はこのアクティビティを 3 回リトライしてから、エラー メッセージを表示して中止します。

デバッグ中に発生したエラーの処理

デバッグ中に例外が検出されると、失敗したアクティビティが強調表示され、実行が停止し、[ローカル] パネルと [コール スタック] パネルに例外の種類と詳細が表示されます。

続行停止リトライ無視再起動低速ステップ のようなデバッグの操作をリボンで使用できます。無視は、次のアクティビティから実行を継続するために使用されます。

グローバル例外ハンドラーが介入することなく、[リトライ] ボタンは現在のアクティビティを実行しようとします。続行操作を行うと、result 引数で以前に選択された値 (ContinueIgnoreRetry、または Abort のいずれか) を考慮して、グローバル例外ハンドラーを実行します。

📘

注:

[トライ キャッチ] を含むプロジェクトでグローバル例外ハンドラーを使用する際には、必ず [Try] コンテナーの内部の [シーケンス] にアクティビティをグループ化してください。グループ化しないと、グローバル例外ハンドラーは実行されません。

入れ子になったアクティビティの場合、グローバル例外ハンドラーは、コールスタックに含まれるそれぞれのアクティビティに対して実行されます。ただし、[トライ キャッチ] に直接カプセル化されている複数のアクティビティについては、これらが 1 つのアクティビティに格納されていない限り、グローバル例外ハンドラーは実行されません。

グローバル例外ハンドラーの使用例

次の例では、実行中に例外がスローされた場合のプロジェクトの動作を示します。

このオートメーション プロジェクトは、メモ帳ファイルにテキストを入力した後、ファイルが保存されてからアプリケーションを閉じるように設定されています。

ワークフローの作成

  1. 基本プロセスの作成」ページの手順に従って、空のプロセスを作成します。
  2. メモ帳を開き、ドキュメントを使用中のマシンに保存します。ファイルに、1.txt という名前を付けます。
  3. [アクティビティ] パネルで [アプリケーション/ブラウザーを使用] アクティビティを検索し、デザイナー パネルにドラッグします。
  4. [アプリケーション/ブラウザーを使用] アクティビティで、以下を実行します。
    • [自動化するアプリケーションを指定(I)] をクリックして、マウス ポインターを [メモ帳] ウィンドウに移動します。ウィンドウが強調表示されたら、ウィンドウ内の任意の場所をクリックします。
      [アプリケーション/ブラウザーを使用] アクティビティが更新され、パスが [アプリケーション パス] フィールドに追加されて、ウィンドウのスクリーンショットがアクティビティに表示されます。
    • [プロパティ] パネルで、[閉じる] プロパティに [常時] オプションを選択します。これにより、オートメーションの実行後、メモ帳が閉じられるように設定されます。
  5. [アプリケーション/ブラウザーを使用] アクティビティの [Do] コンテナーに [文字を入力] アクティビティを追加します。[次で指定: アプリ] をクリックして [メモ帳] ウィンドウを選択し、[以下を入力] フィールドにテキストを引用符で囲んで入力します。このアクティビティは、テキストをメモ帳に書き込みます。
  6. [アクティビティ] パネルから、[キーボード ショートカット] アクティビティをワークフローに追加します。[メモ帳] ウィンドウを指定して [ショートカットを記録] を選択した後、Ctrl + S キーを押して、テキストの入力後にファイルを保存するキーの組み合わせを記録します。
    結果のワークフローは次のようになります。
434434

Global Exception Handler の追加

  1. リボンの一部である [デザイン] タブで、[新規作成] > [グローバル ハンドラー] を選択します。[新しいグローバル ハンドラー]ウィンドウが開きます。ハンドラーの名前を入力して、プロジェクト パスに保存します。[作成] をクリックすると、グローバル例外ハンドラー がオートメーション プロジェクトに追加されます。
349349
  1. 以前に作成したワークフローに戻り、アクティビティの実行が失敗するように変更します。たとえば、[アプリケーション/ブラウザーを使用] アクティビティで [タイトルが完全に一致] オプションを選択し、リボンで [ファイルを実行] をクリックする前にファイルが閉じられるようにします。

グローバル例外ハンドラーは例外を検出すると、失敗したアクティビティの名前をログし、そのアクティビティを 3 回リトライします。実行のたびに同じ例外が発生し、リトライ回数が 3 回に達した場合、例外をスローしたアクティビティのレベルで実行を中止します。

試行中に 1 回でも例外が発生しなかった場合には、ワークフローの実行が継続され、グローバル例外ハンドラーは介入しません。

サンプルをダウンロード

約 1 か月前に更新

グローバル例外ハンドラー


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。