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.

檢查語法錯誤

當您檢查語法錯誤時，指令碼中發現的任何問題都會出現在 Script Errors 標籤中。該標籤顯示與指令碼有關的所有警告和錯誤，包括在 Snippet 中。警告不會阻止指令碼的執行或儲存，但錯誤會阻止。最佳做法是在將指令碼投入生產之前處理所有警告，即使其沒有阻止指令碼的運行。

儲存指令碼時將會自動進行語法檢查，但是您可以隨時運行語法檢查。您將無法運行或儲存包含錯誤的指令碼。如果試圖運行或儲存有錯誤的指令碼，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 標籤上的任何警告或錯誤，查看發生問題的畫布上的動作。

指令碼追蹤

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 actionClosed 在 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 表示聯絡人在 IVRClosed 自動電話選單，允許呼叫者透過語音命令或按鍵輸入或二者進行互動，以獲取資訊、路由至呼入語音通話或二者兼有。 選單中選擇了一個選項，導致指令碼跳轉到動作（動作 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. 如果您想透過追蹤來追蹤特定的變數，將變數新增到監看清單。

變更追蹤中的變數可見性

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.

擷取指令碼追蹤

您可以在指令碼運行時擷取其追蹤。要實現此操作，需要生產指令碼處理實時聯絡。這使您能夠診斷聯絡中心出現的問題，或與技術支援人員一起獲取疑難排解的資料。您可以選擇在指令碼運行時擷取下一個執行個體的追蹤，或者您可以擷取連續追蹤。連續追蹤擷取指令碼進程的每一次互動。當您擷取單個追蹤時，結果資訊會出現在 Trace Output 視窗。

  1. 在 Studio 中，開啟您想擷取追蹤的指令碼。
  2. 點擊 Debug > Capture Script > Next Instance。
  3. 互動開始時，指令碼就開始運行，Trace Output 視窗隨即開啟。視窗顯示指令碼運行時的跟蹤。

擷取連續的指令碼追蹤

連續追蹤擷取指令碼進程的每一次互動。追蹤輸出將儲存於 CXone 的檔案中。您可以指定這些檔案的儲存位置。

  1. 在 Studio 中，開啟您想擷取追蹤的指令碼。
  2. 點擊 Debug > Capture Script > Continuous。Studio 開始擷取指令碼運行的所有執行個體。

檢視追蹤檔案

您可以檢視從連續追蹤中儲存的追蹤檔案。

  1. 在 Studio 中，點擊 Debug 選單，然後選擇是要載入位於系統上的追蹤檔案，還是要載入 CXone 中的遠端追蹤檔案。
  2. 從顯示的檔案視窗中選擇您要開啟的檔案。
  3. 點擊按鈕以開啟所選的追蹤檔案。根據您開啟的是本地檔案還是遠端檔案，名稱會有所不同。選定的檔案將在 Trace Output 視窗中載入。
  4. 如果您想從 CXone 將追蹤檔案下載到您的本地電腦，點擊Trace Output 視窗中的 Tools 圖示 「追蹤工作」的圖示，一個錘子和一個扳手，呈 X 型交叉。，然後選擇 Save Trace As。

擷取帶有特定 ANI 或 DNIS 的追蹤

您可以設定特定的 ANIClosed 也稱為來電顯示。顯示語音來電的電話號碼。 或 DNISClosed 識別聯絡人為聯絡您進行呼入語音通話而撥打的號碼，以及客服專員或系統在進行呼出語音通話時撥打的號碼。，以便在來自指定號碼的呼叫進入系統時觸發追蹤。

  1. 在 Studio 中，開啟您想擷取追蹤的指令碼。

  2. 在 Studio 工具列中，點擊 Trace Script 下拉清單，選擇 Trace when ANI is 或 Trace when DNIS is。

    Studio 工具列中追蹤選項的圖像。
  3. 在 Insert <number> 欄位中輸入您要觸發追蹤的 ANI 或 DNIS 號碼。
  4. 點擊 Capture Next Instance圖示 。點擊的次數會改變行為：
    • 點擊一次，可追蹤使用指定號碼執行之指令碼的下一個執行個體。圖示變成紅色。
    • 點擊兩次，可連續追蹤使用指定號碼執行之指令碼的未來執行個體。圖示變為 2 個紅色圓形。
    • 點擊三次，可清除擷取。圖示恢復到原來的灰色。
  5. 下一次當使用指定 ANI 或 DNIS 執行指令碼時，將會擷取追蹤，並將其儲存到檔案。

追蹤中的監看變數

您可以建立您特別感興趣的變數清單。監看清單允許您僅追蹤這些變數，而不必在追蹤中搜尋變數。您可以儲存此清單，因此，每次您對該特定指令碼運行追蹤時，將會儲存監看清單並載入到 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. 當您準備好監看您的監看清單中的變數時，請運行指令碼上的新追蹤。