调试基础知识

在构建画布上的 Flow 中进行调试，涵盖执行跨度、故障、故障检查以及用于单独测试工作流的模拟输出。

Flow 中的调试在您构建的同一画布上进行。没有单独的调试视图 — 您可以运行流程，在执行面板中检查结果，并在发现问题时进行更改。

启动调试会话

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. The execution panel appears at the bottom of the screen and spans populate in real time as each node executes.

“停止”按钮可明确结束会话。对流程进行的任何更改都会自动退出调试会话。有关调试控件和执行面板布局的完整概述，请参阅“画布” 。

读取执行面板

执行面板包含三个选项卡。每个问题都回答不同的问题。

跨度

“跨度”选项卡显示执行追踪记录，即按顺序运行的每个节点，并提供时间和成功或失败指示器。选择跨度会在画布上高亮显示相应节点，以便于查看执行到达何处。

事件

“故障”选项卡收集运行期间发生的错误，并按节点分组。默认情况下，每个组都处于展开状态，因此其中的错误和警告会立即可见。每个事件都会为失败的节点命名并包含错误消息。如果您的流程意外停止，请先在此处查看。

变量

“变量”选项卡显示 Runtime 变量值，分为三个部分：输入（传递到工作流中的值）、输出（生成的值）和变量（内部工作流变量）。在“跨度”选项卡中选择一个跨度， “变量”选项卡将更新，以显示执行中该点的状态。用于验证上游节点是否生成了您预期的数据。

每个部分都有自己的标题和一个用于按名称筛选值的搜索字段，并且每个部分都有自己独立的折叠或展开状态。您还可以使用键盘切换部分 - 在获得焦点的部分标头上按 Enter 或 Space 键，而不会影响其父部分。

识别故障

调试运行后，画布上的每个节点都会显示成功或失败指示器。“跨度”选项卡中失败节点的跨度会在画布上高亮显示。“故障”选项卡会显示错误消息。发生故障的节点的属性面板在输出部分中显示完整的错误对象。

错误对象包含message字段（人类可读描述）和detail字段（技术原因）。以message开头，因为其中包含面向用户的故障摘要。

使用模拟节点

模拟输出使您可以单独测试流程的一部分。当您在节点上设置模拟输出时，它会跳过实际执行，并将测试数据注入下游。

当上游节点速度较慢、需要本地不可用的凭据或依赖外部系统时，这非常有用。双击节点将打开其展开视图，其中可以将模拟输出设置为下游节点所需的任何数据。

通过一次模拟多个节点，调试会话可以专注于流程的特定部分。

提示

• 首先是跨度，然后是事件。跨度显示完整的执行图片；事件仅显示损坏的内容。
• 变量值显示数据不匹配。比较上一个节点收到的数据与下一个节点预期的数据。
• 模拟外部依赖项可以加快迭代速度。通过模拟调用 API 或触发 RPA 流程的节点，您可以调试逻辑，而无需等待外部系统。
• 小迭代速度更快。每个调试周期修复一次比尝试一次修复所有内容更高效。
• 描述性的节点名称提高了追踪的可读性。跨度和事件引用节点名称 — 描述节点所做操作的名称，使执行追踪记录更易于扫描。

相关页面

• Canvas — 完整的调试控件和执行面板参考
• Error 处理— 在节点上配置 Error 分支
• 变量和数据流— 变量如何在节点之间运行