リトライ スコープ

[リトライ スコープ] アクティビティ。条件が満たされるかエラーがスローされない限り、含まれるアクティビティがリトライされます。

UiPath.Core.Activities.RetryScope

説明

条件が満たされないか例外がスローされる限り、含まれているアクティビティをリトライします。

重要:

• [待機] アクティビティと [リトライ スコープ] アクティビティをオーケストレーション プロセスのメイン ワークフロー内で使用することはサポートされておらず、正しく機能しません。そのような場合は、それらのアクティビティを [非永続スコープ ] アクティビティ内に配置する必要があります。

プロジェクトの対応 OS

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

Windows - レガシ、Windows での設定

デザイナー パネル

• アクション - 再実行するアクティビティをこのセクションに追加します。
• 条件 - このセクションに条件アクティビティを追加します。たとえば、UI 要素の指定に失敗した場合にスムーズにリトライするには、UI Automation モダンの [アプリのステートを確認] アクティビティ、またはそれに対応するクラシック アクティビティ [要素の存在を確認] を条件として使用し、再度アプリケーションを開いて UI 要素を検索するようにします。

プロパティ パネル

共通

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

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

• 表示名 - アクティビティの表示名です。

その他

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

オプション

• Number of attempts - The total number of times the activities are run, including the first run. A value of 1 means that the activities are not retried.
• リトライの間隔 - 各リトライの合間の時間 (秒数) を指定します。
• Stop retrying on business exception - When True, a business rule exception thrown in the body ends the Retry Scope immediately, with no further attempts and no wait. If Continue On Error is also True, the exception is logged instead of thrown. When False or not set, business rule exceptions are retried like any other exception. Other exception types follow the normal retry behavior. Available starting with System 26.10.1.

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

デザイナー パネル

• アクティビティの本体 - 再実行するアクティビティをこのセクションに追加します。
• 条件 - このセクションに条件アクティビティを追加します。 たとえば、UI 要素の指定に失敗した場合にスムーズにリトライするには、UI Automation モダンの [アプリのステートを確認] アクティビティを条件として使用し、再度アプリケーションを開いて UI 要素を検索するようにします。

その他のプロパティ

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

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

オプション

• Number of attempts - The total number of times the activities are run, including the first run. A value of 1 means that the activities are not retried.
• リトライの間隔 - 各リトライの合間の時間 (秒数) を指定します。
• Stop retrying on business exception - When True, a business rule exception thrown in the body ends the Retry Scope immediately, with no further attempts and no wait. If Continue On Error is also True, the exception is logged instead of thrown. When False or not set, business rule exceptions are retried like any other exception. Other exception types follow the normal retry behavior. Available starting with System 26.10.1.

Windows プロジェクトで [リトライ スコープ] アクティビティを使用した例

[ リトライ スコープ ] アクティビティはエラーをキャッチして処理するため、[ トライ キャッチ ] アクティビティと似ています。

以下のワークフローでは、[メモ帳] ウィンドウを 3 回開き、[リトライ スコープ] アクティビティで設定した条件を使用し、ループを停止します。

• Random 変数の値が 3 回連続して 0 ではない場合、「Notepad Window failed to start」というメッセージが毎回表示され、ワークフロー全体が「Notepad failed to start」エラーにより失敗します。2 番目のメッセージは、[ スロー] アクティビティで追加されたメッセージです。
• Random 変数の値が 0 の場合、ロボットはメモ帳を開き、このループの条件は[メモ帳] ウィンドウを見つけることであるため、ワークフローは正常に完了します。

1. 新しいシーケンスを作成し、[リトライ スコープ] アクティビティを追加します。

2. プロパティ パネルで、[リトライの回数] の値を 3 に、[リトライの間隔] の値を 5 に設定します。つまり、[メモ帳] ウィンドウを 3 回開き、試行間隔が 5 秒になるよう設定します。

3. [アクション] セクションの中で、[代入] アクティビティを追加します。

   1. [代入] アクティビティの [保存先] フィールドで、変数を作成して「Random」という名前を付けます。

   2. [保存する値] フィールドに、次の式を入力します。

      (Now.Millisecond Mod 5).ToString()
      

      

4. [アクション] セクションの中で、[条件分岐 (if)] アクティビティを追加します。

   1. [ 条件 ] フィールドに、次の式を追加します。「Random」は先ほど作成した変数です。この式は、変数の値がゼロとは異なるかどうかを確認します。

      Random <> "0"
      

   2. [条件分岐 (if)] アクティビティの [Then] セクションで、次の手順を実行します。

      • [Notepad Window failed to start] というテキストを [メッセージ ボックス] アクティビティに入力します。

      • [メッセージ ボックス] アクティビティの下に [スロー] アクティビティを追加し、[例外] フィールドに次の式を入力します。

        New System.Exception(“Notepad failed to start”)
        

        これらのアクティビティは、条件が True の場合に実行されます。

        

   3. [条件分岐 (if)] アクティビティの [Else] セクションで、次の手順を実行します。

      • [アプリケーションを開く] アクティビティを追加し、メモ帳アプリケーションを画面に表示します。[ファイル名] フィールドに、デバイス上のメモ帳の実行可能ファイルのフル パスが含まれていることを確認します。 このアクティビティは、条件が False の場合に実行されます。

        

5. ループを終了するために、[リトライ スコープ] アクティビティの [条件] セクションに [アプリのステートを確認] アクティビティを追加して、[メモ帳] ウィンドウを指定します。