调试 Studio 中的代码片段

本帮助页面适用于 Studio。此信息也可用于Desktop Studio。

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

调试整个代码段以在执行整个代码段后查看变量及其值。
设置断点以在代码中的某一行停止调试。
单步执行代码片段中的每一行，并查看变量及其值如何逐行变化。
使用 TRACE 语句，将数据输出到 Snippet 编辑器窗口中的 Trace 窗格。

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

如果您的业务单位中有自定义 SOAP DLL 用于管理 CXone Mpower环境的技术支持、计费和全局设置的高级组织分组，则在调试代码片段时不会将其包含在内。

Use the Debugger Tool

在 Studio 中，打开一个包含 Snippet 操作的脚本。
单击操作上的打开编辑器 Snippet。
添加 Snippet 代码（如果其尚不包含 some）。
在代码段编辑器窗口左侧，单击错误。 “运行和调试”面板从窗口左侧滑出。
单击三角形，开始调试。
查看“运行和调试”面板的“变量”部分的内容。本节显示当调试器已执行所有代码片段时的变量及其值。动态数据对象显示值{Dynamic}。单击以展开它们并查看其成员的值。
在调试过程中随时检查 _err 变量中的错误。有些错误在编辑器窗口中以吐司消息是屏幕底部临时弹出的小消息，显示错误和成功等信息。它们内置于 CXone Mpower 功能中，可在任何屏幕上出现。toastSnippet 消息的形式弹出。

查看图像
要更改代码片段：
1. 停止调试器（如果尚未停止）。当调试器运行时，该代码片段处于只读模式。
2. 进行更改。
3. 单击编辑器窗口中的应用Snippet。编辑器窗口自动关闭。这会将更改发送到运行调试服务的服务器。
4. 重新打开 Snippet 编辑器窗口并再次运行调试器。

Debug with a Breakpoint

如果希望调试在片段代码的某一行停止，可以设置断点。可以设置多个断点，并使调试器从一个断点跳到另一个断点。这使您可以查看代码片段中特定点的变量和值，而无需逐行单步执行。

可以在启动调试器之前或在其运行时设置断点。当带有断点的行即将被执行时，调试暂停。暂停时，您可以在“运行和调试”窗口的“变量”部分中查看代码片段中所有变量的当前值。

在 Studio 中，打开一个包含 Snippet 操作的脚本。
单击操作上的打开编辑器 Snippet。
添加 Snippet 代码（如果其尚不包含 some）。
在代码段编辑器窗口左侧，单击错误。 “运行和调试”面板从窗口左侧滑出。
通过单击代码片段编辑器窗口中任意行左侧的列来添加断点。行号旁边会出现一个红色圆圈。您可以在该代码片段中添加多个断点。您还可以在调试器运行时添加断点。

查看图像
单击三角形，开始调试。
查看“运行和调试”面板的“变量”部分的内容。如果设置了一个，此部分会显示断点处的变量及其值。调试因断点而暂停的行在代码段编辑器窗口中突出显示。动态数据对象显示值{Dynamic}。单击以展开它们并查看其成员的值。
如果您设置完断点，请再次单击红色圆圈以清除它。
要从断点继续调试，请单击恢复。如果设置了多个断点，则调试器会在下一个断点之前暂停。
要从当前断点开始逐行单步执行代码，请单击向下箭头。您可以随时恢复以完成调试或跳转到下一个断点。
在调试过程中随时检查 _err 变量中的错误。有些错误在编辑器窗口中以吐司消息是屏幕底部临时弹出的小消息，显示错误和成功等信息。它们内置于 CXone Mpower 功能中，可在任何屏幕上出现。toastSnippet 消息的形式弹出。

查看图像
要停止调试，请单击正方形。
要更改代码片段：
1. 停止调试器（如果尚未停止）。当调试器运行时，该代码片段处于只读模式。
2. 进行更改。
3. 单击编辑器窗口中的应用Snippet。编辑器窗口自动关闭。这会将更改发送到运行调试服务的服务器。
4. 重新打开 Snippet 编辑器窗口并再次运行调试器。

Step Through Snippet Code

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

在 Studio 中，打开一个包含 Snippet 操作的脚本。
单击操作上的打开编辑器 Snippet。
添加 Snippet 代码（如果其尚不包含 some）。
在代码段编辑器窗口左侧，单击错误。 “运行和调试”面板从窗口左侧滑出。
在代码段编辑器窗口中，单击任意行左侧的列。该行旁边会出现一个红色圆圈。这是一个断点，标记了您可以开始单步执行代码的位置。

查看图像
单击三角形，开始调试。如果断点位于第一行，则尚不执行任何代码。
查看“运行和调试”面板的“变量”部分的内容。此部分在代码段开始之前显示代码中的变量及其值。动态数据对象显示值{Dynamic}。单击以展开它们并查看其成员的值。
单击向下箭头，移到代码片段中的下一行。执行第一行代码片段后，“变量”部分更新以显示变量及其值。
为代码片段中的每一行重复前面的两个步骤。 “变量”部分在每一行后继续更新。
如果您想跳过其余代码行，请单击恢复。当所有代码片段均已执行后，“变量”部分会显示变量及其值。
在调试过程中随时检查 _err 变量中的错误。有些错误在编辑器窗口中以吐司消息是屏幕底部临时弹出的小消息，显示错误和成功等信息。它们内置于 CXone Mpower 功能中，可在任何屏幕上出现。toastSnippet 消息的形式弹出。

查看图像
要停止调试，请单击正方形，然后根据需要重复调试过程。
要更改代码片段：
1. 停止调试器（如果尚未停止）。当调试器运行时，该代码片段处于只读模式。
2. 进行更改。
3. 单击编辑器窗口中的应用Snippet。编辑器窗口自动关闭。这会将更改发送到运行调试服务的服务器。
4. 重新打开 Snippet 编辑器窗口并再次运行调试器。

使用 TRACE 关键字进行调试

TRACE关键字可使您使用日志记录进行调试。该关键字仅在Snippet 编辑器窗口中使用调试器工具时才有效。当您将其包含在代码片段中并运行调试器时，文本将输出到编辑器窗口中“运行和调试”窗口的“跟踪”部分。Snippet

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

语法为：TRACE "<expression>"

双引号内的文本输出到 Snippet 编辑器窗口中“运行和调试”窗口的“跟踪”部分。

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

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

此示例在“运行和调试”窗口的“跟踪”部分中的输出为：

I = 1
I = 2
I = 3
I = 4
I = 5