リトライ スコープ

UiPath.Core.Activities.RetryScope

説明

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

重要:

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

プロジェクトの対応 OS

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

Windows - レガシ、Windows での設定

デザイナー パネル

• アクション - 再実行するアクティビティをこのセクションに追加します。
• 条件 - このセクションに条件アクティビティを追加します。

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

プロパティ パネル

共通

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

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

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

その他

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

オプション

• リトライの回数 - シーケンスをリトライする回数です。
• リトライの間隔 - 各リトライの合間の時間 (秒数) を指定します。

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

デザイナー パネル

• アクティビティの本体 - 再実行するアクティビティをこのセクションに追加します。
• 条件 - このセクションに条件アクティビティを追加します。

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

その他のプロパティ

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

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

オプション

• リトライの回数 - シーケンスをリトライする回数です。
• リトライの間隔 - 各リトライの合間の時間 (秒数) を指定します。

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