Start > Verwenden von FileMaker Pro Advanced > Verwenden von FileMaker Pro Advanced-Werkzeugen > Debuggen von Scripts (FileMaker Pro Advanced)

Debuggen von Scripts (FileMaker Pro Advanced)

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

Mit dem Script-Debugger können Sie:

•	Scripts debuggen, die vom Scripts-Menü oder über Tastaturbefehle ausgeführt werden.

•	Startscripts debuggen. (Das Menü „Script-Debugger” ist auch aktiviert, wenn keine Dateien geöffnet sind.)

•	Ein Script debuggen, das durch einen Script-Trigger, eine Taste oder ein angepasstes Menü aktiviert wird.

•	In ein Teilscript wechseln, um es schrittweise auszuführen, oder ein Teilscript verlassen.

•	Haltepunkte in Ihrem Script setzen oder löschen.

•	Mit dem Debugging in einem beliebigen Scriptschritt innerhalb des Scripts beginnen.

•	Anzeige von Teilscripts beim Durchgehen durch Scripts

•	Scripts mit beschränktem Zugriff debuggen.

•	Ein Script pausieren, wenn Scriptfehler erkannt werden.

•	Felder, Variablen und Formeln kontrollieren.

•	Script-Trigger temporär deaktivieren bzw. 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 Extras > 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 . Um alle geöffneten Scripts zu speichern und dann das Script zu debuggen, müssen Sie Umschalt (Windows) bzw. Option (OS X) gedrückt halten und auf klicken.

2.	Verwenden Sie diese Befehle, um das Script zu debuggen:

 

Auswahl	Für
Ü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	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	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	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 .
Ausführen 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 Fenster „Scriptarbeitsbereich”, so dass Sie mehrere Scripts bearbeiten können. Die Scriptausführung wird erst angehalten, wenn Sie die Änderungen speichern. Sie können mit schrittweise durch ein Script gehen, wenn ein Script pausiert.
Alle Scripts abbrechen	Die Ausführung eines Scripts anhalten.
Script-Trigger aktivieren/deaktivieren	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. Sie können auch Werkzeuge > Debugging-Steuerelemente > Script-Trigger deaktivieren oder Script-Trigger aktivieren wählen.
Script bearbeiten	Öffnet das aktuelle Script im Dialogfeld „Script bearbeiten”. Setzt das Fenster „Scriptarbeitsbereich” in den Vordergrund, wenn das aktuelle Script im Fenster „Scriptarbeitsbereich” geöffnet ist und zeigt das aktuelle Script im Scriptbearbeitungsbereich an. 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. Hinweis  Um den mit Tasten oder angepassten Menübefehlen verknüpften Scriptschritt zu bearbeiten, verwenden Sie das Dialogfeld „Tasteneinstellung” bzw. „Angepasste Menüs verwalten”.
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 (FileMaker Pro Advanced).
Script authentifizieren/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.

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

Hinweis  Wenn Sie den Script-Debugger verwenden, um durch Scripts zu gehen, die von einem Script-Trigger ausgelöst wurden, ist es nicht möglich, mit den Dokumentfenstern zu interagieren, zwischen Feldern und Datensätzen zu wechseln, Daten zu ändern, das Fenster zu schließen oder zu beenden. Diese Sperre tritt nur auf, wenn ein Script durch eine Aktion ausgelöst wurde. Wenn Sie ein Script debuggen, das nicht durch einen Script-Trigger aktiviert wurde, können Sie normal mit Dokumentfenstern, Feldern und Datensätzen interagieren.

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

•	Die Funktion „Nächsten Schritt setzen” ist nur für das aktuell ausgeführte Script verfügbar.

•

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 „Übergehen” oder „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 , 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 geklickt haben, werden Ihre Zugriffsrechte für die Datenanzeige und den Script-Debugger beibehalten, bis Sie den Script-Debugger schließen.

•	Sie können pro Script ein Dialogfeld „Script bearbeiten” oder ein Register im Fenster „Scriptarbeitsbereich” öffnen.

•	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.

•	Wenn ein „Datei öffnen”-Script geladen wird, zeigt der Script-Debugger „BeiErstemFensterÖffnen” an.

•	Wenn ein „Datei schließen”-Script geladen wird, zeigt der Script-Debugger „BeiLetztemFensterSchließen” an.

•

Bei der Fehlersuche in einem Script, das über eine Taste aufgerufen wird, wird die Taste in der Liste Call-Stack durch den Dateinamen und das Layout identifiziert, in dem sich die Taste befindet. Der Tastenname ist der Name des Tastenobjekts, der mithilfe des Inspektors zugewiesen wurde. Wenn im Inspektor kein Name zugewiesen wurde, erscheint <unbenannte Taste> gefolgt vom Dateinamen und dem Layout in der Liste.

Falls der Script-Debugger bei einem Scriptschritt anhält, den eine Taste in der Liste der Scriptschritte aufruft, ändert sich der Text oberhalb der Liste zu Taste: <Name der Taste> oder zu Taste: <unbenannte Taste>, falls im Inspektor kein Name zugewiesen wurde.

•

Bei der Fehlersuche in einem Script, das über ein angepasstes Menü aufgerufen wird, wird der Menübefehl in der Liste Call-Stack durch den Namen des Menübefehls und den Dateinamen identifiziert. Falls der Script-Debugger bei einem Scriptschritt anhält, den ein angepasstes Menü in der Liste der Scriptschritte aufruft, ändert sich der Text oberhalb der Liste zu Menübefehl: <Text des angepassten Menübefehls>.

Weiterführende Themen 

Erstellen und Bearbeiten von Scripts

Verwenden der Datenanzeige (FileMaker Pro Advanced)