Debuggen von Scripts (FileMaker Pro Advanced)
Der Script-Debugger ist ein interaktives Werkzeug für die Fehlerbehebung in Ihren FileMaker-Scripts.
|
•
|
|
•
|
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.
|
|
•
|
mit dem Debugging in einem beliebigen Scriptschritt innerhalb des Scripts beginnen.
|
|
1.
|
 |
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.
|
 |
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.
|
 |
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
 |
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 "Nächsten Schritt setzen".
|
  |
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 Stack aufrufen doppelklicken, um es zu bearbeiten. Jedes aktive Script öffnet sich in einem eigenen Fenster "Script bearbeiten", so dass Sie mehrere Scripts bearbeiten können. Die Scriptausführung wird erst angehalten, wenn Sie die Änderungen speichern.
Sie können mit der Schaltfläche "Schritt" schrittweise durch ein Script gehen, wenn ein Script pausiert.
|
 |
|
|
Script-Trigger aktivieren/deaktivieren
  |
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.
|
|
Haltepunkt setzen/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 im Script-Debugger oder beim Erstellen von Scripts setzen und löschen. Klicken Sie beim Erstellen eines Scripts im linken Bereich des Schritts, um einen Haltepunkt zu setzen. Haltepunkte werden zusammen mit dem Script gespeichert, in dem sie gesetzt wurden. Sie können Haltepunkte für mehrere Schritte setzen.
Hinweis Sie können keine Haltepunkte für Scriptschritte setzen, die durch eine Taste oder ein angepasstes Menü aufgerufen werden.
|
 |
Öffnen Sie das Dialogfeld "Script bearbeiten", um das aktuelle Script zu 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.
Hinweis Um den mit Tasten oder angepassten Menübefehlen verknüpften Scriptschritt auszuführen, 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. 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, aber nicht 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.
|
Klicken Sie für Letzter Fehler auf die Fehlerzahl, um ein Hilfethema mit Details zum Fehler zu öffnen. Informationen finden Sie unter FileMaker Pro-Fehlercodes.
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.
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.
|
Um den Script-Debugger aus dem Dialogfeld "Scripts verwalten" zu aktivieren, wählen Sie ein Script, halten die Umschalttaste gedrückt und klicken auf Ausführen. Um den Script-Debugger zu schließen, drücken Sie die Strg-Taste (Windows) oder die Befehlstaste (Mac OS) und klicken auf Ausführen. Weitere Informationen zu Tastaturbefehlen finden Sie unter FileMaker Pro Advanced-Tastaturbefehle (Windows) und FileMaker Pro Advanced-Tastaturbefehle (Mac OS).
|
3.
|
Klicken Sie auf Schritt beginnen.
|
Die Liste Stack aufrufen zeigt das Teilscript an.
|
4.
|
Wählen Sie ein Script aus der Liste Stack aufrufen aus, um die Schritte dieses Scripts im Anzeigebereich darzustellen.
|
|
•
|
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. Um ein Script zu bearbeiten, wählen Sie "Script authentifizieren/deauthentifizieren". 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 "Script authentifizieren/deauthentifizieren" gewählt haben, werden Ihre Zugriffsrechte sowohl für die Datenanzeige als auch 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.
|
|
•
|
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 Stack aufrufen 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 des Scriptschritts> 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 Stack aufrufen 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>.
|