Studio
2023.10
false
Studio 用户指南
Last updated 2024年7月15日

调试操作

您可以通过设计调试功能区选项卡执行单个文件或整个项目的调试。但如果项目文件存在验证错误,您将无法使用调试流程。



进入

使用“进入”操作,一次调试一个活动。触发此操作后,调试器会打开活动,并在执行该活动前对其进行高亮显示。

在对调用工作流文件活动使用进入操作时,系统会在新选项卡中以 ReadOnly 模式打开工作流,并逐个执行每个活动。

进入操作的键盘快捷方式是 F11

跳过

进入操作不同,跳过操作不会打开当前容器。在使用时,该操作会调试下一活动,高亮显示容器(如流程图、序列或调用工作流文件活动)而不打开它们。

此操作对于跳过大型容器的分析非常方便,因为大型容器在执行过程中不太可能触发任何问题。

使用 F10 键盘快捷键即可执行跳过操作。

退出

顾名思义,此操作用于在当前容器级别退出并暂停执行。“退出”操作会先结束执行当前容器中的活动,然后暂停调试。此选项适用于嵌套序列。

使用 Shift + F11 键盘快捷键即可执行退出操作。

重试

重试操作会重新执行上一个活动,并在再次遇到异常时引发该异常。系统会高亮显示引发异常的活动,并在局部调用堆栈面板中显示错误详情。

忽略

“忽略”操作可用于忽略遇到的异常,继续执行下一个活动,以便完成剩余工作流的调试。

如要跳过引发异常的活动并继续调试项目的剩余部分,此操作将非常有用。

重启

引发异常并暂停调试流程后,可以重新启动。该操作用于从项目的第一个活动重新启动调试流程。使用慢步骤操作降低调试速度,并适当检查活动执行后的情况。

请注意,如果在使用“从此活动运行”操作后使用此选项,系统便会从先前指定的活动重启调试。

中断

“中断”允许您在任何给定时刻暂停调试过程。暂停时,正在调试的活动仍然会高亮显示。一旦发生这种情况,您可以选择“继续”“进入”“跳过”“停止”调试流程。

建议将中断慢步骤一起使用,这样您就可以准确地知道何时需要暂停调试。

在这种情况下,慢步骤的替代方法是监视输出面板,并对当前正在调试的活动使用中断

焦点

焦点执行点可帮助您在调试期间返回到当前的断点或导致错误的活动。焦点按钮在浏览流程后使用,它是返回到造成错误的活动并恢复调试过程的简便方式。

此外,当调试因为到达断点而暂停时,也可在浏览自动化流程中包含的活动后使用“焦点”来返回到所述的断点。

第三种使用情形是,在使用了进入跳过并且浏览了整个流程后,系统暂停了调试。在这种情形中,焦点可返回到造成调试过程暂停的活动。

断点上下文菜单中,您可以选择聚焦以高亮显示具有断点的活动。

慢步骤

通过使用慢速步骤,您可以仔细查看调试期间的任何活动。启用此操作后,调试流程中的活动将高亮显示。此外,还会打开容器,例如流程图、序列或调用工作流文件活动。这与使用进入相似,但不必暂停调试过程。

可以在调试过程之前或调试过程期间激活“慢步骤”。激活该操作不会暂停调试。

虽然被称为慢步骤,但该操作有 4 种不同的速度。所选速度的步骤在运行调试过程时慢于比上一个调试过程。例如,以慢速度 1x 调试时运行速度最慢,以 4x 运行时最快。换句话说,速度决定调试器从一个活动跳到下一个活动的速度。

每次单击“慢步骤”,速度就会按一个步长更改。您可以很容易地从图标中看出,图标会相应地更新。

执行历史记录

默认情况下,“执行历史记录”功能区按钮处于禁用状态。启用后,其将显示调试时的确切执行路径。执行该流程时,每项活动都会在“设计器”面板中突出显示并标记,以向您显示执行情况:

  • 已执行的活动以绿色标记并突出显示;
  • 未执行的活动不会以任何方式标记;
  • 抛出异常的活动以红色标记并突出显示。



高亮显示元素

如果启用,则在调试期间高亮显示用户界面元素。该选项可用于常规调试和逐步调试.

日志活动

如果启用,系统将在输出面板中将调试的活动显示为跟踪日志。请注意,突出显示元素记录活动选项仅支持在调试之前切换,其状态在重新打开自动化项目时仍保持不变。此情况不适用于调用的工作流,除非您在设计器面板中打开这些文件。

如果连接到了 Orchestrator,则会自动发送给 Orchestrator,但您可以将其存储在本地,方法是从“添加或编辑用户”窗口中的“机器人设置”选项卡中禁用“允许开发日志记录”选项。

要向 Orchestrator 发送更少量的日志文件,其中一种方法就是禁用“日志活动”

注意:通过 Studio 运行流程时,发送到 Orchestrator 的日志在禁用日志活动时始终为 Trace,在启用日志活动时始终为 Verbose。这将覆盖机器人和 Orchestrator 设置。

默认情况下,调试器会记录活动,以便每个步骤都出现在“输出”面板中。我们建议维持启用状态,以便更容易地进行跟踪,如下图所示:



这里的问题是,“用户输入”序列的一个或多个输入字段为空白,这对于流程决策来说是一个 True 条件。您可以通过以下事实来说明这一点:在调试期间,“用户输入”序列被执行两次,这意味着在第一次执行过程中,一个或多个字段被保留为空白。

如果决定禁用用于调试的日志活动选项,则跟踪日志不会显示在输出面板中。在正常执行而没有错误的情况下,您只能看到调试执行的开始和结束时间。但是,添加日志消息可以帮助您确定问题可能发生的位置。

例如,您可以添加一个日志消息活动,以通知您在这种情况下,一个或多个输入字段为空。即使禁用了记录活动选项,系统也会在调试过程中在输出面板中显示此消息,如下所示:



请记住,您始终可以通过选择感兴趣的警示类型来筛选“ 输出”面板 中显示的消息,甚至可以清除所有消息。



请注意,默认情况下,所有调试日志都将发送到 Orchestrator。 您可以通过从“添加或编辑机器人” 窗口的 “设置” 选项卡 中清除“允许开发日志记录” 选项来禁用此功能。 如果禁用此选项,则调试日志仅存储在本地。

继续处理异常

默认情况下,此调试功能处于禁用状态。 在功能区中禁用时,它会引发执行错误并停止调试,高亮显示引发异常的活动,并在“ 输出 ”面板中记录异常。 如果先前在项目中设置了 全局异常处理 程序,则系统会将异常传递给处理程序。

启用后,异常将记录在“输出”面板中,执行流程继续进行。

画中画

“调试”选项卡中的“画中画”功能区选项可用于在计算机上的单独会话中执行和调试流程或库。

如果启用,无论何时选择“运行”或“运行文件”、“调试”或“调试文件”,流程都会在单独的会话或用户会话的虚拟桌面中启动。如果禁用“画中画”功能,则调试和执行流程将在当前会话中进行。

在有人值守的自动化中,可以选择在画中画 (PiP) 中运行流程非常有用。验证流程是否在 PiP 中成功运行,然后更新项目设置以指示发布后是否可以使用此功能执行该流程:

  1. 在“项目”面板中,单击“设置”docs image,打开“项目设置”窗口。
  2. 在“常规”选项卡中:

    • PiP 选项 - 指明项目是否已使用画中画 (PiP) 进行测试,以及是否应默认在 PiP 中启动项目。

      • 已针对 PiP 使用情况进行测试;在 PiP 中启动 - 已批准自动化在 PiP 模式下运行。运行时,默认情况下在 PiP 中启动。
      • 已针对 PiP 使用情况进行测试;默认情况下未在 PiP 中启动 - 已批准自动化在 PiP 模式下运行。运行时,默认情况下在主会话或桌面中启动。
      • 未针对 PiP 使用情况进行测试 - 未批准自动化在 PiP 模式下运行。运行时,默认情况下在主会话或桌面中启动。如果在 PiP 中运行,则会出现一个对话框,通知用户未使用此功能进行测试,并在继续之前提示您确认。
    • PiP 类型 - 选择以 PiP 运行项目时如何将自动化与用户会话隔离:“新建会话”(计算机上的子会话)或“新建桌面”(用户会话中的虚拟桌面)。

有关更多信息,包括此功能的限制,请参阅机器人指南中的画中画

远程调试

启用此功能后,所有运行和调试操作都将在指定的远程机器人上执行,而不是在本地安装的机器人上执行,从而使您能够在不同的环境中测试自动化。有关更多信息,请参阅远程调试

配置文件执行

调试文件时,您可以识别工作流中的性能瓶颈。有关更多信息,请参见配置文件执行

打开日志

单击“ 打开日志 ”将打开本地存储日志的 %localappdata%\UiPath\Logs 文件夹。 日志文件的命名格式为 YYYY-DD-MM_Component.log (例如 2018-09-12_Execution.log2018-09-12_Studio.log)。 在此处阅读有关日志记录的更多信息。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。