Desktop Studio 中的调试脚本

This help page is for Desktop Studio.This information is also available for CXone Studio.

所需权限： 应用程序 > Studio > 脚本 > 调试

Studio provides two ways you can check for issues in your scripts:

  • Check for syntax errors.
  • Run a script trace, which shows you what's happening as the script processes each action.

If you have Snippet actions in your script, you can debug the snippet code from within the Snippet editor window.

Check for Syntax Errors

检查语法错误时，脚本中发现的任何问题都会显示在 Script Errors 选项卡中。该选项卡显示与脚本相关的所有警告和错误，包括片段。警告不会阻止脚本运行或保存，但错误会。最佳做法是在将脚本投入生产之前处理所有警告，即使它们不会阻止脚本运行。

语法检查会在保存脚本时自动进行，但您也可以随时运行语法检查。您将无法运行或保存包含错误的脚本。如果您试图运行或保存有错误的脚本，Studio 将显示一个通知窗口。您可以查看 Script Errors 选项卡，了解更多信息。错误可能包括以下内容：

  • 变量拼写错误。例如：Snippet Line 2. Function: NameLabel has not been defined。
  • 将函数用作方法参数。例如：Unterminated function parameters。
  • 在需要特定数据类型的函数中使用不正确的数据类型。例如：Unterminated function parameters。

有些错误可能不会显示在 Script Errors 选项卡上。某些验证错误会显示在错误通知窗口中，并包含有关错误的详细信息。验证错误包括 REST API 操作 中的无效 JSON 等内容。如果您在脚本包含验证错误时尝试保存，则脚本可能恢复到没有验证错误的最新版本。如果发生这种情况，任何未保存的更改都将丢失。

双击 Script Errors 中的任何警告或错误，查看出现问题的画布上的操作。

  1. 在 Studio 中，打开脚本。
  2. 单击 Validation > Syntax Check。
  3. 单击 Script Errors 选项卡，查看语法检查结果。
  4. 双击 Script Errors 上的任何警告或错误，查看出现问题的画布上的操作。

Script Traces

You can track the progress and performance of your script with the tool.This tool traces the contact through the script and displays the results of each action that fired, what variables are being set and when, and the values the variables held at each point.This is a helpful tool to test and debug your scripts.You can run traces on live interactions or simulated ones.

仅当保存脚本时才能运行跟踪。如果尝试在未保存的脚本上运行脚本跟踪，则 Studio 会提示您保存该脚本。如果脚本中有错误，Studio 将不会保存脚本。您必须先解决错误，然后才能保存脚本并运行跟踪。Any validation errors in the script cause Studio to revert to the last version of the script without the validation error. If you've started a trace, it runs, but will run on the last saved version of the script.

使用 Trace Output 窗口

When you run a trace, the output appears in the window.You can use this window to view the variables in the script and see how they change as the script progresses through each action关闭 在 Studio 脚本中执行一个过程，如收集客户数据、播放消息或音乐或将联系人转接给坐席。.

  1. 在 Studio 中，打开脚本并运行跟踪，或打开保存的跟踪文件。

    “跟踪输出”窗口，显示呼入语音脚本的跟踪输出。
    字段 详细信息
    IBVoice 脚本的名称。IBVoice 是本示例图像中的脚本名称。
    工具栏

    脚本名称下方是Trace Output 窗口工具栏。此工具栏包含允许执行以下操作的选项：

    • “跟踪输出”窗口中“视图”和“布局”选项的图标。一个看起来像空窗口的矩形。：更改Trace Output 窗口的布局，包括可见的窗格和选项卡。
    • “跟踪输出”窗口中的“工具”图标，，一把锤子和一把扳手交叉成 X 形状。：更改“变量”选项卡中可见的变量，保存当前观察列表，并将当前跟踪保存到计算机上的文件中。
    • “跟踪输出”窗口工具栏中的一组图标，用于创建和管理观察列表。：创建并管理要在此跟踪中观察的变量列表。
    • 一组图标，允许展开和折叠列表中包含信息的所有变量或操作。：展开或折叠其中包含信息的所有操作或变量。
    • 联系人 ID 以及要跟踪的脚本名称和路径。：工具栏的这一部分显示当前联系人的联系人 ID。其中还显示正在跟踪的脚本的名称和路径。

    您无法更改工具栏的位置。
    属性

    在 Script Details 窗格中选择某项操作后，Properties 窗格会显示该操作的所有属性及其配置设置。

    Properties窗格的默认位置是在Trace Output窗口左上方的工具栏下。
    Script Details

    Script Details 窗格会显示脚本运行时触发的所有操作，并按触发顺序排列这些操作。其中不包括作为脚本一部分但未触发的操作，例如作为分支一部分但未执行的操作。

    单击某项操作后，当时脚本中的所有变量都会出现在 Variables 选项卡中。

    “脚本详细信息”窗格的默认位置是在Trace Output窗口左上方的工具栏下。

    有关此窗格中的列标题的信息，请参见步骤 2 中的下拉表。
    Variables  选项卡

    在 Script Details 窗格中选择某个变量时，脚本中当前所有可用的变量都会显示在此选项卡上。

    Variables 选项卡的默认位置是Trace Output 窗口底部。
    Watch List  选项卡

    您可以创建一个脚本变量列表，以便在脚本运行时跟踪这些变量。添加的变量将显示在此选项卡上。

    Watch List 选项卡的默认位置是Trace Output 窗口底部。

  2. 在Trace Output窗口的右上角，单击脚本详细信息窗格中的操作。如果您正在观察实时跟踪，该窗格会随着脚本的进展而实时更新并触发每个操作。

    字段 详细信息
    Script 包含操作的脚本的名称。如果主脚本生成一个子脚本，您可能会在列表中看到多个名称。
    Time 操作触发的时间。
    Action 操作的名称，包括每个操作的参数。参数是操作属性中的所有配置设置。
    Result

    操作触发的结果。这表示脚本处理操作的结果。这可能是脚本遵循的分支或由于操作触发而发生的操作。

    例如，在本部分步骤 1 的示例图像中，Default 和 Error 是分支。DirectJump to 4 和 StartAt ONRELEASE 是这些操作触发的结果。DirectJump to 4 表示联系人在 IVR关闭 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。 菜单中选择了一个选项，使得脚本跳转到操作 ID 4 的操作。StartAt ONRELEASE 表示脚本当前正在等待，并将在坐席应答交互时重新启动。
  3. 单击Trace Output 窗口顶部工具栏中的图标，可展开 或折叠所有 “跟踪输出”窗口中的“全部展开”图标是一个带有 + 的正方形，旁边是一系列堆叠的水平线，代表一个列表。 脚本详细信息窗格中的变量详细信息。这会影响其中包含其他详细信息的任何变量。这些变量由名称旁边的 + 图标指示。

  4. 单击窗口底部的 Variables 选项卡，可滚动浏览所选操作触发时脚本中存在的所有变量。

    字段 详细信息
    Name 变量名称。名称以两个下划线字符开头的变量是系统变量。
    Value 变量值。这可能会随着脚本从一个操作到另一个操作的进展而发生变化。
    Type 变量类型。选项是用于标准单值变量的 Variable，或用于动态数据对象的 UCN.Data.Dynamic。

  5. 单击 Tools 图标 并选择一个选项来更改 Variables 选项卡上显示的变量。

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab.This includes global variables that are set in this script or are set in another script and can be used in this script.For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab.These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.
  6. 在Properties 窗格中，您可以查看所选操作的属性及其配置方式。
  7. 如果要通过跟踪跟踪特定变量，请将变量添加到观察列表。

Change Variable Visibility in a Trace

You can change which sets of variables show in a trace.This allows you to focus on specific kinds of variables, depending on what you're looking for in the trace.

  1. 在 Studio 中，打开脚本并运行跟踪。
  2. 在Trace Output 窗口的工具栏中，单击 Tools 图标。

  3. 选择要在跟踪中查看或隐藏的变量集的选项。旁边带有复选标记的选项当前在跟踪中可见。

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab.This includes global variables that are set in this script or are set in another script and can be used in this script.For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab.These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.

Capture a Script Trace

您可以在脚本运行时对其进行跟踪。您可以使用处理实时联系人的生产脚本来完成此操作。这样，您就可以诊断联络中心遇到的问题，或获取数据以便与技术支持人员一起排除故障。您可以选择在脚本运行时捕获下一个实例的跟踪，也可以捕获连续跟踪。连续跟踪捕获脚本处理的每个交互。捕获到某个踪迹时，结果信息将显示在 Trace Output 窗口中。

  1. 在 Studio 中，打开要捕捉跟踪的脚本。
  2. 单击 Debug > Capture Script > Next Instance。
  3. 当交互开始且脚本开始运行时，Trace Output 窗口将打开。该窗口显示脚本运行时的踪迹。

Capture a Continuous Script Trace

连续跟踪捕获脚本处理的每个交互。跟踪输出将保存到 CXone 的文件中。您可以指定这些文件的保存位置。

  1. 在 Studio 中，打开要捕捉跟踪的脚本。
  2. 单击 Debug > Capture Script > Continuous。Studio 开始捕获正在运行的脚本的所有实例。

View Trace Files

您可以查看连续跟踪保存的跟踪文件。

  1. 在 Studio 中，单击 Debug 菜单，选择是否要加载位于系统上或远程 CXone 中的跟踪文件。
  2. 在出现的文件窗口中选择要打开的文件。
  3. 单击该按钮可打开选定的跟踪文件。该名称会根据打开的是本地文件还是远程文件而有所不同。所选文件加载到Trace Output 窗口中。
  4. 如果要将 CXone 中的跟踪文件下载到本地计算机，请单击Trace Output 窗口中的Tools 图标“跟踪工具”图标，一把锤子和一把扳手交叉成 X 形状。，然后选择 Save Trace As。

Capture a Trace with a Specific ANI or DNIS

您可以设置特定 ANI关闭 也称为呼叫者 ID。所列的语音来电的电话号码。 或 DNIS关闭 识别联系人在呼入语音呼叫联系您时拨打的号码，以及坐席或系统在呼出语音呼叫时拨打的号码。，在来自指定号码的呼叫进入系统时触发跟踪。

  1. 在 Studio 中，打开要捕捉跟踪的脚本。

  2. 在 Studio 工具栏中，单击Trace Script下拉列表并选择 Trace when ANI is 或 Trace when DNIS is。

    Studio 工具栏中“跟踪”的图像
  3. 在 Insert <number> 字段中，输入要触发跟踪的 ANI 或 DNIS 编号。
  4. 单击 Capture Next Instance 图标。单击次数会更改行为：
    • 单击一次可跟踪脚本以指定次数运行的下一个实例。图标变为红色。
    • 单击两次可持续跟踪以指定编号运行的脚本的未来实例。图标变为两个红色圆圈。
    • 单击三次可清除捕获。图标恢复为原来的灰色。
  5. 下一次以指定的 ANI 或 DNIS 运行脚本时，将捕获跟踪信息并将其保存到文件中。

Watch Variables in a Trace

您可以创建一个特别感兴趣的变量列表。观察列表允许您仅跟踪这些变量，而无需在跟踪中搜索它们。您可以保存该列表，这样每次在特定脚本上运行跟踪时，都会保存观察列表并将其加载到 Trace Output 窗口中。

  1. 在 Studio 中，打开要跟踪的脚本。
  2. 运行脚本的初始跟踪。
  3. 在 Trace Output 窗口中，单击脚本详细信息窗格中的操作列表。与每个操作关联的变量显示在 Variables 选项卡上。
  4. 对于要添加到观察列表的每个变量：
    1. 选择 Variables 选项卡上的变量。
    2. 单击 Add to Watch List 图标。
  5. 如果知道变量名称，可以手动添加变量：
    1. 在 Trace Output 窗口的工具栏中，单击加号图标。将出现 Watch List 选项卡，其中包含新变量的字段。
    2. 输入要观察的变量名称，然后按 Enter。
  6. 如果要从观察列表中移除变量，请在 Watch List 选项卡上选择该变量，然后单击Trace Output 窗口工具栏上的减号图标。
  7. 要保存此观察列表，请单击 Trace Output 窗口工具栏中的 Tools 图标，然后选择 Save Watch List。该列表保存在 Studio 中。每次在该脚本上运行跟踪时，观察列表都会加载到 Trace Output 窗口中。
  8. 准备好观察观察列表中的变量时，在脚本上运行一个新的跟踪。