{"id":3283,"date":"2013-11-22T09:04:24","date_gmt":"2013-11-22T09:04:24","guid":{"rendered":"https:\/\/gofilemaker.de\/?p=3283"},"modified":"2023-08-23T07:16:53","modified_gmt":"2023-08-23T06:16:53","slug":"coezuem-i%cc%87pucu-fi%cc%87lemaker-i%cc%87le-otomati%cc%87k-guencellemeler","status":"publish","type":"post","link":"https:\/\/gofilemaker.de\/tr\/2013\/11\/coezuem-i%cc%87pucu-fi%cc%87lemaker-i%cc%87le-otomati%cc%87k-guencellemeler\/","title":{"rendered":"\u00c7\u00f6z\u00fcm ipucu: FileMaker ile otomatik g\u00fcncellemeler"},"content":{"rendered":"
Die beschriebene Lösung nutzt Funktionen des kostenlos erhältlichen Base Elements Plugins, das unter FileMaker 11 und 12 lauffähig ist. Das Base Elements Plugin kann auf der Website des Herstellers Goya Pty Ltd. kostenlos heruntergeladen<\/strong><\/a> werden und steht für Mac OS X und Windows als 32-bit oder 64-bit-Version zum Download zur Verfügung.<\/p>\n Für die Dateiauswahlbox ist das ebenfalls kostenlos verfügbare Dialog-Plugin erforderlich. Das Dialog-Plugin unterstützt eine Vielzahl an Dialogen und Eingabemöglichkeiten, ist für Mac OS X und Windows verfügbar und kann hier heruntergeladen<\/strong> werden.<\/p>\n Um mit Pfaden einfacher umgehen zu können, beinhaltet die Beispiellösung insgesamt sieben eigene Funktionen (Custom Functions). Diese können mit FileMaker Pro Advanced eingesehen werden und stehen als verwendbare Funktionen auch unter FileMaker Pro zur Verfügung. Die beiden Custom Functions, die in der Praxis von uns genutzt werden, heißen:<\/p>\n PathPluginToFM ( Pfad )<\/strong> – wandelt einen nativen Systempfad in einen FileMaker-Pfad um. Die Funktion steht auf Windows- und Mac-Clients zur Verfügung.<\/p>\n PathFMToPlugin ( Pfad )<\/strong> – wandelt einen FileMaker-Pfad in einen nativen Systempfad um. Die Funktion steht auf Windows- und Mac-Clients zur Verfügung und kann z.B. für das ebenfalls kostenlos erhältliche Dialog Plugin verwendet werden, um bei einer Dateiauswahlbox Pfade vorzugeben.<\/p>\n Die anderen fünf Custom Functions sind Teilfunktionen und werden von den beiden genannten Custom Functions intern verwendet.<\/p>\n Unsere Beispieldatei enthält insgesamt drei Tabellen: Updatefunktion, Tabelle<\/a> 1 und Tabelle 2. So simuliert die Beispieldatei eine FileMaker-Lösung, in der mehrere Tabellen per Export und Import upgedatet werden können. Damit FileMaker weiß, wohin die Datenbanken gespeichert werden sollen, muß zunächst ein Speicherpfad gesetzt werden. Dies erfolgt mit der Schaltfläche […] vor dem Feld für den Pfad, die das Script<\/a> „sf.Pfadauswahl“ aufruft. Dieses Script ruft lediglich eine Dateiauswahlbox mit Hilfe des Dialog Plugins auf:<\/p>\n Der ausgewählte Pfad wird in die Variable<\/a> $pfad<\/em> geschrieben. Als Standard-Pfad (bei dem der Auswahldialog beginnen soll) wurde in diesem Beispiel das Dokumentverzeichnis des aktuellen Benutzers angegeben. Da das Dialog-Plugin native Pfade und keine FileMaker-Pfade annimmt, wird der Pfad Hole(DokumentenPfad)<\/em> mit der Funktion PathFMToPlugin () in einen nativen Pfad gewandelt. Wenn der Benutzer einen Pfad angegeben und auf [Auswählen]<\/em> geklickt hat, wird der Pfad mit der Funktion<\/p>\n in das Feld <<Updatefunktion::Dateipfad>><\/em> geschrieben. Damit verfügt die Lösung nun über einen gültigen Dateipfad, in das die Datenbanken für das Update geschrieben werden können.<\/p>\n Da die Lösung nun über einen gültigen Pfad für den Export verfügt, können nun alle Tabellen in externe Datenbanken exportiert werden. Der Export einer Datentabelle erfolgt über vier Scriptzeilen:<\/p>\n Mit diesem Befehl wird der in der Tabelle Updatefunktion gespeicherte Dateipfad FileMaker-kompatibel in die Variable $pfad geschrieben.<\/p>\n Wechseln in das Layout, aus dem die Datensätze exportiert werden sollen<\/p>\n Da im Export alle Datensätze exportiert werden sollen, ruft dieser Befehl in der Zieltabelle alle Datensätze auf. Für spezielle Exporte kann an dieser Stelle auch eine andere Selektion von Datensätzen durchgeführt werden.<\/p>\n Mit diesem Befehl werden die Datensätze aus der Tabelle des aufgerufenen Layouts in die in $pfad angegebene externe Datei exportiert. Als Dateiformat wurde in unserem Beispiel FileMaker (.fmp12) angegeben. Wichtig ist an dieser Stelle, auch die zu verwendende Feldfolge anzugeben, in der die Daten exportiert werden sollen:<\/p>\n Diese vier Befehle werden nun einfach für jede in der Datenbank befindliche Tabelle wiederholt. Dabei wird jeweils der Dateiname für die Variable $pfad<\/em>, das aufzurufende Layout sowie die Feldfolge für den Export an jede Tabelle angepaßt.<\/p>\n Am Ende enthält das Script für den vollständigen Datenexport die oben erläuterten vier Befehlszeilen für jede Tabelle, die im Rahmen der Updatefunktion exportiert werden soll.<\/p>\n In Ihrer Lösung sollten Sie nun das Script für den Datenexport einmal durchführen – nicht nur zu Testzwecken, sondern Sie benötigen die exportierten Dateien auch, um das Script für die Importe erstellen zu können. Wenn Ihr Exportscript fehlerfrei ist, sollten sich nun alle Dateien im gewählten Verzeichnis befinden.<\/p>\n Im letzten Schritt gilt es, die Daten aus den exportierten Datenbanken automatisiert wieder in die Lösung zu importieren. Dafür enthält die Beispiellösung das Script „ts.Update_Import“, das folgendermaßen aufgebaut ist:<\/p>\n Mit diesem Befehl wird der im Feld <<Updatefunktion::Dateipfad>><\/em> gespeicherte Pfad in die Variable $updatepfad<\/em> geschrieben. Diese Zuweisung muß nur einmal in diesem Script erfolgen. Alle weiteren Befehle werden so oft wiederholt, wie Tabellen importiert werden sollen.<\/p>\n Der Variablen $pfad<\/em> wird mit diesem Befehl der zuvor in $updatepfad<\/em> gespeicherte Pfad sowie der Dateiname der exportierten Datenbank zugewiesen und das Ganze mit der Funktion „PathPluginToFM“ in einen gültigen FileMaker-Pfad konvertiert.<\/p>\n Wechseln in das Layout, in das die Datensätze importiert werden sollen<\/p>\n Falls sich in der Tabelle noch alte Datensätze befinden sollen, werden sie mit diesen beiden Befehlen vor dem Import aus der Datentabelle gelöscht.<\/p>\n Mit diesem Befehl werden die Datensätze in die Tabelle des aufgerufenen Layouts (hier: „Updatefunktion“) importiert.<\/p>\n Beim Entwickeln dieses Scriptes kann der Importbefehl jedoch nicht einfach so hingeschrieben werden, denn wenn als Dateiname eine Variable angegeben wurde, läßt sich die Feldreihenfolge für den Import nicht festlegen. Aus diesem Grund müssen Sie zunächst als Dateinamen zusätzlich die im vorherigen Schritt exportierte Datenbankdatei angeben. Doppelklicken Sie hierfür den Befehl [Datensätze importieren…]<\/em> und klicken Sie auf die Schaltfläche [Datei hinzufügen…]<\/em>. Wählen Sie nun die im vorherigen Schritt exportierte passende Datenbankdatei aus:<\/p>\n Nachdem Sie den Dialog mit [OK]<\/em> bestätigt haben, können Sie nun unter [Importfolge angeben]<\/em> die Feldreihenfolge angeben, in der die Datenbanken importiert werden sollen.<\/p>\n Unter [Quelle]<\/em> sehen Sie die Datentabelle der zuvor exportierten Datenbank. Wählen Sie im Popupmenü [Ziel]<\/em> die passende Zieltabelle aus, in die die Daten aus der externen Datentabelle importiert werden sollen und passen ggf. die Feldreihenfolge an. Legen Sie nach Klick auf [OK]<\/em> fest, ob automatische Eingabeoptionen durchgeführt werden sollen und klicken Sie auf [Importieren]<\/em>, um die Importoptionen zu speichern.<\/p>\n Klicken Sie nun wieder auf [Datei…]<\/em> unter Datenquelle angeben<\/em> oder doppelklicken Sie den Scriptbefehl Datensätze importieren<\/em>. Entfernen Sie nun wieder die Zeile file:Dateiname.fmp12<\/em>, so daß im Eingabefeld unter Pfadliste nur noch $pfad<\/em> steht.<\/p>\n Um weitere Tabellen automatisch zu importieren, wiederholen Sie den Vorgang für jede Datentabelle. Am Ende sieht das Importscript so aus wie in unserer Beispiellösung:<\/p>\n Damit ist die Funktion für eine automatisierte Datenübernahme bei Updates fertiggestellt. In der Beispiellösung wurden die beiden Scripte auf zwei Schaltflächen [Update: Export]<\/em> und [Update: Import]<\/em> gelegt. Mit der Schaltfläche [FileMaker-Pfad]<\/em> wird demonstriert, wie die Custom Function<\/a> PathPluginToFM (Pfad)<\/em> einen Systempfad in einen FileMaker-Pfad umwandelt.<\/p>\n
Rapid Engineering ist der große Vorteil von FileMaker-Datenbanken, was in der Praxis dazu führt, daß FileMaker-Datenbanken meist „leben“ und stetig erweitert werden. Aus verschiedenen Gründen ist es dabei nicht empfehlenswert, in Echtzeit an der laufenden Datenbank<\/a> Änderungen vorzunehmen. Sicherer ist eine Testumgebung mit einer separaten Entwicklerversion, mit der die Produktivversion von Zeit zu Zeit aktualisiert wird. Bei diesem Vorgang müssen alle Datentabellen aus der laufenden Version exportiert und nach Ersetzen der FileMaker-Datenbanken wieder importiert werden, sofern Daten und Struktur nicht penibel getrennt wurden. Um nicht bei jedem Update manuell alle Daten exportieren und wieder importieren zu müssen, läßt sich z.B. mit Hilfe des Base Elements Plugins eine Routine entwickeln, die diesen Vorgang automatisiert ausführt. In diesem Artikel zeigen wir, wie es geht und wie der Umgang mit FileMaker- und Systempfaden zum Kinderspiel wird. Am Ende des Artikels kann die Beispieldatei heruntergeladen werden. Das Archiv enthält eine Beispieldatei im FileMaker-12-Format.
\n<\/p>\nZwei kostenlose Plugins benötigt<\/h2>\n
Hilfreiche Custom Functions<\/h2>\n
Setzen eines Speicherpfades<\/h2>\n
Variable setzen [$pfad; Wert:Dialog_SelectFolderDialog (\"\"; \"Systempfad w\u00e4hlen...\";<\/pre>\n
PathFMToPlugin (Hole (DokumentenPfad)))]<\/pre>\n
Feldwert setzen [Updatefunktion::Dateipfad; $pfad]<\/pre>\n
Export aller Tabellen in externe Datenbanken<\/h2>\n
Variable setzen [$pfad; Wert:PathPluginToFM (Updatefunktion::Dateipfad) & \"\/Updatefunktion.fmp12]<\/pre>\n
Gehe zu Layout [\"Updatefunktion\" (Updatefunktion)]<\/pre>\n
Alle Datens\u00e4tze anzeigen<\/pre>\n
Datens\u00e4tze exportieren [Ohne Dialogfeld; \"$pfad\"; Unicode (UTF-16)]<\/pre>\n
<\/p>\n
<\/p>\nDurchführen des Datenexportes für das Importscript<\/h3>\n
Automatisierter Import aller exportierten Datenbanken<\/h2>\n
Variable setzen [$updatepfad; Wert:Updatefunktion::Dateipfad]<\/pre>\n
Variable setzen [$pfad; Wert:PathPluginToFM ($updatepfad) & \"\/Updatefunktion.fmp12\"]<\/pre>\n
Gehe zu Layout [\"Updatefunktion\" (Updatefunktion)]<\/pre>\n
Alle Datens\u00e4tze anzeigen\r\nAlle Datens\u00e4tze l\u00f6schen [Ohne Dialogfeld]<\/pre>\n
Datens\u00e4tze importieren [Ohne Dialogfeld; \"$pfad\"; Hinzuf\u00fcgen; Mac Roman]<\/pre>\n
Der Trick mit der Feldfolge<\/h3>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\nDownload Beispieldatei für FileMaker 12<\/h2>\n