重试作用域

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