Debug Scripts

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

Studio 提供了两种检查脚本中问题的方法：

  • 检查是否存在语法错误。
  • 运行脚本跟踪，显示脚本处理每个操作时发生的情况。

如果脚本中包含 Snippet 操作，则可以在 Snippet Editor 窗口中 调试代码片段 。

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

您可以使用Trace Output 工具跟踪脚本的进度和性能。该工具通过脚本追踪联系人，并显示每个触发操作的结果、正在设置的变量和时间，以及变量在每个点的值。这是测试和调试脚本的有用工具。您可以对实时交互或模拟交互运行跟踪。

仅当保存脚本时才能运行跟踪。如果尝试在未保存的脚本上运行脚本跟踪，则 Studio 会提示您保存该脚本。如果脚本中有错误，Studio 将不会保存脚本。您必须先解决错误，然后才能保存脚本并运行跟踪。该脚本中的任何validation errors都会导致 Studio 恢复到脚本的最新版本，而不会出现验证错误。如果您启动了跟踪，它将运行，，但它仅会在脚本的上次保存版本上运行。

使用 Trace Output 窗口

运行跟踪时，输出将显示在Trace Output 窗口中。您可以使用此窗口查看脚本中的变量，并了解它们是如何随着脚本中每个操作关闭 在 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 选项卡上显示的变量。

    字段 详细信息
    Show Global Variables in Subs 如果您希望全局变量出现在Variables 选项卡中，请选择此选项。这包括在此脚本中设置或曾在另一个脚本中设置并可在此脚本中使用的所有全局变量。例如，子脚本。

    Show System Variables

    如果您希望预定义的系统变量出现在Variables 选项卡中，请选择此选项。这些是系统自动添加到脚本中的变量，包括脚本中的操作。
    Show Private Members 如果您希望私人成员显示在Variables 选项卡中，请选择此选项。
  6. 在Properties 窗格中，您可以查看所选操作的属性及其配置方式。
  7. 如果要通过跟踪跟踪特定变量，请将变量添加到观察列表。

Change Variable Visibility in a Trace

您可以更改跟踪中显示的变量集。这样，您就可以根据要在跟踪中查找的内容，重点关注特定类型的变量。

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

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

    字段 详细信息
    Show Global Variables in Subs 如果您希望全局变量出现在Variables 选项卡中，请选择此选项。这包括在此脚本中设置或曾在另一个脚本中设置并可在此脚本中使用的所有全局变量。例如，子脚本。

    Show System Variables

    如果您希望预定义的系统变量出现在Variables 选项卡中，请选择此选项。这些是系统自动添加到脚本中的变量，包括脚本中的操作。
    Show Private Members 如果您希望私人成员显示在Variables 选项卡中，请选择此选项。

Capture a Script Trace

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

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

Capture a Continuous Script Trace

连续跟踪捕获脚本处理的每个交互。跟踪输出将保存到 CXone 业务单位关闭 用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组 的文件中。您可以指定这些文件的保存位置。

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

View Trace Files

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

  1. 在 Studio 中，单击 Debug 菜单，选择是否要加载位于系统上或远程 CXone 业务单位关闭 用于管理 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. 准备好观察观察列表中的变量时，在脚本上运行一个新的跟踪。