调试代码片段

本页适用于 Desktop Studio目前,CXone Studio 不支持本页所述选项。

可以从 Snippet 编辑器窗口调试代码片段。调试器允许查看代码片段中的变量。这可以帮助您解决代码中的问题。调试代码段有五个选项:

此外,如果代码包含动态对象或数组,您可以查看其内容及其变化方式。

Check Snippet Syntax

您可以让 Studio 检查代码段中的语法。

  1. Studio 中,打开一个包含 Snippet 操作的脚本。
  2. 双击 Snippet 操作。
  3. 如果尚未包含某些代码,请在 Text View 选项卡上添加 Snippet 代码。
  4. 单击 Snippet 编辑器窗口底部的 Check Syntax 图标

    如果未发现语法错误,“检查语法”图标旁边的状态字段将显示消息 Okay

    如果发现语法错误,则会弹出一条错误消息来描述该错误。描述包括错误所在的行号。此外,“检查语法”图标旁边的状态字段会显示消息 Error at line [#]

  5. 纠正发现的任何语法问题。
  6. 您可以选择代码片段中的一行或多行,然后单击 Comment out selected lines 图标。如果您想跳过某个错误并检查其他错误,这将很有帮助。
  7. 您可以在代码片段中选择一个或多个注释行,然后单击 Uncomment the selected lines 图标

Use the Debugger Tool

  1. Studio 中,打开一个包含 Snippet 操作的脚本。
  2. 双击 Snippet 操作。
  3. 如果尚未包含某些代码,请在 Text View 选项卡上添加 Snippet 代码。
  4. Snippet Editor 窗口的右侧,单击 Debugger 选项卡。
  5. 单击 Debug 图标 右侧的向下箭头按钮,然后选择 Start绿色播放按钮三角形的图标。
  6. 如果代码中有任何语法错误,Snippet Editor 窗口就会展开。代码中的所有错误都显示在窗口底部的窗格中。如果没有错误,请跳至下一步。

    1. 纠正错误。
    2. 纠正错误后,单击 CloseClear Trace Output 图标关闭错误窗格。
    3. 再次启动调试器。
  7. 查看 Variables as Text 选项卡的内容。如果未设置断点,则在所有代码执行完毕后,该选项卡会显示变量及其值。
  8. 您可以选择代码片段中的一行或多行,然后单击 Comment out selected lines 图标。如果您想删除一些代码以查看调试结果如何变化,这将很有帮助。
  9. 您可以选择一行或多行注释代码,然后单击 Uncomment the selected lines 图标 将这些行添加回代码段中。

Debug with a Breakpoint

如果希望调试在片段代码的某一行停止,可以设置断点。这样,您就可以查看代码片段中的部分变量和值,而无需逐行查看。

  1. Studio 中,打开一个包含 Snippet 操作的脚本。
  2. 双击 Snippet 操作。
  3. 如果尚未包含某些代码,请在 Text View 选项卡上添加 Snippet 代码。
  4. 单击 Snippet Editor 窗口中行号左侧的列。该行号处会出现一个红色圆圈。

  5. Snippet Editor 窗口的右侧,单击 Debugger 选项卡。
  6. 单击 Debug 图标 右侧的向下箭头按钮,然后选择 Start绿色播放按钮三角形的图标。
  7. 如果代码中有任何语法错误,Snippet Editor 窗口就会展开。代码中的所有错误都显示在窗口底部的窗格中。如果没有错误,请跳至下一步。

    1. 纠正错误。
    2. 纠正错误后,单击 CloseClear Trace Output 图标关闭错误窗格。
    3. 再次启动调试器。
  8. 查看 Variables as Text 选项卡的内容。如果已设置断点,该选项卡会显示断点处的变量及其值。Snippet Editor 窗口中会高亮显示因断点而暂停调试的行。
  9. 如果断点调试完毕,请再次单击红圈即可清除断点。
  10. 如果需要的话,设置另一个断点。
  11. 要从断点继续调试,请单击 Resume 图标绿色播放三角形的图标。
  12. 要停止调试,请单击 Stop Debugging 图标。

Step Through Snippet Code

您可以使用调试器工具逐行单步执行代码片段。这样就可以看到每一行执行时变量及其值的变化情况。

  1. Studio 中,打开一个包含 Snippet 操作的脚本。
  2. 双击 Snippet 操作。
  3. 如果尚未包含某些代码,请在 Text View 选项卡上添加 Snippet 代码。
  4. Snippet Editor 窗口的右侧,单击 Debugger 选项卡。
  5. 单击 Debug 图标 右侧的向下箭头按钮,然后选择 Start绿色播放按钮三角形的图标。
  6. 如果代码中有任何语法错误,Snippet Editor 窗口就会展开。代码中的所有错误都显示在窗口底部的窗格中。如果没有错误,请跳至下一步。

    1. 纠正错误。
    2. 纠正错误后,单击 CloseClear Trace Output 图标关闭错误窗格。
    3. 再次启动调试器。
  7. 查看 Variables as Text 选项卡的内容。当片段代码启动时,它会显示代码中的变量及其值。
  8. 单击 Step 图标 ,移至代码片段中的下一行。
  9. 对代码片段中的每一行重复前两个步骤。
  10. 如果要跳过剩余的代码行,请单击 Resume 图标。当片段代码全部执行完毕后,Variables as Text 选项卡会显示变量及其值。
  11. 要停止调试,请单击 Stop Debugging 图标,然后从步骤 3 开始重复此过程。

View Contents of Dynamic Objects and Arrays

运行调试器时,可以在 Snippet 编辑器窗口中查看动态对象的内容。这允许您验证该对象是否包含代码中每一步应包含的数据。

  1. Studio 中,双击 Snippet 操作。
  2. 如果需要,添加片段代码。
  3. Debugger 选项卡上,单击变量树选项卡。
  4. Debugger 选项卡上,单击开始调试图标 旁边的向下箭头,然后选择单步执行一系列水平线,箭头从一条线指向其下一条线。。如果不想逐行单步执行代码,请单击开始调试图标。
  5. 单击单步 一系列水平线,箭头从一条线指向其下一条线。 图标,观察 Variables as Tree 选项卡上的内容。每次单击步骤时,该字段都会随上一行代码后脚本中的变量和对象而更新。如果单击开始调试,请跳过此步骤。
  6. 单步执行所有代码行后,或者单击开始调试时,Variables as Tree 选项卡会显示代码片段末尾的所有变量、对象及其内容。
  7. 您可以单击代码中任何字符串数组或动态对象旁边的 + 图标将其展开。如果内容是另一个数组或对象,您可以继续展开树以查看每个实体包含的内容。

使用 TRACE 进行调试

TRACE  关键字允许您使用日志进行调试。该关键字仅在Snippet 编辑器窗口中使用调试器工具时才有效。将其加入代码片段并运行调试器后,文本就会输出到 Snippet 编辑器窗口底部的 Trace 窗格中。

Snippet 编辑器窗口之外,TRACE 关键字将被忽略。它仅适用于调试器工具。

语法为:TRACE "<text>"

双引号内的文本将输出到 Snippet 编辑器窗口。它会显示在窗口底部的 Trace 窗格中。

您可以使用双引号之间的变量替换来打印变量值。例如:

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

此示例的输出为:

I = 1

I = 2

I = 3

I = 4

I = 5