Debug-Snippets in Studio

Sie können Snippets im Snippet-Editor-Fenster debuggen. Mit dem Debugger können Sie die Variablen im Snippet-Code sehen. Dies kann Ihnen helfen, Probleme im Code zu beheben. Zum Debuggen von Snippets stehen fünf Optionen zur Verfügung:

• Debuggen Sie das ganze Snippet, um Variablen und ihre Werte zu sehen, nachdem das ganze Snippet ausgeführt wurde.
• Setzen Sie einen Haltepunkt, damit das Debuggen an einer bestimmten Codezeile gestoppt wird.
• Gehen Sie die Zeilen im Snippet-Code Schritt für Schritt durch, um zu sehen, wie sich die Variable und ihre Werte in jeder Zeile ändern.
• Verwenden Sie TRACE-Anweisungen, um Daten im Bereich Trace im Snippet -Editor-Fenster auszugeben.

Wenn Ihr Code dynamische Objekte oder Arrays enthält, können Sie auch deren Inhalte anzeigen und sehen, wie sich die Inhalte ändern.

Verwenden des Debugger-Werkzeugs

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Klicken Sie bei der Aktion auf Editor öffnen Snippet.
3. Fügen Sie Snippet Code hinzu, falls dieser nicht bereits einen enthält.
4. Klicken Sie auf der linken Seite des Snippet-Editor-Fensters auf den Fehler . Das Bedienfeld „Ausführen und Debuggen“ wird auf der linken Seite des Fensters eingeblendet.
5. Klicken Sie auf das Dreieck , um mit dem Debuggen zu beginnen.
6. Zeigen Sie den Inhalt des Abschnitts „Variablen“ des Bedienfelds „Ausführen und Debuggen“ an. Dieser Abschnitt zeigt die Variablen und ihre Werte, wenn der Debugger den gesamten Snippet-Code ausgeführt hat. Dynamische Datenobjekte zeigen den Wert {Dynamisch} an. Klicken Sie, um sie zu erweitern und die Werte ihrer Mitglieder anzuzeigen.

7. Überprüfen Sie während des Debugvorgangs jederzeit, ob die Variable _err Fehler enthält. Einige Fehler werden als Toast Toast-Meldungen sind kleine, temporäre Pop-up-Meldungen am unteren Rand des Bildschirms, die z. B. Fehler und Erfolge anzeigen. Sie sind in die Funktionalität von CXone Mpower integriert und können auf jedem Bildschirm angezeigt werden.-Meldungen im Snippet Editor-Fenster angezeigt.

   Bild anzeigen

   

8. So nehmen Sie Änderungen an Ihrem Snippet vor:
   1. Stoppen Sie den Debugger, falls er nicht bereits gestoppt ist. Während der Debugger ausgeführt wird, befindet sich das Snippet im schreibgeschützten Modus.
   2. Nehmen Sie Ihre Änderungen vor.
   3. Klicken Sie im Editorfenster auf ÜbernehmenSnippet. Das Editorfenster schließt sich automatisch. Dadurch werden die Änderungen an den Server gesendet, auf dem der Debugging-Dienst ausgeführt wird.
   4. Öffnen Sie das Snippet Editorfenster erneut und führen Sie den Debugger erneut aus.

Debuggen mit einem Haltepunkt

Sie können einen Haltepunkt setzen, wenn das Debuggen an einer bestimmten Zeile im Snippet-Code gestoppt werden soll. Sie können mehrere Haltepunkte festlegen und den Debugger von Haltepunkt zu Haltepunkt springen lassen. Dadurch können Sie die Variablen und Werte an bestimmten Stellen im Snippet anzeigen, ohne es Zeile für Zeile durchgehen zu müssen.

Sie können Haltepunkte setzen, bevor Sie den Debugger starten oder während er läuft. Das Debuggen wird angehalten, wenn die Zeile mit dem Haltepunkt ausgeführt werden soll. Während der Pause können Sie den aktuellen Wert aller Variablen im Snippet im Abschnitt „Variablen“ des Fensters „Ausführen und Debuggen“ sehen.

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Klicken Sie bei der Aktion auf Editor öffnen Snippet.
3. Fügen Sie Snippet Code hinzu, falls dieser nicht bereits einen enthält.
4. Klicken Sie auf der linken Seite des Snippet-Editor-Fensters auf den Fehler . Das Bedienfeld „Ausführen und Debuggen“ wird auf der linken Seite des Fensters eingeblendet.

5. Fügen Sie einen Haltepunkt hinzu, indem Sie im Snippet-Editorfenster in die Spalte links neben einer beliebigen Zeile klicken. Neben der Zeilennummer wird ein roter Kreis angezeigt. Sie können dem Snippet mehr als einen Haltepunkt hinzufügen. Sie können auch Haltepunkte hinzufügen, während der Debugger ausgeführt wird.

   Bild anzeigen

   

6. Klicken Sie auf das Dreieck , um mit dem Debuggen zu beginnen.
7. Zeigen Sie den Inhalt des Abschnitts „Variablen“ des Bedienfelds „Ausführen und Debuggen“ an. Dieser Abschnitt zeigt die Variablen und ihre Werte am Haltepunkt, falls Sie einen festgelegt haben. Die Zeile, an der der Debugging-Vorgang wegen des Haltepunkts angehalten wurde, ist im Snippet-Editor-Fenster hervorgehoben. Dynamische Datenobjekte zeigen den Wert {Dynamisch} an. Klicken Sie, um sie zu erweitern und die Werte ihrer Mitglieder anzuzeigen.
8. Wenn Sie mit einem Haltepunkt fertig sind, klicken Sie erneut auf den roten Kreis, um ihn zu löschen.
9. Um vom Haltepunkt aus mit dem Debuggen fortzufahren, klicken Sie auf „Fortsetzen“ . Wenn Sie mehr als einen Haltepunkt gesetzt haben, hält der Debugger direkt vor dem nächsten an.
10. Um den Code vom aktuellen Haltepunkt aus zeilenweise durchzugehen, klicken Sie auf den Abwärtspfeil . Sie können jederzeit fortsetzen, um das Debuggen abzuschließen oder zum nächsten Haltepunkt zu springen.

11. Überprüfen Sie während des Debugvorgangs jederzeit, ob die Variable _err Fehler enthält. Einige Fehler werden als Toast Toast-Meldungen sind kleine, temporäre Pop-up-Meldungen am unteren Rand des Bildschirms, die z. B. Fehler und Erfolge anzeigen. Sie sind in die Funktionalität von CXone Mpower integriert und können auf jedem Bildschirm angezeigt werden.-Meldungen im Snippet Editor-Fenster angezeigt.

    Bild anzeigen

    

12. Um das Debuggen zu beenden, klicken Sie auf das Quadrat .
13. So nehmen Sie Änderungen an Ihrem Snippet vor:
    1. Stoppen Sie den Debugger, falls er nicht bereits gestoppt ist. Während der Debugger ausgeführt wird, befindet sich das Snippet im schreibgeschützten Modus.
    2. Nehmen Sie Ihre Änderungen vor.
    3. Klicken Sie im Editorfenster auf ÜbernehmenSnippet. Das Editorfenster schließt sich automatisch. Dadurch werden die Änderungen an den Server gesendet, auf dem der Debugging-Dienst ausgeführt wird.
    4. Öffnen Sie das Snippet Editorfenster erneut und führen Sie den Debugger erneut aus.

Snippet-Code Schritt für Schritt durchgehen

Sie können das Debugger-Werkzeug verwenden, um den Snippet-Code Zeile für Zeile durchzugehen. So können Sie sehen, wie sich die Variablen und ihre Werte ändern, während die einzelnen Zeilen ausgeführt werden.

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Klicken Sie bei der Aktion auf Editor öffnen Snippet.
3. Fügen Sie Snippet Code hinzu, falls dieser nicht bereits einen enthält.
4. Klicken Sie auf der linken Seite des Snippet-Editor-Fensters auf den Fehler . Das Bedienfeld „Ausführen und Debuggen“ wird auf der linken Seite des Fensters eingeblendet.

5. Klicken Sie im Snippet-Editorfenster in die Spalte links neben einer beliebigen Zeile. Neben der Linie wird ein roter Kreis angezeigt. Dies ist ein Haltepunkt, der die Stelle markiert, an der Sie mit der schrittweisen Durcharbeitung des Codes beginnen können.

   Bild anzeigen

   

6. Klicken Sie auf das Dreieck , um mit dem Debuggen zu beginnen. Wenn der Haltepunkt in der ersten Zeile liegt, wird noch kein Code ausgeführt.
7. Zeigen Sie den Inhalt des Abschnitts „Variablen“ des Bedienfelds „Ausführen und Debuggen“ an. Dieser Abschnitt zeigt die Variablen im Code und ihre Werte, bevor der Snippet-Code beginnt. Dynamische Datenobjekte zeigen den Wert {Dynamisch} an. Klicken Sie, um sie zu erweitern und die Werte ihrer Mitglieder anzuzeigen.
8. Klicken Sie auf den Abwärtspfeil , um zur nächsten Zeile im Snippet zu gelangen. Der Abschnitt „Variablen“ wird aktualisiert und zeigt nach der Ausführung der ersten Codezeile die Variablen und ihre Werte an.
9. Wiederholen Sie die beiden vorhergehenden Schritte für jede Zeile im Snippet. Der Abschnitt „Variablen“ wird nach jeder Zeile weiter aktualisiert.
10. Wenn Sie die restlichen Codezeilen überspringen möchten, klicken Sie auf „Fortsetzen“ . Der Abschnitt „Variablen“ zeigt die Variablen und ihre Werte an, wenn der gesamte Snippet-Code ausgeführt wurde.

11. Überprüfen Sie während des Debugvorgangs jederzeit, ob die Variable _err Fehler enthält. Einige Fehler werden als Toast Toast-Meldungen sind kleine, temporäre Pop-up-Meldungen am unteren Rand des Bildschirms, die z. B. Fehler und Erfolge anzeigen. Sie sind in die Funktionalität von CXone Mpower integriert und können auf jedem Bildschirm angezeigt werden.-Meldungen im Snippet Editor-Fenster angezeigt.

    Bild anzeigen

    

12. Um das Debuggen zu stoppen, klicken Sie auf das Quadrat und wiederholen Sie anschließend den Debugging-Prozess bei Bedarf.
13. So nehmen Sie Änderungen an Ihrem Snippet vor:
    1. Stoppen Sie den Debugger, falls er nicht bereits gestoppt ist. Während der Debugger ausgeführt wird, befindet sich das Snippet im schreibgeschützten Modus.
    2. Nehmen Sie Ihre Änderungen vor.
    3. Klicken Sie im Editorfenster auf ÜbernehmenSnippet. Das Editorfenster schließt sich automatisch. Dadurch werden die Änderungen an den Server gesendet, auf dem der Debugging-Dienst ausgeführt wird.
    4. Öffnen Sie das Snippet Editorfenster erneut und führen Sie den Debugger erneut aus.

Debuggen mit dem Schlüsselwort TRACE

Mit dem TRACE Schlüsselwort können Sie mithilfe der Protokollierung Fehler beheben. Dieses Schlüsselwort funktioniert nur, wenn Sie das Debugger-Werkzeug im Snippet -Editor-Fenster verwenden. Wenn Sie es in Ihren Snippet-Code einfügen und den Debugger ausführen, wird Text im Abschnitt „Trace“ des Fensters „Ausführen und Debuggen“ im Snippet Editorfenster ausgegeben.

Das Schlüsselwort TRACE wird außerhalb des Snippet-Editorfensters ignoriert. Es funktioniert nur mit dem Debugger-Werkzeug.

Die Syntax lautet: TRACE "<expression>"

Text in Anführungszeichen wird im Abschnitt „Trace“ des Fensters „Ausführen und Debuggen“ im Editorfenster Snippet ausgegeben.

Sie können die Variablenersetzung zwischen den Anführungszeichen verwenden, um den Wert der Variablen auszudrucken. Beispiel:

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

Die Ausgabe dieses Beispiels im Abschnitt „Trace“ des Fensters „Ausführen und Debuggen“ lautet:

I = 1
I = 2
I = 3
I = 4
I = 5