Studioでスクリプトをデバッグする

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

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

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

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

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

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

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

CXone Mpowerで、アプリセレクターをクリックし、選択します：オムニチャネルルーティング>Studio。
スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。スクリプトが新しいタブで開きます。
トレース > トレースで開始をクリックします。
インバウンド電話ACD スキルを選択します。
パラメーター変数を介してスクリプトに値を渡すには、パラメーターフィールドに値を入力します。 1行に1つの値を入力します。入力した値は、パラメーターP1～Pnにマッピングされます。ここで、nは、最後に追加するパラメーター値の番号です。
インバウンド電話スクリプトのインタラクションをシミュレートするには、インバウンドコールのシミュレートをクリックし、必要な情報を入力します。
[キャプチャを開始]をクリックします。トレース出力ウィンドウが開きます。

スクリプトが実行されると、アクションが起動した順序でトレースウィンドウに表示されます。アクションの名前、プロパティとその設定、アクションが起動された時刻、および起動の結果を確認できます。以下の操作が可能です。
- プロパティ列のエントリの上にカーソルを置くと、ポップアップメニューにプロパティとその値の完全なリストが表示されます。
- 検索バーを使用して、トレース出力でアクションを検索します。アクション名、プロパティ名または値、時間、結果で検索できます。
- 任意の列見出しをクリックすると、そのデータでリストが並べ替えられます。
トレース出力でアクションをクリックすると、アクションが起動した時点でのスクリプト内のすべての変数とその値が表示されます。

トレース出力ウィンドウの右側にあるリストに変数が表示されます。新規または変更された変数は赤色で表示されます。

画像を表示

変数リストでは、次のことができます。
- 任意の列のエントリの上にカーソルを合わせると、その変数または値の完全な内容がポップアップメニューで表示されます。
- グローバル、システムまたはプライベートを選択またはクリアして、リスト内の変数をフィルタリングします。オプションをクリアすると、そのタイプの変数がリストに非表示になります。
- ダイナミックデータオブジェクト名の横にある大なり記号>をクリックして展開し、そのメンバーとその値を確認します。
- トレース出力ウィンドウの検索バーを使用して、名前または値で変数を検索します。
- 変数の値をコピーするには、その行をクリックしてキーボードでCTRL+Cを押します。セルの背景が一瞬濃い青になり、コピーが成功したことを示します。
- 矢印キーを使用して、変数リストのハイライト表示された行をナビゲートします。
トレース出力をコンピューターに保存するには、ウィンドウの右上隅にある省略記号をクリックし、トレースファイルをダウンロードを選択し、ファイルの場所と名前を選択して、を保存します。
サーバー上のインタラクションを終了せずにトレースを終了するには、接続解除をクリックします。
トレースとインタラクションを終了するには、終了をクリックし、次いでOKをクリックして、インタラクションの終了を確認します。これにより、コンタクトが切断されるか、現在実行中のスクリプトが終了し、サーバーでのインタラクションが終了します。

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

ライブコンタクトの処理中に実行されるスクリプトのトレースをキャプチャすることができます。これにより、コンタクトセンターで発生している問題を診断したり、テクニカルサポートでトラブルシューティングを行うためのデータを取得したりできます。

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

CXone Mpowerで、アプリセレクターをクリックし、選択します：オムニチャネルルーティング>Studio。
スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。スクリプトが新しいタブで開きます。
トレース>ライブコンタクトをキャプチャをクリックします。

画像を表示)
コンタクト数は現在1に設定されており、変更できません。将来のリリースでは、キャプチャするコンタクトの数を指定できるようになります。
フィルターの下で、オプションを選択します：
- なし：次にこのスクリプトがライブコンタクトで実行されたときをキャプチャするには、これを選択します。
- DNIS：これを選択し、DNIS番号を入力着信音声通話でコンタクトがダイヤルした番号と、発信音声通話でエージェントまたはシステムがダイヤルした番号を識別します。フィールドにDNISを入力します。次に一致するDNISで実行されるスクリプトのインスタンスがキャプチャされます。
- ANI：これを選択し、ANI番号を入力発信者IDとも呼ばれます。着信音声通話のリストに表示される電話番号です。フィールドにANIを入力します。一致するANIで実行されるスクリプトの次のインスタンスがキャプチャされます。
[キャプチャを開始]をクリックします。トレース出力ウィンドウが開きます。選択されたフィルタオプションに一致するスクリプトのインスタンスが実行を開始するまで、ウィンドウは空になります。

スクリプトが実行されると、アクションが起動した順序でトレースウィンドウに表示されます。アクションの名前、プロパティとその設定、アクションが起動された時刻、および起動の結果を確認できます。以下の操作が可能です。
- プロパティ列のエントリの上にカーソルを置くと、ポップアップメニューにプロパティとその値の完全なリストが表示されます。
- 検索バーを使用して、トレース出力でアクションを検索します。アクション名、プロパティ名または値、時間、結果で検索できます。
- 任意の列見出しをクリックすると、そのデータでリストが並べ替えられます。
トレース出力でアクションをクリックすると、アクションが起動した時点でのスクリプト内のすべての変数とその値が表示されます。

トレース出力ウィンドウの右側にあるリストに変数が表示されます。新規または変更された変数は赤色で表示されます。

画像を表示

変数リストでは、次のことができます。
- 任意の列のエントリの上にカーソルを合わせると、その変数または値の完全な内容がポップアップメニューで表示されます。
- グローバル、システムまたはプライベートを選択またはクリアして、リスト内の変数をフィルタリングします。オプションをクリアすると、そのタイプの変数がリストに非表示になります。
- ダイナミックデータオブジェクト名の横にある大なり記号>をクリックして展開し、そのメンバーとその値を確認します。
- トレース出力ウィンドウの検索バーを使用して、名前または値で変数を検索します。
- 変数の値をコピーするには、その行をクリックしてキーボードでCTRL+Cを押します。セルの背景が一瞬濃い青になり、コピーが成功したことを示します。
- 矢印キーを使用して、変数リストのハイライト表示された行をナビゲートします。
トレース出力をコンピューターに保存するには、ウィンドウの右上隅にある省略記号をクリックし、トレースファイルをダウンロードを選択し、ファイルの場所と名前を選択して、を保存します。
サーバー上のインタラクションを終了せずにトレースを終了するには、接続解除をクリックします。
トレースとインタラクションを終了するには、終了をクリックし、次いでOKをクリックして、インタラクションの終了を確認します。これにより、コンタクトが切断されるか、現在実行中のスクリプトが終了し、サーバーでのインタラクションが終了します。

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

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

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

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

保存されたトレースファイルは、Studioにロードして表示できます。

CXone Mpowerで、アプリセレクターをクリックし、選択します：オムニチャネルルーティング>Studio。
スクリプトのページで、ロードをクリックし、トレースファイルのロードを選択します。
トレースファイルをLoad Traceウィンドウにドラッグするか、ファイルを閲覧してファイルを選択します。
ロードトレースウィンドウの開くをクリックします。トレースは、トレース出力ウィンドウで開きます。