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

This help page is for Desktop Studio.This information is also available for CXone Studio.

Required permissions: ACD > Studio >スクリプト>デバッグ

Studio provides two ways you can check for issues in your scripts:

  • Check for syntax errors.
  • Run a script trace, which shows you what's happening as the script processes each action.

If you have Snippet actions in your script, you can debug the snippet code from within the Snippet editor window.

構文エラーをチェックする

構文エラーをチェックすると、スクリプトで見つかった問題がScript Errors タブに表示されます。このタブには、スニペットを含め、スクリプトに関連するすべての警告とエラーが表示されます。警告によってスクリプトの実行や保存が妨げられることはありませんが、エラーの場合は妨げられます。警告でスクリプトの動作が妨げられることはなくても、スクリプトを本番稼働させる前に、すべての警告に対処するのがベストプラクティスです。

構文チェックはスクリプトを保存すると自動的に実行されますが、それ以外のときもいつでも実行できます。エラーが含まれているスクリプトを実行したり保存することはできません。エラーのあるスクリプトを実行や保存しようとすると、Studioが通知ウィンドウを表示します。詳細については、Script Errors タブを確認してください。エラーには以下のようなものがあります。

  • 変数のスペルが間違っている。例:Snippet Line 2. Function: NameLabel has not been defined
  • 関数をメソッドのパラメーターとして使用している。例:Unterminated function parameters
  • 特定のデータタイプを必要とする関数で、誤ったデータタイプを使用している。例:Unterminated function parameters

Script Errorsタブに表示されないエラーもあります。一部の検証エラーは、その詳細とともにエラー通知ウィンドウに表示されます。検証エラーには、REST APIアクション内のJSONが無効であることなどが含まれます。スクリプトに検証エラーが含まれているときに保存しようとすると、検証エラーのないスクリプトの最新バージョンに戻ることがあります。この場合、保存されていない変更はすべて失われます。

Script Errorsタブ内の警告またはエラーをダブルクリックすると、問題が発生するキャンバスのアクションが表示されます。

  1. Studioで、スクリプトを開きます。
  2. Validation>Syntax Checkをクリックします。
  3. Script Errorsタブをクリックして、構文チェックの結果を表示します。
  4. Script Errorsタブの警告またはエラーをダブルクリックすると、問題が発生するキャンバスのアクションが表示されます。

スクリプトのトレース

You can track the progress and performance of your script with the tool.This tool traces the contact through the script and displays the results of each action that fired, what variables are being set and when, and the values the variables held at each point.This is a helpful tool to test and debug your scripts.You can run traces on live interactions or simulated ones.

トレースは、スクリプトが保存されている場合にのみ実行できます。未保存の変更があるスクリプトに対してスクリプトトレースを実行しようとすると、スクリプトを保存するよう促すプロンプトがStudioに表示されます。スクリプトにエラーがある場合、Studioはスクリプトを保存しません。スクリプトを保存してトレースを実行する前に、エラーを解決する必要があります。Any validation errors in the script cause Studio to revert to the last version of the script without the validation error. If you've started a trace, it runs, but will run on the last saved version of the script.

Trace Output ウィンドウを使用する

When you run a trace, the output appears in the window.You can use this window to view the variables in the script and see how they change as the script progresses through each action閉じた 顧客データの収集、メッセージや音楽の再生、エージェントへの連絡先のルーティングなど、Studioスクリプト内のプロセスを実行します。.

  1. Studioで、スクリプトを開いてトレースを実行するか、保存したトレースファイルを開きます。

  2. Trace Outputウィンドウの右上で、スクリプトの詳細ペインのアクションをクリックします。ライブトレースを監視している場合、スクリプトが進行して各アクションが実行されると、このペインがリアルタイムで更新されます。

  3. Trace Output ウィンドウ上部のツールバーにあるアイコンをクリックすると、スクリプトの詳細ペインの変数の詳細がすべて展開または折りたたまれトレース出力ウィンドウの「すべて展開」アイコンは、四角で囲まれた+印の横に水平線が何本も重なっていて、リストを表しています。ます。これは、追加の詳細を含んでいるすべての変数に影響します。これらの変数は、名前の横に+のアイコンが付いています。
  4. ウィンドウ下部のVariablesタブをクリックすると、選択したアクションが起動したときにスクリプトに存在するすべての変数をスクロールできます。

  5. Toolsアイコンをクリックしてオプションを選択すると、Variables タブに表示される変数を変更できます。

  6. Properties ペインで、選択したアクションのプロパティとその設定方法を確認できます。
  7. トレースを使って特定の変数を追跡したい場合、変数をウォッチリストに追加します。

トレース内の変数のビジビリティを変更する

You can change which sets of variables show in a trace.This allows you to focus on specific kinds of variables, depending on what you're looking for in the trace.

  1. Studioで、スクリプトを開いてトレースを実行します。
  2. Trace Output ウィンドウのツールバーで、Toolsアイコンをクリックします。
  3. トレースで表示または非表示にする変数セットのオプションを選択します。チェックマークが付いているオプションは、現在トレースで表示されています。

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

スクリプトの実行時にトレースをキャプチャできます。これはライブのコンタクトを処理する本番スクリプトで行うことができます。これにより、コンタクトセンターで発生している問題を診断したり、テクニカルサポートでトラブルシューティングを行うためのデータを取得したりできます。スクリプトの実行時に次のインスタンスでトレースをキャプチャするか、連続トレースをキャプチャするかを選択できます。連続トレースは、スクリプトが処理するすべてのインタラクションをキャプチャします。単一のトレースをキャプチャすると、その結果の情報がTrace Output ウィンドウに表示されます。

  1. Studioで、トレースをキャプチャするスクリプトを開きます。
  2. Debug>Capture Script>Next Instanceをクリックします。
  3. インタラクションが始まりスクリプトの実行が開始されると、Trace Output ウィンドウが開きます。スクリプトの実行中、ウィンドウにトレースが表示されます。

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

連続トレースは、スクリプトが処理するすべてのインタラクションをキャプチャします。トレース出力は、CXoneのファイルに保存されます。これらのファイルの保存場所は指定することができます。

  1. Studioで、トレースをキャプチャするスクリプトを開きます。
  2. Debug>Capture Script>Continuousをクリックします。Studioが、実行中のスクリプトのすべてのインスタンスのキャプチャを開始します。

トレースファイルを表示する

連続トレースから保存されたトレースファイルを表示できます。

  1. Studioで、Debugメニューをクリックしてから、システム上にあるトレースファイルを読み込むか、CXoneからリモートで読み込むかを選択します。
  2. 表示されるファイルウィンドウから、開きたいファイルを選択します。
  3. ボタンをクリックして、選択したトレースファイルを開きます。名前は、ローカルファイルかリモートファイルかによって異なります。選択したファイルがTrace Output ウィンドウに読み込まれます。
  4. CXoneからローカルコンピューターにトレースファイルをダウンロードする場合は、Trace Output ウィンドウのTools アイコントレースツールアイコン(X形に交差したハンマーとレンチ)。をクリックし、Save Trace Asを選択します。

特定のANIまたはDNISでトレースをキャプチャする

特定のANI閉じた 発信者IDとも呼ばれます。着信音声通話のリストされた電話番号。またはDNIS閉じた 着信音声通話のために連絡先がダイヤルした番号と、発信音声通話でエージェントまたはシステムがダイヤルした番号を識別します。を設定して、指定した番号からのコールがシステムに着信したときにトレースを起動できます。

  1. Studioで、トレースをキャプチャするスクリプトを開きます。
  2. Studioツールバーで、Trace Scriptドロップダウンをクリックし、Trace when ANI isまたはTrace when DNIS isを選択します。

  3. Insert <number>フィールドに、トレースをトリガーするANI番号またはDNIS番号を入力します。
  4. Capture Next Instanceアイコンをクリックします。クリックする回数によって次のように動作が異なります。
    • 指定した番号で実行されているスクリプトの次のインスタンスをトレースするには、1回クリックします。アイコンが赤色に変わります。
    • 指定した番号で実行されているスクリプトの将来のインスタンスを連続してトレースするには、2回クリックします。アイコンが2つの赤い円に変わります。
    • キャプチャをクリアするには、3回クリックします。アイコンが元のグレーに戻ります。
  5. 指定したANIまたはDNISでスクリプトが次回実行されると、トレースがキャプチャされてファイルに保存されます。

トレースで変数を監視する

特に関心のある変数のリストを作成できます。ウォッチリストを使用すると、トレース内で変数を検索しなくても、これらの変数のみを追跡することができます。リストを保存しておけば、特定のスクリプトでトレースを実行するたびに、ウォッチリストが保存されてTrace Output ウィンドウにロードされます。

  1. Studioで、トレースするスクリプトを開きます。
  2. スクリプトの初期トレースを実行します。
  3. Trace Output ウィンドウで、スクリプト詳細ペインのアクションのリストを順次クリックします。各アクションに関連付けられた変数がVariables タブに表示されます。
  4. ウォッチリストに追加する各変数について次を行います:
    1. Variables タブで変数を選択します。
    2. Add to Watch Listアイコンをクリックします。
  5. 名前がわかっている場合は、変数を次のように手動で追加できます。
    1. Trace Output ウィンドウのツールバーで、プラス記号アイコンをクリックします。Watch List タブに新しい変数のフィールドが表示されます。
    2. 監視する変数の名前を入力し、Enterを押します。
  6. ウォッチリストから変数を削除するには、Watch List タブでその変数を選択し、Trace Output ウィンドウのツールバーでマイナス記号アイコンをクリックします。
  7. このウォッチリストを保存するには、Trace Output ウィンドウのツールバーにあるToolsアイコンをクリックし、Save Watch Listを選択します。リストがStudioに保存されます。このスクリプトでトレースを実行するたびに、ウォッチリストがTrace Output ウィンドウに読み込まれます。
  8. ウォッチリスト内の変数を監視する準備ができたら、スクリプトで新しいトレースを実行します。