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

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

必須の権限：アプリケーション>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で、スクリプトを開いてトレースを実行するか、保存したトレースファイルを開きます。

    インバウンド音声スクリプトのトレース出力を表示するトレース出力ウィンドウ。
    フィールド 詳細
    IBVoice スクリプトの名前。IBVoice は、この画像の例にあるスクリプトの名前です。
    ツールバー

    スクリプト名の下には、Trace Output ウィンドウのツールバーがあります。このツールバーには以下を行えるオプションがあります。

    • トレース出力ウィンドウの表示とレイアウトのオプションのアイコン。空のウィンドウのような四角形。：表示されるペインやタブなど、Trace Output ウィンドウのレイアウトの変更。
    • トレース出力ウィンドウのツールアイコン（X形に交差したハンマーとレンチ）。：変数タブに表示される変数の変更、現在のウォッチリストの保存、現在のトレースのコンピューター上のファイルへの保存。
    • トレースウィンドウのツールバーのアイコンのセットで、ウォッチリストの作成と管理を行えます。：このトレースで監視したい変数のリストの作成と管理。
    • リスト内の情報を持つすべての変数やアクションを展開したり折りたたんだりできるアイコンのセット。：すべてのアクション、または情報を格納する変数の展開と折りたたみ。
    • トレースしているコンタクトIDおよびスクリプトの名前とパス。：ツールバーのこの部分には、現在のコンタクトのコンタクトIDが表示されます。また、トレース対象のスクリプトの名前とパスも表示されます。

    ツールバーの場所は変更できません。
    プロパティ

    Script Details ペインでアクションを選択すると、Propertiesペインにアクションのすべてのプロパティとその構成設定が表示されます。

    Propertiesペインのデフォルトの場所は、Trace Outputウィンドウの左上、ツールバーの下です。
    Script Details

    Script Detailsペインには、スクリプトの実行時に発生するすべてのアクションが、発生した順に表示されます。スクリプトに含まれていても発生しなかったアクション（実行されなかったブランチの一部であるアクションなど）は含まれません。

    アクションをクリックすると、その時点のスクリプト内のすべての変数がVariables タブに表示されます。

    スクリプト詳細ペインのデフォルトの場所は、Trace Outputウィンドウの右上、ツールバーの下です。

    このペインの列見出しについては、ステップ2のドロップダウンテーブルを参照してください。
    Variables タブ

    Script Details ペインで変数を選択すると、スクリプトに現在含まれているすべての変数がこのタブに表示されます。

    Variables タブのデフォルトの場所は、Trace Output ウィンドウの下部です。
    Watch List タブ

    スクリプトの実行時に追跡するスクリプト変数のリストを作成できます。追加した変数は、このタブに表示されます。

    Watch List タブのデフォルトの場所は、Trace Output ウィンドウの下部です。

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

    フィールド 詳細
    Script アクションを含むスクリプトの名前。メインスクリプトがサブスクリプトを生成する場合、リストに複数の名前が表示されることがあります。
    Time アクションが起動された時間。
    Action それぞれの引数を含むアクションの名前。引数は、アクションプロパティ内のすべての構成設定です。
    Result

    アクションの実行結果。これは、スクリプトがアクションを処理した結果、何が起こったかを示します。スクリプトがたどったブランチや、アクションが実行された結果発生したアクションなどです。

    たとえば、このセクションのステップ1の画像例では、DefaultとErrorはブランチです。DirectJump to 4とStartAt ONRELEASEは、これらのアクションが実行された結果です。DirectJump to 4は、コンタクトがIVR閉じた 発信者が音声コマンド、キー入力、またはその両方を介して対話し、情報を取得したり、着信音声通話をルーティングしたり、あるいはその両方を行うことができる自動電話メニュー。メニューでオプションを選択したため、スクリプトがアクションID 4のアクションにジャンプしたことを示します。StartAt ONRELEASEは、スクリプトが現在待機中であり、エージェントがインタラクションに応答すると再開されることを示します。
  3. Trace Output ウィンドウ上部のツールバーにあるアイコンをクリックすると、スクリプトの詳細ペインの変数の詳細がすべて展開または折りたたまれトレース出力ウィンドウの「すべて展開」アイコンは、四角で囲まれた＋印の横に水平線が何本も重なっていて、リストを表しています。ます。これは、追加の詳細を含んでいるすべての変数に影響します。これらの変数は、名前の横に＋のアイコンが付いています。

  4. ウィンドウ下部のVariablesタブをクリックすると、選択したアクションが起動したときにスクリプトに存在するすべての変数をスクロールできます。

    フィールド 詳細
    Name 変数の名前。名前がアンダースコア2文字で始まる変数はシステム変数です。
    Value 変数の値。これはスクリプトがアクションからアクションへと進むにつれて変化する可能性があります。
    Type 変数のタイプ。オプションには、標準の単一値変数を示すVariableと、ダイナミックデータオブジェクトを示すUCN.Data.Dynamicがあります。

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

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab.This includes global variables that are set in this script or are set in another script and can be used in this script.For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab.These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.
  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. トレースで表示または非表示にする変数セットのオプションを選択します。チェックマークが付いているオプションは、現在トレースで表示されています。

    Field Details
    Show Global Variables in Subs Select this option if you want global variables to appear in the Variables tab.This includes global variables that are set in this script or are set in another script and can be used in this script.For example, a subscript.

    Show System Variables

    Select this option if you want pre-defined system variables to appear in the Variables tab.These are variables added to the script automatically by the system, including the actions in the script.
    Show Private Members Select this option if you want private members to appear in the Variables tab.

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

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

    Studioツールバーのトレースオプションの画像。
  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. ウォッチリスト内の変数を監視する準備ができたら、スクリプトで新しいトレースを実行します。