Debuggen von Skripten in Desktop Studio

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

Erforderliche Berechtigungen: Anwendungen > Studio > Skripte > Fehler beheben

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.

Überprüfen der Syntax auf Fehler

Wenn Sie die Syntax überprüfen, um eventuelle Fehler zu finden, werden im Skript festgestellte Fehler auf der Registerkarte "Script Errors " angezeigt. Die Registerkarte enthält alle Warnungen und Fehler in Bezug auf Ihr Skript, auch in Snippets. Wenn Warnungen vorliegen, kann das Skript dennoch ausgeführt und gespeichert werden, bei Fehlern aber nicht. Obwohl das Skript trotz der Warnungen ausgeführt werden kann, wird empfohlen, alle Warnungen zu beheben, bevor das Skript in der Produktionsumgebung verwendet wird.

Syntaxprüfungen werden automatisch beim Speichern eines Skripts ausgeführt, Sie können sie aber auch jederzeit manuell ausführen. Ein Skript, das Fehler enthält, kann weder ausgeführt noch gespeichert werden. Wenn Sie versuchen, ein fehlerhaftes Skript auszuführen oder zu speichern, zeigt Studio ein Hinweisfenster an. Auf der Registerkarte "Script Errors " finden Sie weitere Informationen. Fehler sind beispielsweise:

  • Falsch geschriebene Variablen. Zum Beispiel: Snippet Line 2. Function: NameLabel has not been defined.
  • Verwendung einer Funktion als Methodenparameter. Zum Beispiel: Unterminated function parameters.
  • Verwendung eines falschen Datentyps in einer Funktion, die einen bestimmten Datentyp erfordert. Zum Beispiel: Unterminated function parameters.

Einige Fehler werden möglicherweise nicht auf der Registerkarte "Script Errors" angezeigt. Einige Validierungsfehler werden in einer Fehlermeldung mit Fehlerdetails angezeigt. Ein Validierungsfehler tritt beispielsweise auf, wenn die REST API-Aktion ungültigen JSON-Code enthält. Wenn Sie versuchen zu speichern, während das Skript einen Überprüfungsfehler enthält, kehrt das Skript möglicherweise zur letzten Version des Skripts ohne den Überprüfungsfehler zurück. Wenn dies geschieht, gehen alle nicht gespeicherten Änderungen verloren.

Doppelklicken Sie auf der Registerkarte "Script Errors" auf eine Warnung oder einen Fehler, um im Arbeitsbereich die Aktion anzuzeigen, bei der das Problem aufgetreten ist.

  1. Öffnen Sie in Studio ein Skript.
  2. Klicken Sie auf Validation > Syntax Check.
  3. Klicken Sie auf die Registerkarte "Script Errors", um die Ergebnisse der Syntaxüberprüfung anzuzeigen.
  4. Doppelklicken Sie auf der Registerkarte "Script Errors" auf eine Warnung oder auf einen Fehler, um im Arbeitsbereich die Aktion anzuzeigen, bei der das Problem aufgetreten ist.

Skript-Traces

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.

Ein Trace kann nur ausgeführt werden, wenn das Skript gespeichert wurde. Wenn Sie versuchen, einen Trace für ein Skript auszuführen, das nicht gespeicherte Änderungen enthält, werden Sie von Studio aufgefordert, das Skript zu speichern. Wenn das Skript Fehler enthält, wird es in Studio nicht gespeichert. Sie müssen alle Fehler beheben, bevor Sie das Skript speichern und den Trace ausführen können. 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.

Verwenden des Fensters "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 actionGeschlossen Führt einen Prozess innerhalb eines Studio-Skripts durch, wie z. B. das Erfassen von Kundendaten, Abspielen einer Nachricht oder Musik oder die Weiterleitung eines Kontakts zu einem Agenten..

  1. Öffnen Sie in Studio ein Skript und führen Sie einen Trace aus oder öffnen Sie eine gespeicherte Trace-Datei.

    Das Fenster "Trace-Ausgabe" mit der Trace-Ausgabe für ein Skript für eine eingehende Sprachinteraktion.
    Feld Details
    IBVoice Der Name des Skripts. IBVoice ist der Name des Skripts in diesem Beispielbild.
    Symbolleiste

    Unter dem Skriptnamen befindet sich die Symbolleiste des Fensters "Trace Output ". Mit den Optionen in der Symbolleiste können Sie folgende Aufgaben ausführen:

    • Das Symbol für die Optionen "Ansicht" und "Layout" im Fenster "Trace-Ausgabe". Ein Rechteck, das einem leeren Fenster ähnelt.: Ändern Sie das Layout des Fensters "Trace Output ". Beispielsweise können Sie festlegen, welche Bereiche und Registerkarten sichtbar sind.
    • Das Symbol für "Extras" im Fenster "Trace-Ausgabe", ein Hammer und ein Schraubenschlüssel, die in Form eines X übereinanderliegen.: Ändern Sie die Variablen, die auf der Registerkarte "Variablen" angezeigt werden, speichern Sie die aktuelle Überwachungsliste und speichern Sie den aktuellen Trace in einer Datei auf Ihrem Computer.
    • Die Symbole in der Symbolleiste des Trace-Fensters, mit denen Sie eine Überwachungsliste erstellen und verwalten können.: Erstellen und verwalten Sie eine Liste der Variablen, die in diesem Trace überwacht werden sollen.
    • Die Symbole, mit denen Sie alle Variablen oder Aktionen erweitern und reduzieren können, in denen Informationen aufgelistet sind.: Erweitern oder reduzieren Sie alle Aktionen oder Variablen, die Informationen enthalten.
    • Die Kontakt-ID und der Name und Pfad des Skripts, das per Trace nachverfolgt wird.: In diesem Bereich der Symbolleiste wird die Kontakt-ID des aktuellen Kontakts angezeigt. Sie sehen hier auch den Namen und den Pfad des Skripts, das per Trace überwacht wird.

    Die Position der Symbolleiste kann nicht geändert werden.
    Eigenschaften

    Wenn Sie eine Aktion im Bereich "Script Details " auswählen, werden im Bereich "Properties" alle Eigenschaften der Aktion sowie die zugehörigen Konfigurationseinstellungen angezeigt.

    Der Bereich "Properties" befindet sich standardmäßig oben links im Fenster "Trace Output" unterhalb der Symbolleiste.
    Script Details

    Der Bereich "Script Details" zeigt der Reihe nach alle Aktionen, die bei der Ausführung des Skripts ausgelöst werden. Aktionen, die im Skript enthalten sind, aber nicht ausgelöst wurden, werden nicht in diesem Bereich angezeigt. Dies sind beispielsweise Aktionen, die zu einer Verzweigung gehören, die nicht genommen wurde.

    Wenn Sie auf eine Aktion klicken, werden alle Variablen, die im Skript an dieser Stelle auftreten, auf der Registerkarte "Variables " angezeigt.

    Der Bereich mit den Skriptdetails befindet sich standardmäßig oben rechts im Fenster "Trace Output" unterhalb der Symbolleiste.

    Einzelheiten zu den Spaltenüberschriften in diesem Bereich finden Sie in der Dropdown-Tabelle in Schritt 2.
    Registerkarte Variables 

    Wenn Sie im Bereich "Script Details " eine Variable auswählen, werden alle Variablen, die sich derzeit im Skript befinden, auf dieser Registerkarte angezeigt.

    Die Registerkarte "Variables " befindet sich standardmäßig unten im Fenster "Trace Output ".
    Registerkarte Watch List 

    Sie können eine Liste der Skriptvariablen erstellen, die Sie beim Ausführen des Skripts nachverfolgen möchten. Die Variablen, die Sie hinzufügen, werden auf dieser Registerkarte angezeigt.

    Die Registerkarte "Watch List " befindet sich standardmäßig unten im Fenster "Trace Output ".

  2. Klicken Sie oben rechts im Fenster "Trace Output" im Bereich mit den Skriptdetails auf eine Aktion. Wenn Sie einen Live-Trace nachverfolgen, wird dieser Bereich in Echtzeit aktualisiert, während das Skript ausgeführt wird und jede Aktion auslöst.

    Feld Details
    Script Der Name des Skripts, das die Aktion enthält. Wenn ein Hauptskript ein Subskript generiert, wird in der Liste möglicherweise mehr als ein Name angezeigt.
    Time Die Uhrzeit, zu der die Aktion ausgelöst wurde.
    Action Der Name der Aktion, einschließlich der jeweiligen Argumente. Bei den Argumenten handelt es sich um die Konfigurationseinstellungen in den Eigenschaften der Aktion.
    Result

    Das Ergebnis der ausgelösten Aktion. Dies zeigt das Resultat der Aktion, die vom Skript verarbeitet wurde. Dabei kann es sich um die Verzweigung handeln, die das Skript genommen hat, oder die Aktion, die das Resultat der ausgelösten Aktion war.

    Beispiel: Im Beispielbild in Schritt 1 dieses Abschnitts sind Default und Error Verzweigungen. DirectJump to 4 und StartAt ONRELEASE sind die Ergebnisse dieser ausgelösten Aktionen. DirectJump to 4 gibt an, dass der Kontakt im IVRGeschlossen Automatisiertes Telefonmenü, das es Anrufern ermöglicht, durch Sprachbefehle, Tasteneingaben oder beides zu interagieren, um Informationen zu erhalten, einen eingehenden Sprachanruf weiterzuleiten oder beides.-Menü eine Option ausgewählt hat, die das Skript dazu veranlasst hat, zur Aktion mit der ID 4 zu springen. StartAt ONRELEASE gibt an, dass das Skript derzeit wartet und dann fortfährt, wenn ein Agent die Interaktion beantwortet.
  3. Klicken Sie in der Symbolleiste oben im Fenster "Trace Output " auf die Symbole, um alle Details für die Variablen im Bereich mit den Skriptdetails zu erweitern oder zu reduzieren Das Symbol „Alle erweitern“ im Fenster „Trace-Ausgabe“, ein Quadrat mit einem Pluszeichen und mehreren horizontalen Linien daneben, die eine Liste darstellen. Dies wirkt sich auf alle Variablen aus, die zusätzliche Details enthalten. Sie erkennen diese Variablen an dem Plussymbol (+) neben dem Namen.

  4. Klicken Sie unten im Fenster auf die Registerkarte "Variables", um durch alle Variablen zu blättern, die beim Auslösen der ausgewählten Aktion im Skript vorhanden waren.

    Feld Details
    Name Der Name der Variablen. Variablen, deren Namen mit zwei Unterstrichen beginnen, sind Systemvariablen.
    Value Der Wert der Variablen. Dieser Wert kann sich ändern, während das Skript von einer Aktion zur nächsten übergeht.
    Type Die Art der Variablen. Verfügbare Optionen sind Variable für standardmäßige Variablen mit einem Wert oder UCN.Data.Dynamic für dynamische Datenobjekte.

  5. Klicken Sie auf das Symbol Tools und wählen Sie eine Option aus, um festzulegen, welche Variablen auf der Registerkarte "Variables " angezeigt werden.

    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. Im Bereich "Properties " werden die Eigenschaften der ausgewählten Aktion und deren Konfigurationseinstellungen angezeigt.
  7. Fügen Sie Variablen einer Überwachungsliste hinzu, wenn Sie beim Trace bestimmte Variablen nachverfolgen möchten.

Ändern der Sichtbarkeit von Variablen in einem Trace

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. Öffnen Sie in Studio ein Skript und führen Sie einen Trace aus.
  2. Klicken Sie im Fenster "Trace Output " in der Symbolleiste auf das Symbol Tools.

  3. Wählen Sie die Option für die Variablen aus, die Sie im Trace ein- oder ausblenden möchten. Optionen, die mit einem Häkchen gekennzeichnet sind, sind derzeit im Trace sichtbar.

    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.

Erfassen eines Skript-Trace

Sie können einen Trace für ein Skript erfassen, während es ausgeführt wird. Dies ist bei Produktionsskripten möglich, die Live-Kontakte verarbeiten. Auf diese Weise können Sie Probleme in Ihrem Contact Center diagnostizieren oder Daten für die Fehlerbehebung durch den technischen Support erfassen. Sie können einen Trace bei der nächsten Ausführung des Skripts oder einen kontinuierlichen Trace erfassen. Bei einem kontinuierlichen Trace wird jede Interaktion erfasst, die das Skript verarbeitet. Wenn Sie einen einzelnen Trace erfassen, werden die resultierenden Informationen im Fenster "Trace Output " angezeigt.

  1. Öffnen Sie in Studio das Skript, für das Sie einen Trace erfassen möchten.
  2. Klicken Sie auf Debug > Capture Script > Next Instance.
  3. Wenn eine Interaktion und damit die Ausführung des Skripts beginnt, wird das Fenster "Trace Output " geöffnet. Im Fenster wird der Trace angezeigt, während das Skript ausgeführt wird.

Erfassen eines kontinuierlichen Skript-Trace

Bei einem kontinuierlichen Trace wird jede Interaktion erfasst, die vom Skript verarbeitet wird. Die Trace-Ausgabe wird in Dateien in Ihrem CXone gespeichert. Sie können angeben, wo diese Dateien gespeichert werden sollen.

  1. Öffnen Sie in Studio das Skript, für das Sie einen Trace erfassen möchten.
  2. Klicken Sie auf Debug > Capture Script > Continuous. Studio beginnt mit der Erfassung aller Instanzen des ausgeführten Skripts.

Anzeigen von Trace-Dateien

Sie können die Trace-Dateien anzeigen, die bei einem kontinuierlichen Trace gespeichert wurden.

  1. Klicken Sie in Studio auf das Menü Debug und geben Sie dann an, ob Sie eine Trace-Datei laden möchten, die sich in Ihrem System oder an einem externen Ort in Ihrem CXone- befindet.
  2. Daraufhin wird ein Datei-Fenster eingeblendet. Wählen Sie hier die Datei aus, die Sie öffnen möchten.
  3. Klicken Sie auf die Schaltfläche zum Öffnen der ausgewählten Trace-Datei. Der Name variiert, je nachdem, ob Sie eine lokale oder eine externe Datei öffnen. Die ausgewählte Datei wird im Fenster "Trace Output " geöffnet.
  4. Wenn Sie Trace-Dateien von CXone auf Ihren lokalen Computer herunterladen möchten, klicken Sie auf das Symbol Tools Das Symbol für die Trace-Werkzeuge, ein Hammer und ein Schraubenschlüssel, die in Form eines X übereinanderliegen. im Fenster "Trace Output " und wählen Sie dann Save Trace As aus.

Erfassen eines Trace mit einer bestimmten ANI oder DNIS-Nummer

Sie können eine bestimmte ANIGeschlossen Auch als Anrufer-ID bezeichnet. Gelistete Telefonnummer eines eingehenden Sprachanrufs. oder DNISGeschlossen identifiziert die Nummer des gewählten Kontakts, der Sie für eingehende Sprachanrufe erreichen möchte und die Nummer des gewählten Agenten oder Systems für ausgehende Sprachanrufe. festlegen, um eine Ablaufverfolgung auszulösen, wenn ein Anruf von der angegebenen Nummer in das System eingeht.

  1. Öffnen Sie in Studio das Skript, für das Sie einen Trace erfassen möchten.

  2. Klicken Sie in der Studio-Symbolleiste auf das Dropdown-Menü Trace Script und wählen Sie Trace when ANI is oder Trace when DNIS is aus.

    Bild der Trace-Optionen in der Studio-Symbolleiste.
  3. Geben Sie die ANI oder DNIS-Nummer, die den Trace auslösen soll, in das Feld Insert <number> ein.
  4. Klicken Sie auf das Symbol Capture Next Instance . Das Verhalten ändert sich je nachdem, wie oft Sie klicken: 
    • Klicken Sie einmal, um einen Trace bei der nächsten Ausführung des Skripts mit der angegebenen Nummer zu erstellen. Das Symbol wird rot.
    • Klicken Sie zweimal, um für zukünftige Ausführungen des Skripts mit der angegebenen Nummer einen kontinuierlichen Trace zu erstellen. Das Symbol ändert sich in zwei rote Kreise.
    • Klicken Sie dreimal, um die Erfassung zu löschen. Das Symbol nimmt wieder die ursprüngliche graue Farbe an.
  5. Wenn das Skript das nächste Mal mit der angegebenen ANI oder DNIS-Nummer ausgeführt wird, wird ein Trace erfasst und in einer Datei gespeichert.

Überwachen von Variablen in einem Trace

Sie können eine Liste der Variablen erstellen, die für Sie von besonderem Interesse sind. Die Überwachungsliste ermöglicht es Ihnen, nur diese Variablen nachzuverfolgen, ohne dass Sie sie im Trace suchen müssen. Sie können die Liste speichern, damit sie immer dann, wenn Sie einen Trace für das jeweilige Skript ausführen, gespeichert und in das Fenster "Trace Output " geladen wird.

  1. Öffnen Sie in Studio das Skript, für das Sie einen Trace ausführen möchten.
  2. Führen Sie einen ersten Trace für das Skript aus.
  3. Klicken Sie im Fenster "Trace Output " im Bereich mit den Skriptdetails nacheinander auf die Aktionen in der Liste. Die Variablen der einzelnen Aktionen werden auf der Registerkarte "Variables " angezeigt.
  4. Führen Sie für jede Variable, die Sie der Überwachungsliste hinzufügen möchten, die folgenden Schritte aus:
    1. Wählen Sie die Variable auf der Registerkarte "Variables " aus.
    2. Klicken Sie auf das Symbol Add to Watch List .
  5. Wenn Sie den Namen einer Variablen kennen, können Sie sie manuell hinzufügen:
    1. Klicken Sie im Fenster "Trace Output " in der Symbolleiste auf das Pluszeichen. Die Registerkarte "Watch List " wird eingeblendet. Sie enthält ein Feld für eine neue Variable.
    2. Geben Sie den Namen der Variablen ein, die Sie überwachen möchten, und drücken Sie die Eingabetaste.
  6. Wenn Sie eine Variable aus der Überwachungsliste entfernen möchten, wählen Sie sie auf der Registerkarte "Watch List " aus. Klicken Sie dann im Fenster "Trace Output " in der Symbolleiste auf das Minuszeichen.
  7. Wenn Sie diese Überwachungsliste speichern möchten, klicken Sie in der Symbolleiste des Fensters "Trace Output " auf das Symbol Tools und wählen Sie Save Watch List aus. Die Liste wird in Studio gespeichert. Bei jeder Trace-Ausführung für dieses Skript wird die Überwachungsliste im Fenster "Trace Output " geladen.
  8. Wenn Sie die Variablen in Ihrer Überwachungsliste nachverfolgen möchten, führen Sie einen neuen Trace für das Skript aus.