FM Code Library - Handbuch

FM Code Library - Sinn & Zweck

Die FM Code Library unterstützt Sie als FileMaker Programmierer unter MacOS X indem Sie sogenannte Snippets jederzeit erzeugen und abrufen können. Snippets sind FileMaker Elemente wie

Diese Snippets können per Hotkey (= bestimmte Tastenkombination) in FileMaker eingefügt werden. Angenommen Sie entwickeln gerade ein Script und wollen nun 5 Script-Schritte einfügen. Diese können Sie mühsam aus der Liste der FileMaker Script-Schritte im ScriptMaker heraussuchen und einfügen oder Sie machen das Selbe, jedoch nur viel schneller per FM Code Library.

Oder Sie designen gerade ein hübsches FileMaker Layout, wo Sie 5 Grafiken immer wieder verwenden (zB. Icons für Hinzufügen, Löschen, Suchen, Listenansicht und Drucken). Diese Grafiken können Sie nun in jedem Layout per "Einfügen/Bild..." einfügen oder per Knopfdruck mit der FM Code Library.

Die FM Code Library ermöglicht Ihnen das schnelle Programmieren!

Außerdem können Sie nicht nur einzelne Grafiken oder einzelne Script-Schritte einfügen sondern komplexe Abläufe, die aus 10 Script-Schritten und mehr bestehen (denken Sie beispielsweise an ein komplexes Such-Script mit 10 Script-Zeilen, das in ähnlicher Form vermutlich an zig Stellen in Ihrer FileMaker Lösung vorkommt)

Systemvoraussetzungen

Installation

  1. Downloaden Sie die aktuellste Version der FM Code Library von www.schubec.com als DMG Datei herunter.
  2. Öffnen Sie die DMG Datei.
  3. Kopieren Sie die Anwendung FM Code Library in Ihr MacOS X Anwendungsverzeichnis per Drag & Drop
  4. Öffnen Sie nun die Anwendung FM Code Library aus Ihrem Anwendungsverzeichnis
    Falls Sie MacOS X 10.8 verwenden und eine Meldung erhalten "FM Code Library kann nicht geöffnet werden, da es von einem nicht verifiziertem Entwickler stammt", so gibt es mehrere Möglichkeiten die Anwendung dennoch zu starten:
    • Klicken Sie mit der rechten Maustaste auf die Anwendung, sodass sich das Kontext-Menü öffnet. Klicken Sie dort auf "Öffnen"
    • Halten Sie die [CTRL]-Taste gedrückt und doppelklicken Sie auf die Anwendung um diese zu öffnen
    • Deaktivieren Sie die Überprüfung - wie das geht ist hier beschrieben: http://support.apple.com/kb/HT5290?viewlocale=de_DE
  5. Nachdem die FM Code Library gestartet wurde, erscheint in der Menüleiste das FM Code Library Symbol sowie der Willkommen-Bildschirm. Unten links können Sie entscheiden, ob die FM Code Library bei jedem Start von MacOS X gestartet werden soll sowie, ob der Willkommen-Bildschirm bei jedem Start erscheinen soll. Wir empfehlen die FM Code Library immer zu starten, sodass sie per Hotkey zur Verfügung steht. Den Willkommen-Bildschirm sollten Sie am Anfang aktiviert lassen, da er die wichtigsten Funktionen zusammenfasst und deaktivieren, sobald Sie sich mit allen Funktionen vertraut gemacht haben.

Nutzung der FM Code Library

Einfügen von Snippets

Die FM Code Library wartet oben rechts neben der Uhrzeit auf ihren Einsatz und kann per Maus oder Hotkey aktiviert werden.
Starten Sie nun FileMaker Pro Advanced und erstellen Sie eine Test-Datenbank, mit der Sie den Einsatz der FM Code Library in Ruhe testen können.
In Ihrer Testdatenbank starten Sie nun unter "Scripts/Scripts verwalten...." den FileMaker Scriptmaker. Legen Sie hier ein neues Script an. Angenommen Sie wollen nun die Script-Schritte "Wenn" "Sonst, Wenn", "Sonst" und "Ende (wenn)" in Ihr Script einfügen, so können Sie die entsprechenden Befehle entweder mit der Maus aus der Liste aller Scriptbefehle mühsam heraussuchen oder Sie fügen diese blitzschnell per FM Code Library in das aktuelle Script ein.
Gehen Sie dazu wie folgt vor:

  1. Aktivieren Sie die FM Code Library indem Sie den Hotkey zum Einfügen von Snippets aktivieren. In der Standard-Einstellung drücken Sie dazu die Tasten ALT+SHIFT+TAB gleichzeitig auf Ihrer Tastatur.
    Sofort erscheint das schwebende Fenster der FM Code Library.
  2. Tippen Sie nun "Wenn" ein.
  3. Wie Sie nun erkennen, entspricht der siebte Listen-Eintrag den gewünschten Befehlen.
  4. Klicken Sie nun den vierten Eintrag mit der Maus an oder wählen Sie den Eintrag aus, indem Sie den Hotkey ⌘+7 auslösen (Befehlstaste und Taste "7" gleichzeitig drücken).
  5. Die entsprechenden Befehle wurden nun in Ihr Script eingefügt.
Sie können das Einfügen von Script-Schritten natürlich beliebig oft wiederholen und so sehr rasch das gewünschte Script programmieren.
Wenn Sie die Option "Diesen Dialog nach dem Einfügen wieder anzeigen" wählen, so erscheint der Dialog direkt nach dem Einfügen der letzten Scripts wieder und Sie können ein neues Snippet suchen und einfügen. Mit der Taste ESC verschwindet die FM Code Library wieder.

Gratulation, Sie können nun vorhandene Snippets einfügen.
Neben Script-Schritten können Sie auch ganze Scripts, Felddefintionen, Layoutobjekte und alle anderen Snippets nach selber Methodik in FileMaker einfügen.
Damit Sie erkennen, um welche Art von Snippet es sich handelt, sind die Snippets mit folgenden Symbolen markiert:

Script-Schritt
(Script-Step)
Script
Feld
(Field)
Layoutobjekt
(Layout-Object)
Text
Tabelle
(Table)
Script-Gruppe
(Script-Group)
Eigene Funktion
(Script-Custom Function)

Problembehebung

Anlegen neuer Scripts

Die FM Code Library wird mit den am häufig genutzten Snippets ausgeliefert, enthält momentan aber noch nicht alle in FileMaker verfügbaren Funktionen.
Aus diesem Grund können Sie selbst neue Snippets anlegen und in die FM Code Library aufnehmen.

Gehen Sie wie folgt vor:

  1. Markieren Sie in FileMaker die Objekte (Script-Schritte, Felder, Tabellen, Script-Gruppen, etc.), die Sie als Snippet aufnehmen möchten und kopieren Sie diese in die Zwischenablage indem Sie ⌘+C auf der Tastatur drücken. Dies erfordert FileMaker Pro Advanced - ein normaler FileMaker Client reicht leider nicht aus.
  2. Aktivieren Sie die FM Code Library mit dem Hotkey zum Einfügen von Snippets, indem Sie SHIFT+BEFEHLSTASTE+RETURN gleichzeitig drücken.
  3. Vergeben Sie nun einen eindeutigen Namen für Ihr Snippet und klicken Sie auf "Hinzufügen".
  4. Gratulation - Sie haben erfolgreich ein Snippet angelegt und können dieses sofort nutzen, so wie alle anderen Snippets auch.

Der Editor

Editor aufrufen

Rufen Sie den Editor auf, indem Sie auf das FM Code Library Icon klicken und im Menü anschließend "Editor anzeigen" wählen.

Snippets löschen

Um ein einzelnes Snippet oder eine Gruppe von Snippets zu löschen, markieren Sie diese mit der Maus und klicken Sie anschließend auf das Minus-Symbol links unter der Liste.

Snippet hinzufügen

Das Hinzufügen von Snippets per Hotkey wurde oben bereits erklärt. Alternativ zum oben beschriebenen Weg können Sie auch im Editor neue Snippets hinzufügen. Klicken Sie dazu auf das Plus-Symbol. Die FM Code Library analysiert den Inhalt der Zwischenablage automatisch und wird ein entsprechendes Snippet für Sie anlegen. Bitte achten Sie auf einen eindeutigen Namen.

Snippet exportieren

Sie können alle oder einen Teil der Snippets exportieren um diese auf einen anderen Computer zu übertragen oder um diese in einem Internet-Forum zu teilen, wenn Sie andere Entwickler-Kollegen an Ihren Scripts teilhaben lassen wollen. Markieren Sie dazu die zu exportierenden Scripts und klicken Sie dann auf den Button "Exportieren". Im nun erscheinenden Dialog können Sie einen Dateinamen und Speicherort festlegen sowie auswählen, ob ALLE oder nur die markierten Snippets exportiert werden sollen.
Die nun erzeugte Datei können Sie per Email versenden oder auf USB-Stick kopieren. Es handelt sich hier übrigens um eine XML Datei. Bitte editieren Sie die so erzeugte Datei nicht mit anderen Programmen, denn wenn Sie hier Fehler machen, kann die Datei nicht mehr eingelesen werden.

Snippet importieren

Snippets können mit dem Button "Importieren" in Ihre FM Code Library importiert werden. Wählen Sie dazu die zu importierende Snippet-Datei aus und markieren Sie die Option zum Ersetzen der bestehenden Snippets, wenn gewünscht. Wenn die entsprechende Option nicht gewählt ist (Standard) werden die zu importierenden Snippets bei Namenskollision einfach umbenannt.

Profi-Features

Einstellungen

Unter "Einstellungen..." können Sie selbst die beiden Hotkeys für das Einfügen von Snippets und das Hinzufügen von Snippets ändern.

Inhalt von Snippets editieren

Im Editor können Sie bestehende Snippets editieren. Snippets werden entsprechend dem internen FileMaker Format als XML Struktur gespeichert und dargestellt. Achten Sie darauf, dass Sie keinesfalls die XML-Struktur zerstören oder ungültige Befehle oder Zeichen einfügen.
Unser Tipp: Editieren Sie bestehende Snippets nicht. Löschen Sie diese lieber und legen Sie sie neu an, denn nur dann ist gewährleistet, dass die Befehle von FileMaker lesbar sind.