Snippets 除錯

此頁面適用於 Desktop Studio目前,CXone Studio 不支援本頁描述的選項。

您可以從 Snippet 視窗對 snippet 進行偵錯。偵錯程式允許您看到 snippet 代碼中的變數。這可以幫助您解決代碼中的問題。偵錯 snippet 有五個選項:

此外,如果您的代碼包含動態物件或陣列,您可以檢視其內容以及其如何變化。

檢查 Snippet 語法

您可以讓 Studio 檢查 snippet 中的語法。

  1. Studio 中,開啟一個包含 Snippet 動作的指令碼。
  2. 點擊兩下 Snippet 動作。
  3. 如果沒有,請在 Text View 標籤上新增 Snippet 代碼。
  4. 點擊 Snippet 編輯器視窗底部的 Check Syntax 圖示

    如果沒有發現語法錯誤,「檢查語法」圖示旁邊的狀態列會顯示訊息 Okay

    如果發現語法錯誤,會彈出錯誤訊息,描述錯誤。描述包含錯誤所在的行號。此外,「檢查語法」圖示旁邊的狀態欄位顯示訊息 Error at line [#]

  5. 更正我們發現的語法問題。
  6. 您可以選擇 snippet 代碼中的一行或多行,然後點擊 Comment out selected lines 圖示 。如果您想跳過一個錯誤並檢查其餘的錯誤,這很有幫助。
  7. 您可以在 snippet 中選擇一個或多個評論行,然後點擊 Uncomment the selected lines 圖示

使用偵錯程式工具

  1. Studio 中,開啟一個包含 Snippet 動作的指令碼。
  2. 點擊兩下 Snippet 動作。
  3. 如果沒有,請在 Text View 標籤上新增 Snippet 代碼。
  4. Snippet Editor 視窗的右側,點擊 Debugger 標籤。
  5. 點擊 Debug 圖示右側的向下箭頭按鈕並選擇 Start一個綠色的三角形播放按鈕的圖示。
  6. 如果代碼中存在任何語法錯誤,Snippet Editor 視窗會展開。代碼中的所有錯誤會出現在視窗底部的窗格中。如果沒有錯誤,則跳到下一個步驟。

    1. 糾正錯誤。
    2. 糾正錯誤後,點擊 CloseClear Trace Output 圖示 來關閉錯誤窗格。
    3. 再次啟動偵錯程式。
  7. 檢視 Variables as Text 標籤的內容。如果您設定了中斷點,當所有代碼均已執行時,該標籤會顯示變數及其數值。
  8. 您可以選擇 snippet 代碼中的一行或多行,然後點擊 Comment out selected lines 圖示 。如果您想刪除一些代碼以查看偵錯結果如何變化,這很有幫助。
  9. 您可以選擇一行或多行的評論代碼,然後點擊 Uncomment the selected lines 圖示 將這些行重新新增到 snippet 中。

用一個中斷點進行偵錯

如果您想讓偵錯操作在 snippet 代碼的某一行停止,您可以設定一個中斷點。這可以讓您在 snippet 中看到變數和數值,而不需要逐行瀏覽。

  1. Studio 中,開啟一個包含 Snippet 動作的指令碼。
  2. 點擊兩下 Snippet 動作。
  3. 如果沒有,請在 Text View 標籤上新增 Snippet 代碼。
  4. Snippet Editor 視窗中,點擊行號左側的欄。在該行號處會出現一個紅圈。

  5. Snippet Editor 視窗的右側,點擊 Debugger 標籤。
  6. 點擊 Debug 圖示右側的向下箭頭按鈕並選擇 Start一個綠色的三角形播放按鈕的圖示。
  7. 如果代碼中存在任何語法錯誤,Snippet Editor 視窗會展開。代碼中的所有錯誤會出現在視窗底部的窗格中。如果沒有錯誤,則跳到下一個步驟。

    1. 糾正錯誤。
    2. 糾正錯誤後,點擊 CloseClear Trace Output 圖示 來關閉錯誤窗格。
    3. 再次啟動偵錯程式。
  8. 檢視 Variables as Text 標籤的內容。如果您設定了中斷點,該標籤會顯示中斷點處的變數及其數值。在 Snippet Editor 視窗中,暫停偵錯中斷點的行會醒目顯示。
  9. 如果您完成了中斷點,再次點擊紅圈可將其清除。
  10. 如果您需要,請設定另一個中斷點。
  11. 要從中斷點繼續偵錯,請點擊 Resume 圖示 一個綠色播放三角形圖示。
  12. 要停止偵錯,請點擊 Stop Debugging 圖示。

逐步瀏覽 Snippet 代碼

您可以使用偵錯程式工具來逐行瀏覽該 snippet 代碼。這可以讓您看到在執行每一行時,變數和變數的值是如何變化。

  1. Studio 中,開啟一個包含 Snippet 動作的指令碼。
  2. 點擊兩下 Snippet 動作。
  3. 如果沒有,請在 Text View 標籤上新增 Snippet 代碼。
  4. Snippet Editor 視窗的右側,點擊 Debugger 標籤。
  5. 點擊 Debug 圖示右側的向下箭頭按鈕並選擇 Start一個綠色的三角形播放按鈕的圖示。
  6. 如果代碼中存在任何語法錯誤,Snippet Editor 視窗會展開。代碼中的所有錯誤會出現在視窗底部的窗格中。如果沒有錯誤,則跳到下一個步驟。

    1. 糾正錯誤。
    2. 糾正錯誤後,點擊 CloseClear Trace Output 圖示 來關閉錯誤窗格。
    3. 再次啟動偵錯程式。
  7. 檢視 Variables as Text 標籤的內容。當 snippet 代碼開始時,其會顯示代碼中的變數和變數的值。
  8. 點擊 Step 圖示 移到 snippet 的下一行。
  9. 在 Snippet 中的每一行前重複前兩步。
  10. 如果您想跳過剩下的幾行代碼,請點擊 Resume 圖示 Variables as Text 標籤會顯示所有 Snippet 代碼執行完畢後的變數及其值。
  11. 要停止偵錯,請點擊 Stop Debugging 圖示,然後從步驟 3 開始重複此過程。

檢視動態物件和陣列的內容

當您執行偵錯程式時,可以在 Snippet 編輯器視窗檢視動態物件的內容。這使您能夠在代碼的每一步驗證物件是否保留其應該保留的資料。

  1. Studio中,點擊兩下 Snippet 動作。
  2. 如有必要,新增 snippet 代碼。
  3. Debugger 標籤上,點擊變數為樹標籤。
  4. Debugger 標籤上,點擊開始偵錯圖示旁邊的向下箭頭,選擇單步執行一系列水平線,箭頭從一條線指向其下的一條線。。如果您不想逐行瀏覽代碼,可點擊開始偵錯圖示。
  5. 點擊步驟一系列水平線,箭頭從一條線指向其下的一條線。圖示,觀察 Variables as Tree 標籤上的內容。每次點擊步驟,此欄位就會隨著前一行代碼之後的指令碼中的變數和物件更新。如果點擊開始偵錯,則跳過此步驟。
  6. 當您跳過所有的代碼行,或者如果您點擊了開始偵錯Variables as Tree 標籤將顯示所有變數、物件、以及它們在 snippet 末尾的內容。
  7. 您可以點擊代碼中任何字串陣列或動態物件旁邊的 + 圖示來展開它們。如果內容是另一個陣列或物件,可以繼續展開樹,查看每個實體所包含的項目。

使用 TRACE 進行偵錯

TRACE  關鍵字允許您使用記錄進行偵錯。此關鍵字只在 Snippet 編輯器視窗中使用偵錯程式工具時有效。當您將其包含在 snippet 中並運行偵錯程式時,文字會輸出到出現在 Snippet 編輯視窗底部的 Trace 窗格。

Snippet 視窗之外,會忽略 TRACE 關鍵字。其僅適用於偵錯程式工具。

語法是:TRACE "<text>"

雙引號內的文字將輸出到 Snippet 編輯視窗。其會出現在視窗底部的 Trace 窗格中。

您可以在雙引號之間使用變數替換來列印變數的值。例如:

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

此範例的輸出結果是:

I = 1

I = 2

I = 3

I = 4

I = 5