Studio ガイド

最終更新日時 2024年11月18日

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

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

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

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

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

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

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

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

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

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

デバッグ中に発生したエラーを処理する

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

[続行]、[停止] [リトライ]、[無視]、[再開]、[低速ステップ] などのデバッグ操作はリボンから使用できます。次のアクティビティから実行を継続する場合は、[無視] を使用します。

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

注:

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

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

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

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

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

ワークフローを作成する

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

結果のワークフローは次のようになります。

グローバル例外ハンドラーを追加する

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