偵錯指令碼

所需權限： 應用程式 > Studio > 指令碼 > 偵錯

Studio 提供了兩種檢查指令碼中問題的方法：

  • 檢查是否有語法錯誤。
  • 運行指令碼追蹤，將為您顯示指令碼處理每個動作時發生的情況。

如果指令碼中有 Snippet 動作，您可以從 Snippet Editor 視窗內偵錯 Snippet 代碼。

檢查語法錯誤

當您檢查語法錯誤時，指令碼中發現的任何問題都會出現在 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 標籤上的任何警告或錯誤，查看發生問題的畫布上的動作。

指令碼追蹤

您可以透過 Trace Output 工具追蹤指令碼的進度和效能。該工具透過指令碼追蹤聯絡並顯示觸發的每個動作的結果、正在設定的變數內容以及設定時間、變數在每個點上儲存的值。這是一個可以測試和偵錯指令碼的有用工具。您可以對即時互動或模擬的的互動運行追蹤。

只有在指令碼被儲存的情況下才能執行追蹤。如果試圖對未儲存變更的指令碼執行指令碼追蹤，Studio 會提示您儲存指令碼。如果您的指令碼有錯誤，Studio將不會儲存指令碼。您必須在儲存指令碼和執行追蹤之前解決錯誤。指令碼中的任何validation errors導致 Studio 恢復到沒有驗證錯誤的上一版本指令碼。如果您已經開始追蹤，它將會執行，但會在最後儲存的指令碼版本上執行。

使用 Trace Output 視窗。

當您運行追蹤時，在 Trace Output 視窗中會顯示輸出。您可以使用此視窗來檢視指令碼中的變數，並查看在每個動作Closed 在 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 標籤中顯示的變數。

    欄位 詳細資訊
    Show Global Variables in Subs 若要讓全域變數出現在Variables 標籤中，請選擇此選項。包括顯示在此指令碼中設定或在另一個指令碼中設定並可在此指令碼中使用的全域變數。例如，一個子指令碼。

    Show System Variables

    若要讓預定義的系統變數出現在Variables 標籤中，請選擇此選項。這些是系統自動新增到指令碼中的變數，包括指令碼中的動作。
    Show Private Members 若要讓私人成員出現在Variables 標籤中，請選擇此選項。
  6. 在 Properties 窗格上，您可以查看所選動作的屬性以及它們是如何配置的。
  7. 如果您想透過追蹤來追蹤特定的變數，將變數新增到監看清單。

變更追蹤中的變數可見性

您可以變更追蹤中顯示的變數集。這允許您可以根據在追蹤中尋找的內容重點關注特定種類的變數。

  1. 在 Studio 中，開啟指令碼並運行追蹤。
  2. 在 Trace Output 視窗的工具列上，點擊 Tools圖示。

  3. 選擇您想在追蹤中檢視或隱藏的變數集的選項。當前，旁邊有剔選符號的選項在追蹤中是可見的。

    欄位 詳細資訊
    Show Global Variables in Subs 若要讓全域變數出現在Variables 標籤中，請選擇此選項。包括顯示在此指令碼中設定或在另一個指令碼中設定並可在此指令碼中使用的全域變數。例如，一個子指令碼。

    Show System Variables

    若要讓預定義的系統變數出現在Variables 標籤中，請選擇此選項。這些是系統自動新增到指令碼中的變數，包括指令碼中的動作。
    Show Private Members 若要讓私人成員出現在Variables 標籤中，請選擇此選項。

擷取指令碼追蹤

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

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

擷取連續的指令碼追蹤

連續追蹤擷取指令碼進程的每一次互動。追蹤輸出將儲存於 CXone業務單位Closed 用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組 的檔案中。您可以指定這些檔案的儲存位置。

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

檢視追蹤檔案

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

  1. 在 Studio 中，點擊 Debug 選單，然後選擇是要載入位於系統上的追蹤檔案，還是要載入 CXone 業務單位Closed 用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組 中的遠端追蹤檔案。
  2. 從顯示的檔案視窗中選擇您要開啟的檔案。
  3. 點擊按鈕以開啟所選的追蹤檔案。根據您開啟的是本地檔案還是遠端檔案，名稱會有所不同。選定的檔案將在 Trace Output 視窗中載入。
  4. 如果您想從 CXone 將追蹤檔案下載到您的本地電腦，點擊Trace Output 視窗中的 Tools 圖示 「追蹤工作」的圖示，一個錘子和一個扳手，呈 X 型交叉。，然後選擇 Save Trace As。

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

您可以設定特定的 ANIClosed 也被稱為呼叫者 ID。顯示語音來電的電話號碼。 或 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. 當您準備好監看您的監看清單中的變數時，請運行指令碼上的新追蹤。