トレースおよびデバッグスクリプト

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

必須の権限ACD > Studio > スクリプト > Debug

スクリプトトレースを実行して、スクリプトの問題を確認できます。 これらにより、スクリプト内で起動するアクションと、各アクションが起動した時点でスクリプト内にある変数を確認できます。

各トレースは、個別のウィンドウで開きます。 したがって、以前のトレースを開いたままにして新しいトレースと比較したり、複数のライブコンタクトを続けてキャプチャしたりできます。

Studioは、キャプチャしたトレースの履歴を保持しません。 以前のトレースを参照する必要がある場合は、トレース出力ウィンドウを開いたままにするか、コンピューターにトレースファイルをダウンロードします。

単一のスクリプトトレースをキャプチャする

Trace Outputツールを使用して、スクリプトのパフォーマンスの追跡、スクリプトの生成、またはテスト呼び出しを行うことができます。 このツールは、コンタクトまたは実行中のスクリプトをトレースし、起動した各アクション、どの変数がいつ作成されたか、各ポイントで変数が保持した値を表示します。 これは、スクリプトのテストとデバッグに役立つツールです。 トレースは、ライブのインタラクションまたはシミュレートされたインタラクションで実行できます。

スクリプトが保存されている場合にのみトレースをキャプチャできます。 変更が保存されていないスクリプトでスクリプトトレースをキャプチャしようとすると、Studioはスクリプトを保存するようにプロンプトを表示します。 スクリプトにコンパイルエラーがある場合は、Studioはスクリプトを保存しません。 スクリプトを保存してトレースを実行する前に、エラーを解決する必要があります。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
  3. トレース > トレースで開始をクリックします。
  4. インバウンド電話ACD スキルを選択します。
  5. パラメーター変数を介してスクリプトに値を渡すには、パラメーターフィールドに値を入力します。 1行に1つの値を入力します。 入力した値は、パラメーターP1Pnにマッピングされます。ここで、nは、最後に追加するパラメーター値の番号です。
  6. インバウンド電話スクリプトのインタラクションをシミュレートするには、インバウンドコールのシミュレートをクリックし、必要な情報を入力します
  7. [キャプチャを開始]をクリックします。 トレース出力ウィンドウが開きます。 スクリプトの最初のアクションが起動するまで、ウィンドウは空のままです。
  8. トレース出力ウィンドウのオプションを使用して、トレースを調べます。
  9. トレース出力をコンピュータに保存するには、次のようにします
    1. ウィンドウの右上隅にある省略記号1列に並んだ3つの点。をクリックし、トレース ファイルのダウンロードを選択します。
    2. ファイルの場所と名前を選択します。
    3. 保存をクリックします。
  10. サーバー上のインタラクションを終了せずにトレースを終了するには、接続解除をクリックします。
  11. トレースとインタラクションの両方を終了するには、終了をクリックし、OKをクリックして確定します。 これにより、サーバー上のインタラクションが終了し、コンタクトが切断されるか、現在のスクリプトが終了します。

ライブコンタクトでトレースをキャプチャ

ライブコンタクトClosed コンタクトセンターでエージェント、IVR、またはボットとやり取りする人。の処理中に実行されるスクリプトのトレースをキャプチャできます。 これにより、コンタクトセンターの問題を診断したり、テクニカルサポート用のデータを収集したりできます。

特定の電話番号を追跡する場合は、ANIClosed 発信者IDとも呼ばれます。 着信音声通話のリストに表示される電話番号です。またはDNISClosed 着信または発信の音声通話でダイヤルされる番号。を入力できます。 Studioその番号のコンタクトのみを追跡します。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
  3. トレース > ライブコンタクトのキャプチャをクリックします。

  4. 追跡するコンタクト数を入力します。
  5. フィルターの下で、オプションを選択します:
    • None:このスクリプトの次回の実行時に、入力したコンタクトの数をトレースします。
    • DNIS:このオプションを選択し、DNIS番号を入力します。 Studioは、このDNISを持つ入力したコンタクトの数をトレースします。
    • ANI:このオプションを選択し、ANI番号を入力します。 Studioは、ANIが一致する入力されたコンタクトの数をトレースします。
  6. [キャプチャを開始]をクリックします。 トレース出力ウィンドウが開きます。 選択した Filter オプションに一致するスクリプトのインスタンスが実行を開始するまで、ウィンドウは空のままです。
  7. トレース出力ウィンドウのオプションを使用して、トレースを調べます。
  8. トレース出力をコンピュータに保存するには、次のようにします
    1. ウィンドウの右上隅にある省略記号1列に並んだ3つの点。をクリックしトレースファイルのダウンロードを選択します。
    2. ファイルの場所と名前を選択します。
    3. 保存をクリックします。
  9. サーバー上のインタラクションを終了せずにトレースを終了するには、接続解除をクリックします。
  10. トレースとインタラクションの両方を終了するには、終了をクリックし、OKをクリックして確定します。 これにより、サーバー上のインタラクションが終了し、コンタクトが切断されるか、現在のスクリプトが終了します。

複数ライブコンタクトのトレースをキャプチャする

ライブコンタクトClosed コンタクトセンターでエージェント、IVR、またはボットとやり取りする人。の処理中に実行されるスクリプトのトレースをキャプチャできます。 これにより、コンタクトセンターの問題を診断したり、テクニカルサポート用のデータを収集したりできます。

一度に最大20人のコンタクトのトレースを開始できます。 複数のトレースウィンドウが開き、スクリプトがライブコンタクトで実行されるのを待ちます。 コンタクトをフィルタリングするためにANIClosed 発信者IDとも呼ばれます。 着信音声通話のリストに表示される電話番号です。またはDNISClosed 着信または発信の音声通話でダイヤルされる番号。を指定した場合、スクリプトは一致する番号のコンタクトを待機します。 インタラクションClosed チャネルを介したエージェントとの会話全体。 たとえば、インタラクションには、音声通話、Eメール、チャット、またはソーシャルメディアでの会話があります。が始まると、各コンタクトのエントリが、指定した数まで複数トレースウィンドウに表示されます。 ウィンドウの左上隅にあるステータスには、進行中または完了中のトレースの数と、コンタクトの開始を待っているトレースの数が表示されます。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
  3. 追跡 > ライブコンタクトのキャプチャをクリックします。

  4. 追跡するコンタクト数1から20の範囲で入力します。
  5. フィルターの下で、オプションを選択します:
    • None:このスクリプトを次回実行したときに、入力したコンタクトの数をトレースします。
    • DNIS:このオプションを選択し、DNIS番号を入力します。 Studioは、このDNISを持つ入力したコンタクトの数を追跡します。
    • ANI:このオプションを選択し、ANI番号を入力します。 Studioは、ANIが一致する入力されたコンタクトの数をトレースします。
  6. [キャプチャを開始]をクリックします。 複数のトレースウィンドウが開きます。 連絡先に対してスクリプトの実行が開始されるまで、ウィンドウは空です。 各コンタクトに関する情報がウィンドウのテーブルに表示されます。 トレースの操作が終了するまで、このウィンドウを閉じないでください。 トレースデータは自動的に保存されません。

  7. 連絡先をフィルタリングして、表示する連絡先を見つけるには:
    • すべて閉じるの横にあるボタンをクリックして、オプションを選択します。 All完了Runningエラー、または Detached から選択できます。
    • 検索バーを使用します。 ステータスを除くすべての列が検索されます。
  8. 複数のトレースウィンドウで、コンタクトの1つの横にある3つのドット3つのドットが並んだアイコン。をクリックし、そのコンタクトのトレースのオプションを選択します。

  9. コンタクトをダブルクリックして、トレース出力を表示します。
  10. トレース出力ウィンドウのオプションを使用して、トレースを調べます。
  11. コンタクトに戻るをクリックして、複数のトレースウィンドウに戻ります。

トレース出力の表示

トレースを実行すると、出力が trace output ウィンドウに表示されます。 このウィンドウを使用して、スクリプト内の変数を表示し、スクリプトが各アクションClosed Studioスクリプト内で、顧客データの収集や音楽の再生などのプロセスを実行します。を実行するにつれて変数がどのように変化するかを確認できます。

スクリプトが実行されると、アクションはトレース出力ウィンドウの左側のテーブルに、起動した順序で表示されます。 アクション名、そのプロパティとその構成、アクションが起動された時刻、および結果を確認できます。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
  3. 単一のトレースまたは複数のコンタクトClosed コンタクトセンターでエージェント、IVR、またはボットとやり取りする人。でトレースを開始します。

  4. 複数のコンタクトでトレースを開始した場合は、複数のトレースウィンドウでコンタクトをダブルクリックして、トレース出力ウィンドウを開きます。

  5. アクション テーブルの上にある検索バーを使用して、名前、プロパティの名前または値、時間、または結果でアクションを検索します。
  6. 任意の列見出しをクリックすると、そのデータでリストが並べ替えられます。

  7. アクションのプロパティとその値に関する詳細情報を表示するには、プロパティ列のエントリにカーソルを合わせます。

  8. トレース出力でアクションをクリックすると、アクションが起動した時点でのスクリプト内のすべての変数とその値が表示されます。  

    変数は、トレース出力ウィンドウの右側にあるリストに表示されます。 新しい変数または変更された変数は赤で表示されます。 変数リストでは、次のことができます

    • エントリにカーソルを合わせると、その変数または値の完全な内容がポップアップウィンドウに表示されます。
    • リスト内の変数をフィルタリングするには、グローバルSystemまたはPrivateを選択またはクリアします。

    • 検索バーを使用して、変数を名前または値で検索します。
    • ダイナミックデータオブジェクトの名前の横にある大なり記号の>をクリックして展開し、そのメンバーとその値を表示します。
    • 変数をダブルクリックして、ポップアップウィンドウにその値を表示します。
    • 変数値をコピーするには、その行をクリックしてCTRL + Cを押します。 セルの背景が一時的に濃い青色に変わり、コピーが成功したことを示します。
    • 矢印キーを使用して、変数リスト内の強調表示された行間を移動します。

トレースファイルをダウンロード

トレース出力は、コンピューターにダウンロード可能なファイルとして保存できます。 これは、後でトレースを参照する必要がある場合に役立ちます。 また、トレースファイルを他のStudioユーザーやアカウント担当者に送信することもできます。 ファイルは、ロードStudioすることで表示できます。 ファイルは、TRC.JSON拡張子のJSON形式で保存されます。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
  3. トレースをクリックし、トレースから開始またはライブコンタクトをキャプチャを選択します。
  4. トレースがキャプチャされたら、トレース出力ウィンドウの右上隅にある省略記号1列に並んだ3つの点。をクリックします。
  5. トレースファイルをダウンロードを選択します。
  6. ファイル名とファイルの保存場所を指定します。
  7. [保存]をクリックします。

トレースファイルの読み込み

保存されたトレースファイルは、Studioにロードして表示できます。 ロードできるのは、Studio からダウンロードしたトレースファイルのみです。 Desktop Studioからダウンロードしたトレースファイルは、そのアプリケーションにロードする必要があります。

  1. CXone Mpowerで、アプリセレクターをクリックし、選択します:オムニチャネルルーティング>Studio根元でつながっている3本の矢。 1本は真上を、1本は右上を、1本は左上を指しています。
  2. スクリプトのページで、ロードをクリックし、トレースファイルのロードを選択します。
  3. トレースファイルをLoad Traceウィンドウにドラッグするか、ファイルを閲覧してファイルを選択します。
  4. ロードトレースウィンドウの開くをクリックします。 トレースは、トレース出力ウィンドウで開きます。