Skripts testen und debuggen

Der Analytics-Skript-Editor beinhaltet mehrere Funktionen, die Ihnen beim Testen oder Debuggen von Analytics-Skripts helfen.

  • Skripts ab der Cursorposition innerhalb des Skripts ausführen
  • Haltepunkte setzen, um die Ausführung eines Skripts in einer spezifischen Zeile anzuhalten
  • Skripts schrittweise durchlaufen, indem jeweils nur eine einzelne Zeile ausgeführt wird
  • Skriptfehler isolieren
  • In der zugehörigen Registerkarte Variablen die Erstellung von Variablen sowie die Zuweisung von Werten an Variablen in Echtzeit überwachen

Diese Funktionen stehen immer dann zur Verfügung, wenn ein Skript im Skript-Editor geöffnet ist. Wenn das offene Skript ein oder mehrere Unterskripts aufruft, werden die Unterskripts automatisch im Moment ihres Aufrufs geöffnet.

Solange ein Skript im schrittweisen Modus oder im Haltepunktmodus ausgeführt wird, ist es schreibgeschützt, und die meisten anderen Analytics-Funktionen einschließlich der Befehlszeile sind deaktiviert. Wenn ein Skriptfehler auftritt, kann man das Skript wieder bearbeiten und Sie können den Fehler korrigieren.

Sobald Sie ein Skript ausführen, werden unabhängig von der Art der Ausführung alle offenen Skripts automatisch gespeichert.

Hinweis

Wenn eine Tabelle nach Abschluss der vollständigen oder schrittweisen Ausführung eines Skripts offen bleibt, schaltet der Analytics-Anzeigebereich vom Skript-Editor auf die Anzeige der offenen Tabelle in der Registerkarte „Ansicht“ um. Wenn Sie während des Testens und Debuggens von Skripts den Skript-Editor kontinuierlich anzeigen möchten, können Sie am Ende des Skripts den Befehl CLOSE vorübergehend einfügen.

Skripts ab der Cursorposition ausführen

Wenn Sie ein Skript nicht von seinem Anfang an ausführen möchten, können Sie den Cursor auf der Zeile positionieren, ab der die Skriptausführung beginnen soll. Wählen Sie dann mit der rechten Maustaste Ab Cursor ausführen oder Schritt ab Cursor. Wenn Sie Skripts ab der Cursorposition ganz oder schrittweise ausführen, können Sie bestimmte Abschnitte eines Skripts testen und sich die überflüssige Zeit zur Ausführung gesamter Skripts sparen.

Sie können Ab Cursor ausführen oder Schritt ab Cursor nicht mehr verwenden, wenn ein Skript bereits ausgeführt wird. Sie können diese Optionen nur verwenden, um die Ausführung eines Skripts zu beginnen oder ein Skript erneut nach dem Auftreten eines Fehlers zu beheben.

Hinweis

Wenn Sie die Skriptausführung ab der Cursorposition verwenden, um einen Abschnitt des Skripts zu umgehen, der Voraussetzungen für den späteren Abschnitt beinhaltet, wird der spätere Abschnitt voraussichtlich nicht ordnungsgemäß ablaufen.

Haltepunkte festlegen

Sie können in einem Analytics-Skript ein oder mehrere Haltepunkte festlegen, um die Ausführung des Skripts in einer spezifischen Zeile anzuhalten. Haltepunkte ermöglichen Ihnen den Test eines Skript-Abschnitts, ohne dazu das gesamte Skript ausführen zu müssen. Mit ihnen können Sie auch den Zustand eines Analytics-Projekts an einer spezifischen Stelle innerhalb des Skripts untersuchen. Haltepunkte können ein hilfreiches Tool sein, um komplexere oder kritische Abschnitte eines Skripts zu entwickeln und zu testen.

Skript von einem Haltepunkt erneut starten

Um ein Skript von einem Haltepunkt erneut zu starten, stehen Ihnen die folgenden Optionen zur Verfügung:

  • Skript schrittweise bis zum Haltepunkt durchlaufen
  • Skript bis zum nächsten Haltepunkt ausführen, falls Sie einen solchen eingefügt haben
  • Skript bis zum Ende ausführen
  • Skript beenden

Leerzeilen und Kommentare

Wenn Sie einen Haltepunkt auf einer leeren Zeile oder einer Kommentarzeile festlegen, hält das Skript auf der ersten Zeile nach der leeren Zeile oder dem Kommentar an.

Persistenz von Haltepunkten

  • Haltepunkte bleiben in einem Skript auch nach dem Schließen des Skripts bestehen.
  • Sie können jederzeit alle Haltepunkte aus allen Skripts eines Analytics-Projekts entfernen, indem Sie im Skript-Editor die rechte Maustaste klicken und Alle Haltepunkte löschen auswählen.
  • Wenn Sie Analytics schließen, werden automatisch alle Haltepunkte von allen Skripts eines Projekts entfernt.

Schritte

Haltepunkte festlegen

  1. Öffnen Sie das Analytics-Skript, in dem Sie ein oder mehrere Haltepunkte festlegen möchten .
  2. Klicken Sie innerhalb des Analytics-Skripts direkt links neben der Zielzeile auf die Haltepunktspalte.

    Die Haltepunktspalte befindet sich zwischen der Zeilennummernspalte und dem linken Rand des Skripts.

    Sie können einen Haltepunkt auch festlegen, indem Sie den Cursor in der Zielzeile des Skripts positionieren und F9 drücken oder indem Sie in der Skript-Editor-Symbolleiste auf Haltepunkt umschalten  klicken.

  3. Um einen Haltepunkt zu entfernen, klicken Sie auf den Haltepunkt oder positionieren den Cursor in der Zielzeile und drücken F9 bzw. Sie klicken auf Haltepunkt umschalten .

Skript mit Haltepunkt ausführen

  1. Klicken Sie auf Ausführen  oder drücken Sie F5. Das Skript wird dann bis zum Haltepunkt ausgeführt.

    Das Skript beginnt abzulaufen und wird am Haltepunkt angehalten. Solange ein Skript im Haltepunktmodus ausgeführt wird, ist es schreibgeschützt. Die meisten anderen Analytics-Funktionen, einschließlich der Befehlszeile, sind dann deaktiviert.

  2. Um den Haltepunkt zu überschreiten, klicken Sie auf Ausführen  oder drücken F5.

    Das Skript läuft bis zum nächsten Haltepunkt ab. Wenn es keine weiteren Haltepunkte mehr gibt, wird die Ausführung des Skripts abgeschlossen.

  3. Falls der Schrittpfeil rot wird und in einer Zeile anhält, deutet dies einen Fehler an, das Skript wird editierbar und Sie können den Fehler beheben. Danach fahren Sie wie folgt fort:
    • Führen Sie das Skript ab dem Fehler oder von einer anderen Zeile weiter aus, indem Sie den Cursor in der jeweiligen Zeile positionieren, mit der rechten Maustaste klicken und Ab Cursor ausführen auswählen.
    • Starten Sie das Skript erneut vom Anfang durch Anklicken von Ausführen  oder indem Sie F5 drücken.

    Wenn eine Tabelle beim Auftreten des Fehlers offen ist, schaltet der Analytics-Anzeigebereich vom Skript-Editor automatisch auf die Anzeige der offenen Tabelle in der Registerkarte „Ansicht“ um. Schalten Sie wieder auf den Skript-Editor zurück, um den Fehler zu beheben.

  4. Wenn Sie das Skript vor seinem Ende verlassen möchten, drücken Sie Esc und klicken in der Bestätigungsmeldung auf Ja.

    Sie können das Skript auch beenden, indem Sie Analytics schließen.

  5. Wenn Sie nach einem Haltepunkt oder nach dem Beheben eines Fehlers das restliche Skript schrittweise durchlaufen möchten, gehen Sie wie folgt vor:
    • Nach einem Haltepunkt klicken Sie auf Schritt  oder drücken F10.
    • Nachdem Sie einen Fehler behoben haben, positionieren Sie den Cursor in der jeweiligen Zeile, klicken mit der rechten Maustaste und wählen Schritt ab Cursor.

Schrittweise Ausführung von Skripts

Sie können ein Analytics-Skript schrittweise durchlaufen, indem jeweils nur eine einzelne Zeile ausgeführt wird. Durch die schrittweise Ausführung eines Skripts können Sie ein Skript kontrolliert testen und Fehler genau in der Zeile entdecken, in der sie auftreten.

Der Schrittpfeil

Grüner Pfeil Während der schrittweisen Ausführung eines Skripts deutet der grüne Schrittpfeil  die als nächstes auszuführende Zeile an. Wenn sich der Pfeil einen Schritt über die Zeile bewegt, wurde diese ausgeführt.

Roter Pfeil Falls die Zeile eine ungültige Befehlssyntax oder eine sonstige Fehlerart enthält, stoppt das Skript. Der Schrittpfeil wird rot , bewegt sich nicht mehr weiter und hebt die Fehlerstelle hervor. Während der schrittweisen Ausführung ist das Skript schreibgeschützt. Wenn jedoch ein Fehler auftritt, kann es wieder bearbeitet werden, sodass Sie den Fehler korrigieren können.

Schritte

  1. Öffnen Sie das Analytics-Skript, das Sie schrittweise durchlaufen möchten.
  2. Klicken Sie wiederholt auf Schritt oder drücken Sie F10.

    Das Skript beginnt, wenn Sie Schritt klicken oder F10 drücken. Immer wenn Sie Schritt klicken oder F10 drücken, wird nacheinander eine einzelne Zeile ausgeführt.

    Solange ein Skript schrittweise ausgeführt wird, ist es schreibgeschützt und die meisten anderen Analytics-Funktionen, einschließlich der Befehlszeile, sind deaktiviert.

  3. Falls der Schrittpfeil rot wird , deutet dies einen Fehler an, das Skript wird editierbar und Sie können den Fehler beheben. Danach fahren Sie wie folgt fort:
    • Durchlaufen Sie das Skript ab dem Fehler oder ab einer anderen Zeile, indem Sie den Cursor in der jeweiligen Zeile positionieren, mit der rechten Maustaste klicken und Schritt ab Cursor auswählen.
    • Starten Sie das Skript erneut vom Anfang durch Anklicken von Schritt oder indem Sie F10 drücken.

    Wenn eine Tabelle beim Auftreten des Fehlers offen ist, schaltet der Analytics-Anzeigebereich vom Skript-Editor automatisch auf die Anzeige der offenen Tabelle in der Registerkarte „Ansicht“ um. Schalten Sie wieder auf den Skript-Editor zurück, um den Fehler zu beheben.

  4. Wenn Sie das Skript vor seinem Ende verlassen möchten, drücken Sie Esc und klicken in der Bestätigungsmeldung auf Ja.

    Sie können das Skript auch beenden, indem Sie Analytics schließen.

  5. Falls Sie an einem beliebigen Punkt das restliche Skript kontinuierlich ablaufen lassen möchten, klicken Sie Ausführen oder drücken Sie F5.

Skriptfehler isolieren

Wenn Sie ein Skript in Analytics ausführen, in dem ein Fehler auftritt, der das Skript scheitern lässt, wird stets die Zeile des Fehlers automatisch im Skript-Editor hervorgehoben. Falls der Skript-Editor nicht geöffnet ist, wird er automatisch geöffnet. Diese Identifizierung von Skriptfehlern wird unabhängig davon vorgenommen, ob Sie ein Skript direkt im Skript-Editor, aus dem Menü Extras, der Befehlszeile oder durch Anklicken mit der rechten Maustaste im Navigator ausführen.

Die automatisierte Fehleridentifizierung ist eine leistungsfähige Methode zur Fehlerbehebung, insbesondere bei Fehlern, die tief in verschachtelten Unterskripts auftreten. Analytics-Benutzer mit Skripting-Berechtigung können Fehler korrigieren, sobald sie angezeigt werden. Benutzer mit fehlender Skripting-Erfahrung können den Namen des Skripts und die Zeilennummer des aufgetretenen Fehlers aufzeichnen, wodurch es einfacher ist, Hilfe mit Skriptproblemen zu erhalten.

Registerkarte „Variablen“ verwenden

Mit der Registerkarte Variablen des Navigators können Sie die Erstellung von Variablen sowie die Zuweisung von Werten an Variablen in Echtzeit überwachen. Die Registerkarte zeigt die Namen, Werte und Datenkategorien aller Variablen des Analytics-Projekts an. Die Namen sind alphabetisch aufgelistet.

Wenn Sie ein Skript schrittweise durchlaufen, erscheinen alle benutzerdefinierten oder durch das System erstellten Variablen des Skripts zum Zeitpunkt ihrer Erstellung in der Registerkarte Variablen. Ihr Wert wird auch aktualisiert, falls sie bereits zuvor bestanden hatten. Die genaue Beobachtung von Änderungen der Skriptvariablen in Echtzeit ist zur Diagnose sehr hilfreich und ermöglicht Ihnen, Skriptfehler zu finden, die durch eine reine Untersuchung der Skriptsyntax nur schwer zu erkennen wären.

Wenn Sie ein Skript ausführen, werden alle mit Variablen zusammenhängenden Veränderungen angezeigt, sobald ein Haltepunkt erreicht wird oder sobald das Skript beendet ist.

Mehrzeilige Befehle

Eine schrittweise Ausführung von mehrzeiligen Befehlen wie GROUP, LOOP oder DEFINE FIELD . . . COMPUTED. Wenn Sie ein Skript schrittweise durchlaufen und auf einen mehrzeiligen Befehl treffen, wird der gesamte Inhalt des Befehls ausgeführt und der Schrittpfeil wird auf der unmittelbar auf den mehrzeiligen Befehl folgenden Zeile des Skripts positioniert.

Innerhalb von mehrzeiligen Befehlen werden keine Haltepunkte erkannt. Wenn Sie einen Haltepunkt innerhalb eines mehrzeiligen Befehls festlegen, wird das Skript in der Zeile unmittelbar nach dem Ende des mehrzeiligen Befehls angehalten.

Sie können Teile eines mehrzeiligen Befehls unter Umständen testen, indem Sie den Inhalt ohne die umschließende Befehlssyntax in ein separates Skript kopieren.

Testen einer Analyse, die ein PASSWORD-Tag benötigt

Wenn Sie eine Analyse durch eine Ausführung in Analytics testen und die Analyse ein oder mehrere PASSWORD-Tags aufweist, erstellt Analytics automatisch einen PASSWORD-Befehl und fordert Sie auf, das jeweilige Kennwort einzugeben. Dieser automatisch erstellte Befehl spart Ihnen die Arbeit, PASSWORD-Befehle in den Skriptteil einer Analyse zu Testzwecken eingeben zu müssen, nur um sie dann vor der Zustellung der Analyse an die Benutzer wieder zu entfernen. Der automatisch erstellte PASSWORD-Befehl wird im Protokoll ohne den Wert des Kennworts gespeichert.

Werte des Kennworts werden nicht gespeichert, wenn Sie eine Analyse in Analytics ausführen. Sie müssen das oder die Kennwörter jedes Mal bei der Ausführung der Analyse eingeben, auch wenn Sie eine Ausführung ab der Cursorposition durchführen oder die Analyse schrittweise durchlaufen.

Analytics-Analysen sind normale Analytics-Skripts mit zusätzlichen Anmerkungen, die ihre Ausführung im Fenster „Analyse-App“, einer eigenständigen Komponente von Analytics, sowie in Analytics Exchange ermöglichen.