Studio 中的偵錯 Snippet

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

• 對整個 snippet 進行偵錯檢視整個 snippet 執行後的變數及其值。
• 設定一個中斷點在代碼的某一行停止偵錯。
• 逐步流覽snippet 代碼中的每一行，檢視變數及其數值如何逐行變化。
• 使用 TRACE 語句將資料輸出到 Snippet 編輯視窗的 Trace 窗格。

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

使用偵錯程式工具

1. 在 Studio 中，開啟一個包含 Snippet 動作的指令碼。
2. 點擊 動作上的打開編輯器 Snippet。
3. 新增 Snippet 代碼（如果尚不包含一些）。
4. 在 Snippet 編輯器視窗的左側，點擊錯誤。 「運行與偵錯」面板從視窗左側滑出。
5. 點擊三角形 開始偵錯。
6. 檢視「運行與偵錯」面板的「變數」部分的內容。 此部分顯示偵錯器執行所有 snippet 代碼時的變數及其值。 動態資料物件顯示值{動態}。 點擊以展開它們，並檢視其成員的值。

7. 在偵錯處理序的任何時間點檢查 _err 變數中的錯誤。 一些錯誤在編輯器視窗中作為 Toast 訊息是在畫面底部的臨時彈出式訊息（較小），指示錯誤及成功等事項。 這是CXone Mpower的內建功能，可在任何畫面中顯示。toastSnippet 訊息彈出。

   檢視圖像

   

8. 要更改您的 snippet：
   1. 如果偵錯程式尚未停止，請停止偵錯程式。 當偵錯程式運行時，該 snippet 處於唯讀模式。
   2. 進行更改。
   3. 點擊編輯器視窗中的套用Snippet。 編輯器視窗自動關閉。 這會將變更傳送到伺服器，在其中運行偵錯服務。
   4. 重新打開Snippet 編輯器視窗並再次運行偵錯器。

用一個中斷點進行偵錯

如果您想讓偵錯操作在 snippet 代碼的某一行停止，您可以設定一個中斷點。 您可以設定多個中斷點，並讓偵錯程式從一個中斷點跳到另一個中斷點。 這使您無需逐行瀏覽即可查看 snippet 中特定點的變數和值。

您可以在啟動偵錯器之前或其運行時設定中斷點。 當即將執行帶有斷點的行時，偵錯暫停。 暫停時，您可以在「運行和偵錯」視窗的「變數」部分的 snippet 中看到所有變數的當前值。

1. 在 Studio 中，開啟一個包含 Snippet 動作的指令碼。
2. 點擊 動作上的打開編輯器 Snippet。
3. 新增 Snippet 代碼（如果尚不包含一些）。
4. 在 Snippet 編輯器視窗的左側，點擊錯誤。 「運行與偵錯」面板從視窗左側滑出。

5. 透過點擊 Snippet 編輯器視窗中任何行左側的欄來新增中斷點。 行號旁邊會出現一個紅色圓圈。 您可以在 snippet 中新增多個中斷點。 您也可以在偵錯程式運行時新增中斷點。

   檢視圖像

   

6. 點擊三角形 開始偵錯。
7. 檢視「運行與偵錯」面板的「變數」部分的內容。 如果設定了中斷點，本部分將顯示變數及其在中斷點處的值。 在「Snippet 編輯」視窗中，暫停偵錯中斷點的行會醒目顯示。 動態資料物件顯示值{動態}。 點擊以展開它們，並檢視其成員的值。
8. 如果已完成一個中斷點，請再次點擊紅色圓圈以清除它。
9. 要從中斷點繼續偵錯，請點擊恢復 。 如果您設定了多個中斷點，偵錯程式將在下一個中斷點之前暫停。
10. 要從當前中斷點開始逐行瀏覽代碼，請點擊向下箭頭 。 您可以隨時恢復，以完成偵錯或跳到下一個中斷點。

11. 在偵錯處理序的任何時間點檢查 _err 變數中的錯誤。 一些錯誤在編輯器視窗中作為 Toast 訊息是在畫面底部的臨時彈出式訊息（較小），指示錯誤及成功等事項。 這是CXone Mpower的內建功能，可在任何畫面中顯示。toastSnippet 訊息彈出。

    檢視圖像

    

12. 要停止偵錯，請點擊正方形 。
13. 要更改您的 snippet：
    1. 如果偵錯程式尚未停止，請停止偵錯程式。 當偵錯程式運行時，該 snippet 處於唯讀模式。
    2. 進行更改。
    3. 點擊編輯器視窗中的套用Snippet。 編輯器視窗自動關閉。 這會將變更傳送到伺服器，在其中運行偵錯服務。
    4. 重新打開Snippet 編輯器視窗並再次運行偵錯器。

逐步瀏覽 Snippet 代碼

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

1. 在 Studio 中，開啟一個包含 Snippet 動作的指令碼。
2. 點擊 動作上的打開編輯器 Snippet。
3. 新增 Snippet 代碼（如果尚不包含一些）。
4. 在 Snippet 編輯器視窗的左側，點擊錯誤。 「運行與偵錯」面板從視窗左側滑出。

5. 點擊 Snippet 編輯器視窗中任何行左側的欄。 該行旁邊出現一個紅色圓圈。 這是一個中斷點，它標記了您可以從哪裡開始單步執行代碼。

   檢視圖像

   

6. 點擊三角形 開始偵錯。 如果中斷點在第一行，則尚未執行代碼。
7. 檢視「運行與偵錯」面板的「變數」部分的內容。此部分顯示 snippet 代碼開始之前代碼中的變數及其值。 動態資料物件顯示值{動態}。 點擊以展開它們，並檢視其成員的值。
8. 點擊向下箭頭 移動到 snippet 的下一行。 變數部分更新以顯示執行第一行 snippet 代碼後的變數及其值。
9. 對 snippet 中的每一行重複前兩個步驟。 變數部分在每一行後繼續更新。
10. 如果您想跳過其餘的代碼行，請點擊恢復 。 變數部分顯示所有 snippet 代碼執行後的變數及其值。

11. 在偵錯處理序的任何時間點檢查 _err 變數中的錯誤。 一些錯誤在編輯器視窗中作為 Toast 訊息是在畫面底部的臨時彈出式訊息（較小），指示錯誤及成功等事項。 這是CXone Mpower的內建功能，可在任何畫面中顯示。toastSnippet 訊息彈出。

    檢視圖像

    

12. 要停止偵錯，請點擊正方形 ，然後根據需要重複偵錯處理序。
13. 要更改您的 snippet：
    1. 如果偵錯程式尚未停止，請停止偵錯程式。 當偵錯程式運行時，該 snippet 處於唯讀模式。
    2. 進行更改。
    3. 點擊編輯器視窗中的套用Snippet。 編輯器視窗自動關閉。 這會將變更傳送到伺服器，在其中運行偵錯服務。
    4. 重新打開Snippet 編輯器視窗並再次運行偵錯器。

使用 TRACE 關鍵字進行偵錯

TRACE 關鍵字允許您使用記錄進行偵錯。 此關鍵字只在 Snippet 編輯器視窗中使用偵錯程式工具時有效。 當您將其包含在 snippet 代碼中並運行偵錯程式時，文字會輸出到編輯器視窗Snippet 「運行和偵錯」視窗的「追踪」部分。

TRACE 編輯器視窗之外的 Snippet 關鍵字被忽略。 其僅適用於偵錯程式工具。

語法是：TRACE "<expression>"

雙引號內的文字輸出到Snippet編輯器視窗中運行與偵錯視窗的追踪部分。

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

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

本例「運行和偵錯」視窗的「追踪」部分的輸出是：

I = 1
I = 2
I = 3
I = 4
I = 5