Debuggen von Snippets

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:

• Überprüfen Sie die Syntax im Snippet. Dies ist jederzeit während der Erstellung von Snippet-Code möglich. Der Debugger wird dabei nicht verwendet.
• 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.

Überprüfen der Snippet-Syntax

Sie können die Syntax in einem Snippet von Studio überprüfen lassen.

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Doppelklicken Sie auf die Snippet-Aktion.
3. Fügen Sie Snippet-Code auf der Registerkarte "Text View " hinzu, falls noch nicht vorhanden.

4. Klicken Sie auf das Symbol Check Syntax unten im Snippet -Editor-Fenster.

   Wenn keine Syntaxfehler gefunden werden, wird im Statusfeld neben dem Symbol "Syntax überprüfen" die folgende Meldung angezeigt: Okay.

   Wenn Syntaxfehler gefunden werden, wird eine Fehlermeldung mit einer Beschreibung des Fehlers eingeblendet. Die Beschreibung enthält auch die Nummer der Zeile, in der sich der Fehler befindet. Zusätzlich wird im Statusfeld neben dem Symbol "Syntax überprüfen" die folgende Meldung angezeigt: Error at line [#].

5. Korrigieren Sie etwaige Syntaxfehler.
6. Sie können eine oder mehrere Zeilen im Snippet-Code auswählen und auf das Symbol Comment out selected lines klicken. Dies ist hilfreich, wenn Sie einen Fehler überspringen und die restlichen Fehler überprüfen möchten.
7. Sie können eine oder mehrere auskommentierte Zeilen im Snippet-Code auswählen und auf das Symbol Uncomment the selected lines klicken.

Verwenden des Debugger-Werkzeugs

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Doppelklicken Sie auf die Snippet-Aktion.
3. Add Snippet code on the Text View tab, if it doesn't already contain some.
4. On the right side of the Snippet editor window, click the Debugger tab.
5. Click the down-arrow button on the right side of the Debug icon and select Start.

6. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

   View image

   
   1. Correct the errors.
   2. When the errors have been corrected, click the Close or Clear Trace Output icons to close the error pane.
   3. Start the debugger again.
7. View the contents of the Variables as Text tab. The tab shows the variables and their values when all of the code has been executed if you didn't set a breakpoint.
8. You can select one or more lines in the snippet code and click the Comment out selected lines icon . This is helpful if you want to remove some code to see how the outcome of the debugging changes.
9. You can select one or more lines of commented-out code and click the Uncomment the selected lines icon to add those lines back into the snippet.

Debuggen mit einem Haltepunkt

Sie können einen Haltepunkt setzen, wenn das Debuggen an einer bestimmten Zeile im Snippet-Code gestoppt werden soll. So können Sie die Variablen und Werte weiter hinten im Snippet anzeigen, ohne dass Sie es Zeile für Zeile durchgehen müssen.

1. Öffnen Sie in Studio ein Skript, das eine Snippet-Aktion enthält.
2. Doppelklicken Sie auf die Snippet-Aktion.
3. Add Snippet code on the Text View tab, if it doesn't already contain some.

4. Click in the column to the left of the line numbers in the Snippet editor window. A red circle appears at that line number.

   View image

   
5. On the right side of the Snippet editor window, click the Debugger tab.
6. Click the down-arrow button on the right side of the Debug icon and select Start.

7. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

   View image

   
   1. Correct the errors.
   2. When the errors have been corrected, click the Close or Clear Trace Output icons to close the error pane.
   3. Start the debugger again.
8. View the contents of the Variables as Text tab. The tab shows the variables and their values at the breakpoint, if you set one. The line where the debugging paused for the breakpoint is highlighted in the Snippet Editor window.
9. If you're done with the breakpoint, click the red circle again to clear it.
10. Set another breakpoint, if you need one.
11. To continue debugging from the breakpoint, click the Resume icon .
12. To stop debugging, click the Stop Debugging icon.

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. Doppelklicken Sie auf die Snippet-Aktion.
3. Add Snippet code on the Text View tab, if it doesn't already contain some.
4. On the right side of the Snippet editor window, click the Debugger tab.
5. Click the down-arrow button on the right side of the Debug icon and select Start.

6. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

   View image

   
   1. Correct the errors.
   2. When the errors have been corrected, click the Close or Clear Trace Output icons to close the error pane.
   3. Start the debugger again.
7. View the contents of the Variables as Text tab. It displays the variables in the code and their values when the snippet code starts.
8. Click the Step icon to move to the next line in the snippet.
9. Repeat steps the preceding two steps for each line in the snippet.
10. If you want to skip the remaining lines of code, click the Resume icon . The Variables as Text tab displays the variables and their values when all of the snippet code has executed.
11. To stop debugging, click the Stop Debugging icon, then repeat this process starting from step 3.

Anzeigen der Inhalte von dynamischen Objekten und Arrays

You can view the contents of dynamic objects in the Snippet editor window when you run the debugger. This allows you to verify that the object holds the data it's supposed to at each step in your code.

1. In Studio, double-click on a Snippet action.
2. Add snippet code, if necessary.
3. On the Debugger tab, click the Variables as Tree tab.
4. On the Debugger tab, click the down arrow next to the Start Debugging icon and select Step Into . If you don't want to step through the code line by line, click the Start Debugging icon.
5. Click the Step icon and observe the contents on the Variables as Tree tab. Each time you click Step, this field updates with the variables and objects in the script after the previous line of code. Skip this step if you clicked Start Debugging.
6. When you have stepped through all lines of code or if you clicked Start Debugging, the Variables as Tree tab displays all variables, objects, and their contents at the end of the snippet.

7. You can click the + icon next to any string arrays or dynamic objects in the code to expand them. If the content is another array or object, you can continue to expand the tree to see what each entity contains.

   View image

   

Debuggen mithilfe von TRACE

Sie können das Schlüsselwort TRACE  verwenden, um beim Debuggen Daten zu protokollieren. Dieses Schlüsselwort funktioniert nur, wenn Sie das Debugger-Werkzeug im Snippet -Editor-Fenster verwenden. Wenn Sie es in Ihren Snippet-Code einschließen und dann den Debugger ausführen, wird Text im Bereich "Trace " unten im Snippet -Editor-Fenster ausgegeben.

Außerhalb des Snippet -Editor-Fensters wird das Schlüsselwort TRACE ignoriert. Es funktioniert nur mit dem Debugger-Werkzeug.

Die Syntax lautet: TRACE "<text>"

Text, der in doppelten Anführungszeichen steht, wird im Snippet -Editor-Fenster ausgegeben. Er wird im Bereich "Trace " unten im Fenster angezeigt.

Sie können eine Variablenersetzung zwischen den doppelten Anführungszeichen verwenden, um den Wert der Variablen zu drucken. Beispiel:

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

Die Ausgabe für dieses Beispiel ist:

I = 1

I = 2

I = 3

I = 4

I = 5