Studioのスニペットをデバッグ

このヘルプページはStudio向けです。 この情報は、Desktop Studio用にも提供されています。

Snippetエディターウィンドウからスニペットをデバッグできます。 デバッガを使用して、スニペットコード内の変数を確認できます。 これはコードの問題を解決するのに役立ちます。 スニペットのデバッグには5つのオプションがあります。

また、コードに動的オブジェクトや配列が含まれている場合は、それらの内容を表示してその変化を確認できます。

ビジネスユニットにカスタムSOAP DLL閉じた CXone Mpower環境におけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループがある場合、スニペットのデバッグには含まれません。

デバッガツールを使用する

  1. Studioで、Snippetアクションを含むスクリプトを開きます。
  2. アクションでエディタを開く上部近くに横線のある長方形。 Snippetをクリックします。
  3. Snippetsomeがまだ含まれていない場合は、コードを追加します。
  4. スニペットエディターウィンドウの左側で、バグバグのアイコン。をクリックします。 実行とデバッグパネルがウィンドウの左側からスライドして出てきます。
  5. 三角形右向き矢印の付いた三角形のアイコン。をクリックしてデバッグを開始します。
  6. 実行＆デバッグパネルの変数セクションの内容を確認します。 このセクションは、デバッガーがスニペットコードをすべて実行したときの変数とその値を示します。 ダイナミックデータオブジェクトは、値{ダイナミック}を表示します。 クリックして展開し、メンバーの値を表示します。

  7. デバッグプロセスの任意の時点で、_err変数のエラーをチェックします。 一部のエラーは、エディターウィンドウに閉じた トーストメッセージは、画面の下部に一時的に表示される小さなポップアップメッセージで、エラーや成功などを知らせるものです。 CXone Mpower機能に組み込まれていて、どの画面にも表示できます。トーストSnippet メッセージとしてポップアップ表示されます。

    __err変数を示すデバッガーウィンドウの変数セクション。

  8. スニペットを変更するには：
    1. デバッガーがまだ停止していない場合、デバッガーを停止します。 デバッガーの実行中、スニペットは読み取り専用モードです。
    2. 変更を加えます。
    3. エディタウィンドウで適用Snippetをクリックします。 エディターウィンドウが自動的に閉じます。 これにより、変更がサーバーに送信され、デバッグサービスが実行されます。
    4. Snippetエディターウィンドウを再度開き、デバッガーを再度実行します。

ブレークポイントを使ってデバッグする

スニペットコードの特定の行でデバッグを停止したい場合は、ブレークポイントを設定できます。 複数のブレークポイントを設定し、デバッガーにブレークポイントからブレークポイントへスキップさせることができます。 これにより、1行ずつ確認することなく、スニペット内の特定のポイントで変数と値を確認できます。

デバッガーを開始する前または実行中にブレークポイントを設定できます。 ブレークポイントのある行が実行され始めると、デバッグは一時停止します。 一時停止中、実行＆デバッグウィンドウの変数セクションで、スニペット内のすべての変数の現在値を確認できます。

  1. Studioで、Snippetアクションを含むスクリプトを開きます。
  2. アクションでエディタを開く上部近くに横線のある長方形。 Snippetをクリックします。
  3. Snippetsomeがまだ含まれていない場合は、コードを追加します。
  4. スニペットエディターウィンドウの左側で、バグバグのアイコン。をクリックします。 実行とデバッグパネルがウィンドウの左側からスライドして出てきます。

  5. スニペットエディターウィンドウの任意の行の左の列をクリックして、ブレークポイントを追加します。 行番号の横に赤い丸が表示されます。 スニペットに複数のブレークポイントを追加できます。 デバッガーの実行中にブレークポイントを追加することもできます。

    ブレークポイントが設定されたスニペットの例。 スニペットの4行目の左側に赤い円として表示されます。

  6. 三角形右向き矢印の付いた三角形のアイコン。をクリックしてデバッグを開始します。
  7. 実行＆デバッグパネルの変数セクションの内容を確認します。 このセクションには、変数とブレークポイントでの値が表示されます(設定した場合)。 ブレークポイントでデバッグが一時停止した行は、スニペットエディターウィンドウで強調表示されます。 ダイナミックデータオブジェクトは、値{ダイナミック}を表示します。 クリックして展開し、メンバーの値を表示します。
  8. ブレークポイントの使用が完了したら、赤い丸をもう一度クリックしてクリアします。
  9. ブレークポイントからのデバッグを続行するには、再開横に三角形が表示された縦線のアイコン。をクリックします。 複数のブレークポイントを設定した場合、デバッガーは次のブレークポイントの直前に一時停止します。
  10. 現在のブレークポイントからコードを1行ずつステップ実行するには、下矢印下向き矢印のアイコン。をクリックします。 横に三角形が表示された縦線のアイコン。はいつでも再開して、デバッグを終了するか、次のブレークポイントにジャンプできます。

  11. デバッグプロセスの任意の時点で、_err変数のエラーをチェックします。 一部のエラーは、エディターウィンドウに閉じた トーストメッセージは、画面の下部に一時的に表示される小さなポップアップメッセージで、エラーや成功などを知らせるものです。 CXone Mpower機能に組み込まれていて、どの画面にも表示できます。トーストSnippet メッセージとしてポップアップ表示されます。

    __err変数を示すデバッガーウィンドウの変数セクション。

  12. デバッグを停止するには、四角形空の正方形のアイコン。をクリックします。
  13. スニペットを変更するには：
    1. デバッガーがまだ停止していない場合、デバッガーを停止します。 デバッガーの実行中、スニペットは読み取り専用モードです。
    2. 変更を加えます。
    3. エディタウィンドウで適用Snippetをクリックします。 エディターウィンドウが自動的に閉じます。 これにより、変更がサーバーに送信され、デバッグサービスが実行されます。
    4. Snippetエディターウィンドウを再度開き、デバッガーを再度実行します。

スニペットコードをステップスルーする

デバッガツールを使用して、スニペットコードを1行ずつステップスルーすることができます。 これにより、各行が実行されるたびに変数とその値がどのように変化するかを確認できます。

  1. Studioで、Snippetアクションを含むスクリプトを開きます。
  2. アクションでエディタを開く上部近くに横線のある長方形。 Snippetをクリックします。
  3. Snippetsomeがまだ含まれていない場合は、コードを追加します。
  4. スニペットエディターウィンドウの左側で、バグバグのアイコン。をクリックします。 実行とデバッグパネルがウィンドウの左側からスライドして出てきます。

  5. スニペットエディターウィンドウの任意の行の左の列をクリックします。 線の横に赤い丸が表示されます。 これはブレークポイントで、コードのステップ実行を開始できる場所をマークします。

    ブレークポイントが設定されたスニペットの例。 スニペットの4行目の左側に赤い円として表示されます。

  6. 三角形右向き矢印の付いた三角形のアイコン。をクリックしてデバッグを開始します。 ブレークポイントが最初の行にある場合、コードはまだ実行されていません。
  7. 実行＆デバッグパネルの変数セクションの内容を確認します。このセクションには、スニペットコードが開始する前に、コード内の変数とその値が表示されます。 ダイナミックデータオブジェクトは、値{ダイナミック}を表示します。 クリックして展開し、メンバーの値を表示します。
  8. 下矢印下向き矢印のアイコン。をクリックして、スニペットの次の行に移動します。 変数セクションは、スニペットコードの最初の行を実行した後、変数とその値を表示するように更新されます。
  9. スニペットの各行について、前述の2つのステップを繰り返します。 変数セクションは、各行の後に引き続き更新されます。
  10. コードの残りの行をスキップする場合は、再開横に三角形が表示された縦線のアイコン。をクリックします。 変数セクションには、スニペットコードがすべて実行された後の変数とその値が表示されます。

  11. デバッグプロセスの任意の時点で、_err変数のエラーをチェックします。 一部のエラーは、エディターウィンドウに閉じた トーストメッセージは、画面の下部に一時的に表示される小さなポップアップメッセージで、エラーや成功などを知らせるものです。 CXone Mpower機能に組み込まれていて、どの画面にも表示できます。トーストSnippet メッセージとしてポップアップ表示されます。

    __err変数を示すデバッガーウィンドウの変数セクション。

  12. デバッグを停止するには、四角形空の正方形のアイコン。をクリックし、必要に応じてデバッグプロセスを繰り返します。
  13. スニペットを変更するには：
    1. デバッガーがまだ停止していない場合、デバッガーを停止します。 デバッガーの実行中、スニペットは読み取り専用モードです。
    2. 変更を加えます。
    3. エディタウィンドウで適用Snippetをクリックします。 エディターウィンドウが自動的に閉じます。 これにより、変更がサーバーに送信され、デバッグサービスが実行されます。
    4. Snippetエディターウィンドウを再度開き、デバッガーを再度実行します。

TRACEキーワードを使用したデバッグ

TRACE キーワードを使用すると、ログ記録を使用したデバッグを行うことができます。 このキーワードは、Snippet エディターウィンドウでデバッガツールを使用する場合にのみ機能します。 スニペットコードに含めてデバッガーを実行すると、エディタウィンドウの実行＆デバッグウィンドウのトレースセクションにテキストが出力されます。Snippet

実行＆デバッグウィンドウのトレースセクションのスニペットコードからのTRACE出力を示すスニペットエディターウィンドウ。

TRACEキーワードは、Snippetエディターウィンドウの外では無視されます。 これはデバッガツールでのみ機能します。

構文は次のとおりです：TRACE "<expression>"

二重引用符内のテキストは、Snippetエディターウィンドウの実行＆デバッグウィンドウのトレースセクションに出力されます。

二重引用符の間で変数置換を使用すると、変数の値を出力できます。 例：

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

実行とデバッグウィンドウのトレースセクションでのこの例の出力は以下のようになります：

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