Debug Scripts

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

所需权限ACD > 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. 单击 ValidationSyntax Check
  3. 单击 Script Errors 选项卡,查看语法检查结果。
  4. 双击 Script Errors 上的任何警告或错误,查看出现问题的画布上的操作。

Script Traces

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

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

使用 Trace Output 窗口

运行跟踪时,输出将显示在Trace Output 窗口中。您可以使用此窗口查看脚本中的变量,并了解它们是如何随着脚本中每个操作关闭 在 Studio 脚本中执行一个过程,如收集客户数据、播放消息或音乐或将联系人转接给坐席。的进展而变化的。

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

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

  3. 单击Trace Output 窗口顶部工具栏中的图标,可展开 或折叠所有 “跟踪输出”窗口中的“全部展开”图标是一个带有 + 的正方形,旁边是一系列堆叠的水平线,代表一个列表。 脚本详细信息窗格中的变量详细信息。这会影响其中包含其他详细信息的任何变量。这些变量由名称旁边的 + 图标指示。
  4. 单击窗口底部的 Variables 选项卡,可滚动浏览所选操作触发时脚本中存在的所有变量。

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

  6. Properties 窗格中,您可以查看所选操作的属性及其配置方式。
  7. 如果要通过跟踪跟踪特定变量,请将变量添加到观察列表

Change Variable Visibility in a Trace

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

  1. Studio 中,打开脚本并运行跟踪。
  2. Trace Output 窗口的工具栏中,单击 Tools 图标
  3. 选择要在跟踪中查看或隐藏的变量集的选项。旁边带有复选标记的选项当前在跟踪中可见。

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 > ContinuousStudio 开始捕获正在运行的脚本的所有实例。

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 isTrace when DNIS is

  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. 准备好观察观察列表中的变量时,在脚本上运行一个新的跟踪。