重试作用域

UiPath.Core.Activities.RetryScope

描述

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

此活动在 Orchestration流程的主要工作流中无法正常工作。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

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

属性面板

常见

“显示名称”- 活动的显示名称。
“出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

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

其他

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

选项

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

跨平台配置

设计器面板

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

常见

“出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

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

选项

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

“重试作用域”活动使用示例

“ 重试作用域 ”活动用于捕获和处理错误，这就是它与“ Try Catch ”活动相似的原因。以下工作流会尝试打开记事本窗口 3 次，并使用在“ 重试作用域 ”活动中设置的条件来停止循环。

新建序列并添加“重试作用域”活动。
在“属性”面板中，保留默认的“重试次数”3 和“重试间隔”5。这意味着我们尝试打开记事本窗口 3 次，尝试之间的间隔为 5 秒。
在“操作”部分添加一个“分配”活动。
创建“通用值”变量，将其命名为“随机”或其他名称，然后将该变量添加到“分配”活动的“目标”字段。
向该变量添加“Now.Millisecond mod 5”值，方法是将该值添加到“分配”活动的“值”字段。
添加一个“If”活动，并输入 Random <> 0 作为条件。这意味着您要检查变量是否不等于 0。
在该活动的“Then”部分（上述条件为 True）执行以下操作：
- 添加“消息框”，指明“记事本窗口启动失败”。
- 在“消息框”下添加“抛出”活动，以便抛出错误。
- 在“属性”下的“异常”字段中键入“New System.Exception(“Notepad failed to start”)”。
在“IF 条件”活动的“Else”部分（上述条件为“False”）执行以下操作：
- 添加“打开应用程序”活动，并在屏幕上指定记事本。在“属性”的“文件名”字段部分中提供记事本可执行文件的完整路径。
如要退出循环，您需在“重试作用域”的“条件”部分添加“存在元素”活动，并指明“记事本”窗口。

如果使用新式活动，则“检查应用程序状态”活动可以用作“重试作用域”中的条件。