Debuggen von Scripts

Hinweis  Diese Funktion ist verfügbar, wenn die allgemeine Einstellung Erweiterte Werkzeuge verwenden ausgewählt ist. Weitere Informationen finden Sie unter Verwenden von erweiterten Werkzeugen.

Der Script-Debugger ist ein interaktives Werkzeug für die Fehlerbehebung in Ihren FileMaker-Scripts.

Sie können zum Beispiel Scripts debuggen, die über das Menü „Scripts“ oder Tastaturbefehle ausgeführt werden, ebenso Scripts, die durch einen Script-Trigger, eine Taste oder angepasste Menüs ausgelöst werden. Und Sie können Script-Trigger temporär deaktivieren oder aktivieren, während Sie im Script-Debugger arbeiten.

So debuggen Sie Scripts:

  1. Aktivieren Sie den Script-Debugger auf eine der folgenden Arten:
    • Wählen Sie Werkzeuge > Script-Debugger und führen Sie dann Ihr Script aus.
    • Wählen Sie Scripts > Scriptarbeitsbereich, wählen Sie dann Ihr Script und klicken Sie auf Schaltfläche „Debug“. Um alle geöffneten Scripts zu speichern und dann das Script zu debuggen, müssen Sie die Umschalttaste (Windows) bzw. die Wahltaste (macOS) gedrückt halten und auf Schaltfläche „Debug“ klicken.
  2. Verwenden Sie diese Befehle, um das Script zu debuggen:
  3. Auswahl

    Für

    Übergehen

    Schaltfläche „Übergehen“

    Führen Sie das Script schrittweise ohne die Eingabe von Teilscripts aus.

    Wenn der Scriptschritt „Script ausführen“ lautet, wird der Script-Debugger das Teilscript ausführen und dann mit der nächsten Zeile des aufrufenden Scripts fortfahren. Der Script-Debugger wird alle Teilscriptschritte ausführen, bis er auf einen Haltepunkt trifft.

    Schritt beginnen

    Schaltfläche „Schritt beginnen“

    Führen Sie das Script schrittweise aus und geben Sie außerdem Schritte in Teilscripts ein.

    Wenn der Scriptschritt „Script ausführen“ lautet, wird der Script-Debugger zur ersten Zeile des Teilscripts springen und auf eine Benutzereingabe warten, bevor er mit dem nächsten Teilscriptschritt fortfährt.

    Schritt beenden

    Schaltfläche „Schritt beenden“

    Führen Sie alle Scriptschritte im aktuellen Script aus und kehren Sie, wenn das Script ein Teilscript ist, zur Zeile nach dem Schritt „Script ausführen“ im aufrufenden Script zurück.

    Wenn das Script kein Teilscript ist, bewirkt der Befehl „Schritt beenden“, dass der Script-Debugger alle verbleibenden Script- und Teilscriptschritte ausführt, bis er einen Haltepunkt findet.

    Nächsten Schritt setzen

    Schaltfläche „Nächsten Schritt setzen“

    Den Ausführungszeiger auf den hervorgehobenen Scriptschritt setzen.

    Dieser Befehl übergibt die Kontrolle an den hervorgehobenen Schritt, führt den Schritt aber nicht aus. Der hervorgehobene Schritt wird ausgeführt, wenn die Scriptausführung oder der Debugging-Schritt wieder aufgenommen wird. Eventuelle Schritte zwischen dem letzten ausgeführten Schritt und dem vorgesehenen nächsten Schritt werden nicht ausgeführt. Klicken Sie auf einen Schritt, um ihn hervorzuheben, und klicken Sie dann auf Schaltfläche „Nächsten Schritt setzen“ im Script-Debugger.

    Ausführen

    Schaltfläche „Ausführen“

    Anhalten

    Schaltfläche „Pause“

    Schalten Sie zwischen der Ausführung aller Scriptschritte, bis das Ende eines Scripts oder ein Haltepunkt gefunden wird, und Pause um. Wenn ein Script pausiert, können Sie auf das Script in der Liste Call-Stack doppelklicken, um es zu bearbeiten. Jedes aktive Script öffnet sich in einem eigenen Register im Scriptarbeitsbereich, so dass Sie mehrere Scripts bearbeiten können. Die Scriptausführung wird erst angehalten, wenn Sie die Änderungen speichern.

    Sie können mit Schaltfläche „Schritt beginnen“ im Script-Debugger schrittweise durch ein Script gehen, wenn ein Script pausiert.

    Alle Scripts abbrechen

    Schaltfläche „Alle Scripts abbrechen“

    Die Ausführung eines Scripts anhalten.

    Script-Trigger aktivieren/deaktivieren

    Schaltfläche „Script-Trigger aktivieren/deaktivieren“, die anzeigt, dass Script-Trigger deaktiviert sind 

    Alle Script-Trigger in einer Datei vorübergehend deaktivieren oder aktivieren.

    Sie benötigen volle Zugriffsrechte, um einen Script-Trigger zu deaktivieren. Script-Trigger sind standardmäßig aktiviert. Wenn Sie den Script-Debugger schließen, werden alle deaktivierten Script-Trigger aktiviert.

    Script bearbeiten

    Schaltfläche „Script bearbeiten“

    Öffnet das aktuelle Script im Dialogfeld „Script bearbeiten“. Sie können Änderungen an einem Script vornehmen, während es ausgeführt wird. Die Ausführung wird jedoch angehalten, sobald Sie Änderungen an einem Script speichern.

    Datenanzeige öffnen/schließen

    Schaltfläche „Datenanzeige öffnen/schließen“

    Öffnet (bzw. schließt) das Datenanzeige-Fenster, so dass Sie bestimmte Felder, Variablen und Formeln kontrollieren können. Weitere Informationen finden Sie unter Verwenden der Datenanzeige.

    Script authentifizieren/deauthentifizieren

    Sperrsymbol, um den Script-Debugger oder die Datenanzeige zu authentifizieren Entsperrsymbol, um den Script-Debugger oder die Datenanzeige zu deauthentifizieren

    Den Script-Debugger oder die Datenanzeige für Scripts entsperren, die das Bearbeiten von Berechtigungen nicht erlauben.

    Sie benötigen volle Zugriffsrechte, um ein Script zu authentifizieren. Die höhere Berechtigungsstufe gilt für alle Scripts, nicht jedoch für andere Dateielemente (z. B. Datensätze und Layouts). Ihre Bearbeitungsrechte gelten, bis Sie den Script-Debugger und die Datenanzeige schließen.

  4. Wählen Sie Pause bei Fehler, wenn Scripts beim Auftreten von Fehlern pausieren sollen.

Anzeigen von Teilscripts

Sie können Teilscripts anzeigen, wenn Sie Scripts schrittweise im Script-Debugger prüfen. Wenn z. B. Script A Script B aufruft, das dann Script C aufruft, können Sie die Schritte in allen drei Scripts anzeigen.

  1. Wählen Sie Werkzeuge > Script-Debugger.
  2. Führen Sie ein Script aus, das ein Teilscript aufruft.
  3. Klicken Sie auf Schritt beginnen.

    Die Liste Call-Stack zeigt das Teilscript an.

  4. Wählen Sie ein Script aus der Liste Call-Stack aus, um die Schritte dieses Scripts im Anzeigebereich darzustellen.

Hinweise 

  • Klicken Sie auf die Zeilennummer links neben dem Scriptschritt, um einen Haltepunkt festzulegen oder zu löschen. Haltepunkte ermöglichen dem Script-Debugger, große Abschnitte des Scripts auszuführen, wobei nur pausiert wird, um den mit einem Haltepunkt markierten Abschnitt zu überprüfen. Haltepunkte werden von FileMaker Pro bei deaktiviertem Script-Debugger ignoriert. Sie können Haltepunkte für mehrere Schritte setzen. Sie können keine Haltepunkte für Scriptschritte setzen, die durch eine Taste oder ein angepasstes Menü aufgerufen werden.
  • Um das Debuggen eines Scripts richtig durchzuführen, übergeht der Script-Debugger einige Scriptschritte. Der Scriptschritt „AnwenderAbbruchZulassen setzen“ mit der Option „Aus“ verhindert nicht, dass Sie die Ausführung eines Scripts stoppen können. Der Scriptschritt „Fenster anpassen“ mit den Optionen „Ausblenden“ oder „Minimieren“ blendet das Fenster nicht aus oder minimiert es nicht, wenn er über die Schaltflächen Schaltfläche „Übergehen“ oder Schaltfläche „Schritt beginnen“ auftritt.
  • Wenn ein Script mit auf „Veränderbar“ gesetzten Zugriffsrechten ein Script mit dem Zugriff „Nur ausführbar“ ausführt, wird das Script mit dem Zugriff „Nur ausführbar“ vollständig ausgeführt, ohne dass seine Scriptschritte im Script-Debugger angezeigt werden. Wenn ein Script mit dem Zugriff „Nur ausführbar“ ein Script mit dem Zugriff „Veränderbar“ ausführt, werden nur die Scriptschritte des Scripts mit dem Zugriff „Veränderbar“ im Script-Debugger angezeigt. Klicken Sie im Script-Debugger auf Schaltfläche „Script authentifizieren/deauthentifizieren“ im Script-Debugger, um ein Script zu bearbeiten. Weitere Informationen zu Scriptberechtigungen und dem Ausführen von Scripts mit vollem Zugriff finden Sie unter Bearbeiten von Script-Zugriffsrechten.

    Wenn Sie die Datenanzeige öffnen, nachdem Sie auf Schaltfläche „Script authentifizieren/deauthentifizieren“ im Script-Debugger geklickt haben, werden Ihre Zugriffsrechte für die Datenanzeige und den Script-Debugger beibehalten, bis Sie den Script-Debugger schließen.

  • Sie können ein Startscript debuggen, indem Sie den Script-Debugger öffnen, bevor Sie Ihre Datenbankdatei öffnen.
  • Wenn Sie den Script-Debugger schließen, während ein Script pausiert, wird das Script fortgesetzt und bis zum Ende ausgeführt.