重试作用域

UiPath.Core.Activities.RetryScope

描述

只要不满足条件或抛出错误，系统便会重试所包含的活动。

重要提示：

• 不支持“延迟”和“重试作用域”活动，并且在编排流程的主工作流中使用时，这两个活动无法正常工作。在这种情况下，应将其放置在“非暂留作用域”活动中。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 操作 - 添加在此部分中要重新执行的活动。
• 条件 - 在此部分中添加条件活动。

  例如，要在指定用户界面元素时失败并正常重试，您可以使用新式用户界面自动化“检查应用程序状态”活动或其传统的“存在元素”对应活动作为条件，并再次尝试打开应用程序并查找用户界面元素。

属性面板

常见

• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空，则系统会发生错误，或如果超出重试次数，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。

• “显示名称”- 活动的显示名称。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• 重试次数 - 要重试某个序列的次数。
• 重试间隔 - 指定每次重试之间的时间间隔。

跨平台配置

设计器面板

• 活动主体 - 添加在此部分中要重新执行的活动。
• 条件 - 在此部分中添加条件活动。

  例如，要在指定用户界面元素时失败并正常重试，您可以使用新式用户界面自动化“检查应用程序状态”活动作为条件，并再次尝试打开应用程序并查找用户界面元素。

其他属性

• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空，则系统会发生错误，或如果超出重试次数，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。

选项

• 重试次数 - 要重试某个序列的次数。
• 重试间隔 - 指定每次重试之间的时间间隔。

在 Windows 项目中使用“重试作用域”活动的示例

“重试作用域”活动用于捕获和处理错误，因此该活动类似于“Try Catch 异常处理”活动。

以下工作流将尝试打开记事本窗口 3 次，并使用在“重试作用域”活动中设置的条件来停止循环：

• 如果“随机”变量的值连续 3 次不等于零，则每次都会显示“记事本窗口启动失败”消息，并且整个工作流将失败，并显示“记事本启动失败”错误。第二条消息是您在“引发”活动中添加的消息。

• 如果“随机”变量的值为零，则机器人将打开“记事本”，并且此循环的条件是找到“记事本”窗口，因此工作流已成功完成。

1. 新建序列并添加“重试作用域”活动。
2. 在“属性”面板中，将“重试次数”的值设置为“3”，并将“重试间隔”的值设置为“5”。这意味着我们尝试打开记事本窗口三次，尝试之间的间隔为五秒。
3. 在“操作”部分添加一个“分配”活动：
   1. 在“分配”活动的“保存到”字段中，创建一个变量并将其命名为“随机”。

   2. 在“要保存的值”字段中，写入以下表达式：

       (Now.Millisecond Mod 5).ToString()

      
4. 在“操作”部分添加一个“If 条件”活动。
   1. 在“条件”字段中，添加以下表达式，其中“随机”是先前创建的变量。以下表达式会检查变量值 是否不为零：

       Random <> "0"

   2. 在“If 条件”活动的“Then”部分中：
      • 添加一个具有以下文本的“消息框”活动：“记事本窗口启动失败”。
      • 在“消息框”下，添加“引发”活动，并在“异常”字段中提供以下表达式：

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

        这些活动在条件为 True 时执行。

      

   3. 在“If 条件”活动的“Else”部分中：

      • 添加一个“打开应用程序”活动，并在屏幕上指出记事本应用程序。确保“文件名”字段包含设备上记事本可执行文件的完整路径。

        条件为“False”时，系统将执行此活动。

      

5. 要退出循环，请在“重试作用域”活动的“条件”部分中添加“检查应用程序状态”活动并指定记事本窗口。