FileMaker Server 9. Custom Web Publishing mit PHP

Transkript

1 FileMaker Server 9 Custom Web Publishing mit PHP

2 2007 FileMaker, Inc. Alle Rechte vorbehalten. FileMaker, Inc Patrick Henry Drive Santa Clara, California 95054, USA FileMaker ist eine Marke von FileMaker, Inc., eingetragen in den USA und anderen Ländern. ScriptMaker und das Dateiordner- Logo sind Marken von FileMaker, Inc. Alle anderen Marken sind Eigentum der jeweiligen Besitzer. Die FileMaker-Dokumentation ist urheberrechtlich geschützt. Sie dürfen diese Dokumentation ohne schriftliche Genehmigung von FileMaker weder vervielfältigen noch verteilen. Diese Dokumentation darf ausschließlich mit einer gültigen, lizenzierten Kopie der FileMaker-Software verwendet werden. Alle in den Beispielen erwähnten Personen und Firmen sind rein fiktiv und jegliche Ähnlichkeit mit bestehenden Personen und Firmen ist rein zufällig. Die Danksagungen und Urheberrechtshinweise finden Sie im entsprechenden Dokument, das mit der Software geliefert wurde. Die Erwähnung von Produkten Dritter dient nur zur Information und stellt keine Empfehlung dar. FileMaker, Inc. übernimmt keine Verantwortung für die Leistung dieser Produkte. Weitere Informationen finden Sie auf unserer Website unter Edition: 01

3 Inhalt 3 Inhalt Über dieses Handbuch 7 Kapitel 1 Einführung in Custom Web Publishing 9 Über die Web Publishing Engine 10 Verarbeitung einer Web Publishing Engine-Anforderung 10 Custom Web Publishing mit PHP 11 Custom Web Publishing mit XML und XSLT 11 Vergleich von PHP mit XML und XSLT 12 Gründe für PHP 12 Gründe für XML und XSLT 12 Kapitel 2 Erläuterung von Custom Web Publishing mit PHP 13 Wichtige Funktionen in Custom Web Publishing mit PHP 13 Anforderungen für Web-Publishing 13 Voraussetzungen für das Veröffentlichen einer Datenbank mit Custom Web Publishing 13 Voraussetzungen für Web-Benutzer zum Zugriff auf eine Custom Web Publishing-Lösung 14 Verbindung zum Internet oder zu einem Intranet 14 Manuelle Installation von FileMaker API for PHP 14 Die nächsten Schritte 15 Kapitel 3 Vorbereiten von Datenbanken für Custom Web Publishing 17 Aktivierung von Custom Web Publishing mit PHP für Datenbanken 17 Erstellung von Layouts für Custom Web Publishing mit PHP 17 Schützen veröffentlichter Datenbanken 18 Zugriff auf eine geschützte Datenbank 18 Veröffentlichen des Inhalts von Medienfeldern im Web 19 Anzeige von Medienfelddaten durch Web-Benutzer 20 FileMaker-Scripts und Custom Web Publishing 20 Tipps und Überlegungen zu Scripts 20 Scriptverhalten in Custom Web Publishing-Lösungen 22

4 4 FileMaker Server Custom Web Publishing mit PHP Kapitel 4 Übersicht über Custom Web Publishing mit PHP 23 Funktionsweise der Web Publishing Engine mit PHP-Lösungen 23 Allgemeine Schritte bei Custom Web Publishing mit PHP 23 Generieren von PHP-Websites mithilfe des FileMaker PHP-Site-Assistenten 24 Vor Verwendung des PHP-Site-Assistenten 25 Starten des PHP-Site-Assistenten 25 Verwendung von Sites, die mit dem PHP-Site-Assistenten generiert wurden 26 Kapitel 5 Verwendung von FileMaker API for PHP 27 Weitere Informationen 27 Referenz zu FileMaker API for PHP 27 FileMaker API for PHP-Lehrgang 27 Beispiele zu FileMaker API for PHP 28 Verwendung der Klasse FileMaker 28 Objekte der Klasse FileMaker 28 FileMaker-Befehlsobjekte 28 Herstellen einer Verbindung zu einer FileMaker-Datenbank 29 Arbeiten mit Datensätzen 29 Erstellung eines Datensatzes 29 Duplizieren von Datensätzen 30 Bearbeiten von Datensätzen 30 Löschen von Datensätzen 30 Ausführen von FileMaker-Scripts 31 Abruf der Liste verfügbarer Scripts 31 Ausführung eines ScriptMaker-Scripts 31 Ausführung eines Scripts vor der Ausführung eines Befehls 31 Ausführung eines Scripts vor der Sortierung einer Ergebnismenge 31 Ausführung eines Scripts nach der Erstellung einer Ergebnismenge 31 Ausführungsreihenfolge von Scripts 32 Arbeiten mit FileMaker-Layouts 32 Verwenden von Ausschnitten 33 Auflistung der in einem bestimmten Layout definierten Ausschnitte 33 Abrufen von Ausschnittnamen für ein bestimmtes Ergebnisobjekt 33 Abruf von Informationen über Ausschnitte für ein bestimmtes Layout 33 Abrufen von Informationen für einen bestimmten Ausschnitt 33 Abrufen des Tabellennamens für einen Ausschnitt 33 Abrufen der Ausschnittdatensätze für einen bestimmten Datensatz 33 Erstellen eines neuen Datensatzes in einem Ausschnitt 34 Löschen eines Datensatzes aus einem Ausschnitt 34

5 Inhalt 5 Verwenden von Wertelisten 34 Abrufen der Namen aller Wertelisten für ein bestimmtes Layout 34 Abrufen eines Arrays aller Wertelisten für ein bestimmtes Layout 34 Abrufen von Auswahlmöglichkeiten für eine benannte Werteliste 35 Ausführen von Suchabfragen 35 Der Befehl Find All 36 Der Befehl Find Any 36 Der Befehl Find 36 Der Befehl Compound Find 36 Verarbeitung der Datensätze in einer Ergebnismenge 38 Filtern von Ausschnittszeilen, die von Suchabfragen zurückgegeben wurden 38 Vorabüberprüfung von Befehlen, Datensätzen und Feldern 39 Vorabüberprüfung von Datensätzen in einem Befehl 40 Vorabüberprüfung von Datensätzen 40 Vorabüberprüfung von Feldern 40 Bearbeitung der Überprüfungsfehler 40 Fehlerbehandlung 42 Kapitel 6 Einstellen, Testen und Überwachen einer Site 43 Einstellen einer Custom Web Publishing-Site 43 Testen einer Custom Web Publishing-Site 43 Überwachen Ihrer Website 44 Verwenden der Web-Server-Zugriffs- und Fehlerprotokolle 44 Verwenden des Web Publishing Engine-Programmprotokolls 44 Verwenden des Web-Server-Modul-Fehlerprotokolls 45 Verwenden des internen Web Publishing Core-Zugriffsprotokolls 45 Fehlerbehebung für Ihre Site 45 Anhang A Fehlercodes für Custom Web Publishing mit PHP 47 Fehlercodenummern für FileMaker-Datenbanken 47 Fehlercodenummern für PHP-Komponenten 53 Index 55

6 6 FileMaker Server Custom Web Publishing mit PHP

7 Über dieses Handbuch Vorwort Dieses Handbuch setzt voraus, dass Sie mit PHP, der Entwicklung von Websites und dem Einsatz von FileMaker Pro zur Erstellung von Datenbanken vertraut sind. Sie sollten mit den Grundlagen der Datenbankgestaltung von FileMaker Pro vertraut sein und die Konzepte von Feldern, Beziehungen, Layouts, Ausschnitten und Medienfeldern verstehen. Weitere Informationen zu FileMaker Pro finden Sie in der FileMaker Pro Hilfe. Dieses Handbuch enthält die folgenden Informationen über Custom Web Publishing mit PHP auf FileMaker Server: 1 Voraussetzungen für die Entwicklung einer Custom Web Publishing-Lösung mit PHP 1 Veröffentlichen Ihrer Datenbanken mit PHP 1 Voraussetzungen für Web-Benutzer für den Zugriff auf eine Custom Web Publishing-Lösung 1 Abruf von Daten aus von FileMaker Server bereitgestellten Datenbanken mithilfe des FileMaker API for PHP Wichtig Sie können PDF-Dateien der FileMaker-Dokumentation von herunterladen. Aktualisierungen dieses Dokuments erhalten Sie ebenfalls auf der Website. Die Dokumentation für FileMaker Server umfasst die folgenden Informationen: Weitere Informationen über Installieren und Konfigurieren von FileMaker Server Instant Web Publishing Custom Web Publishing mit PHP Verwenden des PHP-Site-Assistenten Custom Web Publishing mit XML und XSLT Verwenden des XSLT-Site-Assistenten Installation und Konfiguration der ODBCund JDBC-Treiber und Verwendung von ODBC und JDBC Wie FileMaker Server Auto Update das aktuellste Plugin für FileMaker Pro-Datenbank- Clientcomputer herunterladen kann Siehe FileMaker Server Einführung FileMaker Server Hilfe FileMaker Instant Web Publishing Handbuch FileMaker Server Custom Web Publishing mit PHP (dieses Handbuch) PHP-Site-Assistent Hilfe FileMaker Server Custom Web Publishing mit XML und XSLT XSLT-Site-Assistent Hilfe FileMaker ODBC- und JDBC-Handbuch FileMaker-Handbuch zur Aktualisierung von Plugins

8 8 FileMaker Server Custom Web Publishing mit PHP

9 Kapitel 1 Einführung in Custom Web Publishing Mit FileMaker Server können Sie Ihre FileMaker-Datenbank im Internet oder in einem Intranet wie folgt veröffentlichen: Instant Web Publishing: Mit Instant Web Publishing können Sie Ihre Datenbank schnell und einfach im Web veröffentlichen. Sie müssen Ihre Datenbankdateien dazu nicht verändern oder zusätzliche Software installieren jeder Benutzer mit einem kompatiblen Webbrowser und Zugriff auf das Internet bzw. ein Intranet kann eine Verbindung zu Ihrer Datenbank herstellen, um Datensätze anzuzeigen, zu bearbeiten, zu sortieren oder zu durchsuchen, wenn Sie ihm die entsprechenden Zugriffsrechte geben. Für Instant Web Publishing muss der Host-Computer FileMaker Pro oder FileMaker Server ausführen. Die Benutzeroberfläche ähnelt der FileMaker Pro-Desktop-Anwendung. Die Web-Seiten und Formulare, mit denen der Web-Benutzer arbeitet, hängen von den in der FileMaker Pro-Datenbank definierten Layouts und Ansichten ab. Weitere Informationen finden Sie im FileMaker Instant Web Publishing Handbuch. Statisches Veröffentlichen: Wenn sich Ihre Daten selten ändern oder Sie keine Live-Verbindung Ihrer Benutzer zu Ihrer Datenbank wünschen, können Sie die Daten statisch veröffentlichen. Bei der statischen Veröffentlichung exportieren Sie Daten aus einer FileMaker Pro-Datenbank, um eine Web-Seite zu erstellen, die Sie anhand von HTML weiter anpassen können. Die Web-Seite ändert sich nicht, wenn sich Informationen in Ihrer Datenbank ändern, und die Benutzer stellen keine Verbindung zu Ihrer Datenbank her. (Mit Instant Web Publishing werden die Daten in einem Webbrowser-Fenster jedes Mal aktiviert, wenn der Browser eine Anfrage an FileMaker Server sendet.) Weitere Informationen finden Sie im FileMaker Instant Web Publishing Handbuch. Custom Web Publishing: Erscheinungsbild und Funktionalität Ihrer veröffentlichten Datenbank können Sie über die für FileMaker Server verfügbaren Technologien für Custom Web Publishing beeinflussen. Für FileMaker Server, der die veröffentlichten Datenbanken bereitstellt, muss weder FileMaker Pro installiert noch Custom Web Publishing verfügbar sein. Mit Custom Web Publishing können Sie: 1 Ihre Datenbank in andere Web-Sites integrieren. 1 festlegen, wie Benutzer mit den Daten arbeiten. 1 steuern, wie Daten in Webbrowsern angezeigt werden. FileMaker Server stellt zwei Custom Web Publishing-Technologien zur Verfügung: 1 Custom Web Publishing mit PHP: Verwenden Sie das FileMaker API for PHP, das eine objektorientierte PHP-Schnittstelle zu FileMaker Pro-Datenbanken bereitstellt, um Ihre FileMaker-Daten in einer PHP- Web-Anwendung zu integrieren. Sie können den PHP-Site-Assistenten verwenden, um eine komplette PHP-Website zu generieren, oder Ihre PHP-Web-Seiten selbst programmieren. 1 Custom Web Publishing mit XML und XSLT: 1 Verwenden Sie XML Data Publishing, um FileMaker-Daten mit anderen Websites und Anwendungen auszutauschen. 1 Verwenden Sie Server-verarbeitete XSLT-Stylesheets, um beliebige Untergruppen von FileMaker- Daten in andere Websites, mit anderer Middleware und mit Spezialprogrammen zu integrieren. Sie können den XSLT-Site-Assistenten verwenden, um XSLT-Stylesheets zu generieren oder die Stylesheets selbst zu erstellen.

10 10 FileMaker Server Custom Web Publishing mit PHP Über die Web Publishing Engine Um Instant Web Publishing und Custom Web Publishing zu unterstützen, verwendet FileMaker Server einen Satz von Softwarekomponenten, die sogenannte FileMaker Server Web Publishing Engine. Die Web Publishing Engine verwaltet Interaktionen zwischen dem Browser eines Web-Benutzers, Ihrem Web- Server und FileMaker Server. Custom Web Publishing mit XML und XSLT: Die Web Publishing Engine fungiert als XSLT-Prozessor und bietet Ausgaben als HTML, XML oder Text (z. B. vcards) auf dem Web-Server, der dann die Ausgabe für den Webbrowser liefert. Web-Benutzer greifen auf Ihre Custom Web Publishing-Lösung zu, indem sie auf einen HREF-Link klicken oder einen Uniform Resource Locator (URL) eingeben, der die Web-Server- Adresse und eine FileMaker-Query-Zeichenfolgenabfrage angibt. Der URL kann auf XML-Daten zugreifen oder auf ein XSLT-Stylesheet verweisen. Die Web Publishing Engine gibt die XML-Daten, die in der Query-Zeichenfolgenabfrage angegeben sind, oder das Ergebnis des referenzierten XSLT-Stylesheets zurück. Custom Web Publishing mit PHP: Wenn ein Web-Benutzer auf Ihre Custom Web Publishing-Lösung zugreift, stellt PHP auf FileMaker Server eine Verbindung mit der Web Publishing Engine her und reagiert über das FileMaker API for PHP. Verwenden der FileMaker Server Web Publishing Engine für Custom Web Publishing 1 Web-Server Web-Server-Modul FM API und PHP-Code 2 3 Web Publishing Engine XSLT-Stylesheets Produkte.fp7 Kunden.fp7 Webbrowser Datenbank- Server Verarbeitung einer Web Publishing Engine-Anforderung 1. Eine Anforderung wird von einem Webbrowser oder Programm an den Web-Server gesendet. 2. Der Web-Server leitet die Anforderung über das FileMaker Web-Server-Modul an die Web Publishing Engine weiter. 3. Die Web Publishing Engine fordert Daten von der Datenbank an, die der Datenbank-Server bereitstellt. 4. FileMaker Server sendet die angeforderten FileMaker-Daten an die Web Publishing Engine. 5. Die Web Publishing Engine konvertiert die FileMaker-Daten, um die Anforderung zu beantworten. 1 Für PHP-Anforderungen antwortet die Web Publishing Engine auf die API-Anforderung. 1 Für XML-Anforderungen sendet die Web Publishing Engine die XML-Daten direkt an den Web-Server. 1 Für XSLT-Abfragen verwendet die Web Publishing Engine ein XSLT-Stylesheet, um die XML-Daten zu formatieren oder zu transformieren, und generiert die Ausgabe an den Web-Server als HTML-Seiten, XML-Dokument oder Text. 6. Der Web-Server sendet die Ausgabe an den anfordernden Webbrowser oder das anfordernde Programm. Wichtig Sicherheitsüberlegungen sind wichtig, wenn Sie Daten im Web veröffentlichen. Sehen Sie sich die Sicherheitsrichtlinien im FileMaker Pro Benutzerhandbuch an, das als PDF-Datei unter verfügbar ist.

11 Kapitel 1 Einführung in Custom Web Publishing 11 Custom Web Publishing mit PHP Das FileMaker API for PHP bietet eine objektorientierte PHP-Schnittstelle zu FileMaker-Datenbanken. Mithilfe des FileMaker API for PHP kann sowohl auf Daten als auch auf Logik, die in einer FileMaker Pro-Datenbank gespeichert sind, zugegriffen werden. Diese können auch im Internet veröffentlicht oder in andere Anwendungen exportiert werden. Das API unterstützt zudem komplexe und zusammengesetzte Suchabfragen für das Extrahieren und Filtern von in FileMaker Pro-Datenbanken gespeicherten Daten. Ursprünglich als prozedurale Programmiersprache entwickelt, wurde PHP als objektorientierte Programmiersprache für die Web-Entwicklung ausgebaut. PHP bietet Programmiersprachenfunktionalität für den Aufbau praktisch jeder Art von Logik innerhalb einer Site-Seite. Zum Beispiel können Sie bedingte Logikkonstrukte verwenden, um die Seitengenerierung, das Datenrouting oder den Workflow zu steuern. PHP bietet zudem Funktionen für Site-Administration und Sicherheit. Zusätzlich können Sie den FileMaker PHP-Site-Assistenten verwenden, um PHP-Code zu erstellen, der alle erforderlichen Voraussetzungen und Funktionen beinhaltet, um korrekt auf die Daten in einer FileMaker Pro-Datenbank zuzugreifen. Der PHP-Site-Assistent generiert eine mehrseitige Website, die Web-Benutzer in die Lage versetzt, in einer Datenbank zu suchen, eine Liste von Datensätzen anzuzeigen, Datensätze zu durchblättern, zu sortieren, hinzuzufügen, zu bearbeiten, zu duplizieren, zu löschen und einen Statistikbericht anzuzeigen. FileMaker-Entwickler, die nur über geringe PHP-Erfahrung verfügen, können den PHP-Site-Assistenten verwenden, um eine ganze PHP-Website zu generieren. PHP-Entwickler, die nur über geringe Erfahrung mit FileMaker verfügen, können den PHP-Site-Assistenten verwenden, um die Objekte und Methoden des FileMaker API for PHP zu verstehen. Custom Web Publishing mit XML und XSLT FileMaker Custom Web Publishing mit XML ermöglicht Ihnen, Abfrageanforderungen an eine FileMaker Pro-Datenbank zu senden, die von FileMaker Server bereitgestellt wird, und die resultierenden Daten anzuzeigen und zu ändern. Mithilfe einer HTTP-Abfrage mit den geeigneten Query-Befehlen und -Parametern können Sie FileMaker-Daten als ein XML-Dokument abrufen. Sie können die XML-Daten dann in andere Programme exportieren oder ihnen ein XSLT-Stylesheet zuweisen. FileMaker Custom Web Publishing mit XSLT ermöglicht das Umwandeln, Filtern oder Formatieren von XML-Daten für die Verwendung in Webbrowsern oder anderen Programmen. Sie können: 1 ein XSLT-Stylesheet verwenden, um die Daten zwischen einer FileMaker XML-Grammatik und einer anderen XML-Grammatik für andere Programme oder andere Datenbanken umzuwandeln. 1 die Daten filtern, indem Sie steuern, welche Datenbankfelder vom Stylesheet veröffentlicht werden. 1 das Erscheinungsbild der Daten in einer Web-Seite formatieren und steuern, wie der Web-Benutzer mit den Daten interagiert. Die Web Publishing Engine verwendet Ihre Stylesheets, um Daten aus einer FileMaker-Datenbank zu beziehen, wenn ein Web-Benutzer eine HTTP-Abfrage und einen URL sendet, der auf eines Ihrer XSLT- Stylesheets verweist. Die Web Publishing Engine verwendet ein Stylesheet, um die XML-Daten umzuwandeln und zu formatieren, und generiert die resultierende HTML-Seite, mit der der Web-Benutzer arbeiten kann. Der FileMaker XSLT-Site-Assistent ist eine Anwendung, mit der Sie grundlegende XSLT-Stylesheets als Ausgangspunkt für Custom Web Publishing mit XSLT erstellen können. Der XSLT-Site-Assistent generiert Stylesheets für Seiten, die die Datenbank durchsuchen, einen Datensatz anzeigen, die Datensätze in der Datenbank auflisten, Datensätze sortieren, hinzufügen, bearbeiten, duplizieren, löschen und einen Statistikbericht anzeigen.

12 12 FileMaker Server Custom Web Publishing mit PHP Vergleich von PHP mit XML und XSLT Der folgende Abschnitt zeigt einige Richtlinien auf, um die beste Lösung für Ihre Site zu bestimmen. Gründe für PHP 1 PHP ist eine leistungsstarke, objektorientierte prozedurale Scriptingsprache und relativ leicht zu erlernen. Es gibt viele Ressourcen für Schulung, Entwicklung und Support. 1 Mithilfe des FileMaker API for PHP kann sowohl auf Daten als auch auf Logik, die in einer FileMaker Pro-Datenbank gespeichert sind, zugegriffen werden. Diese können auch im Internet veröffentlicht oder in andere Anwendungen exportiert werden. 1 Mit PHP können Sie bedingte Logik verwenden, um den Seitenaufbau oder den Fluss zu kontrollieren. 1 PHP bietet Programmiersprachenfunktionalität für den Aufbau vieler Arten von Logik innerhalb einer Site-Seite. 1 PHP ist eine der beliebtesten Web-Scriptingsprachen. 1 PHP ist eine Open-Source-Sprache, verfügbar unter 1 PHP ermöglicht den Zugriff auf eine große Vielzahl von Third-Party-Komponenten, die Sie in Ihre Lösungen integrieren können. Gründe für XML und XSLT 1 Die Syntax der FileMaker XML-Abfrageparameter ist für die Datenbankinteraktion konzipiert und vereinfacht die Lösungsentwicklung. 1 XML und XSLT sind W3C-Standards. 1 XML ist ein von Maschinen und Menschen lesbares Format, das Unicode unterstützt, so dass Daten in jeder geschriebenen Sprache kommuniziert werden können. 1 XML ist bestens geeignet für die Darstellung von Datensätzen, Listen und Daten mit Baumstruktur. 1 Mit XSLT können Sie die XML-Ausgabe in strukturierte Textdokumente wie RSS, RTF oder vcard umwandeln. 1 Sie können XSLT verwenden, um die XML-Ausgabe aus einer Grammatik in eine andere umzuwandeln. 1 Vorlagen vereinfachen die Anwendung bedingter Formatierung auf variable Daten. 1 Sie können FMPXMLRESULT-basierte Stylesheets für Custom Web Publishing und für den XML-Export aus FileMaker Pro-Datenbanken verwenden. 1 FileMaker Server verwaltet die Verarbeitung von FileMaker-XSLT-Stylesheets und verhindert den unbefugten Zugriff auf Daten, die bei Verwendung von Client-seitigen XSLT-Stylesheets ungesichert sein könnten. Hinweis Weitere Informationen über Custom Web Publishing mit XSLT finden Sie im Handbuch FileMaker Server Custom Web Publishing mit XSLT.

13 Kapitel 2 Erläuterung von Custom Web Publishing mit PHP Custom Web Publishing mit PHP ermöglicht die Verwendung der Scriptsprache PHP, um Daten aus FileMaker-Datenbanken in Ihre angepassten Web-Seiten-Layouts zu integrieren. Custom Web Publishing mit PHP stellt FileMaker API for PHP bereit, bei dem es sich um eine PHP-Klasse handelt, die von FileMaker erzeugt wird und auf Datenbanken zugreift, die von FileMaker Server bereitgestellt werden. Diese PHP-Klasse stellt eine Verbindung mit der FileMaker Server Web Publishing Engine her und macht Daten für die PHP Engine Ihres Web-Servers verfügbar. Wichtige Funktionen in Custom Web Publishing mit PHP 1 Erstellen Sie Web-Anwendungen, die die Open-Source-Scriptsprache PHP verwenden. Verwenden Sie die von FileMaker Server unterstützte Version PHP 5 oder Ihre eigene Version PHP 4.3, PHP 4.4 oder PHP 5. (Wenn Sie Ihre eigene PHP-Version wählen, finden Sie genauere Informationen unter Manuelle Installation von FileMaker API for PHP auf Seite 14.) 1 Stellen Sie Datenbanken mit FileMaker Server bereit. FileMaker Pro ist für Custom Web Publishing nicht erforderlich, da FileMaker Server die Datenbanken bereitstellt. 1 Verwenden Sie den PHP-Site-Assistenten zur Erstellung des PHP-Codes für Websites, die auf Daten in einer bereitgestellten FileMaker-Datenbank zugreifen. Informationen finden Sie unter Generieren von PHP- Websites mithilfe des FileMaker PHP-Site-Assistenten auf Seite Schreiben Sie PHP-Code, mit dem Datensätze in einer bereitgestellten FileMaker-Datenbank erstellt, gelöscht, bearbeitet und dupliziert werden können. Mit Ihrem Code können Feld- und Datensatzüberprüfungen durchgeführt werden, bevor Änderungen in der bereitgestellten Datenbank bestätigt werden. 1 Schreiben Sie PHP-Code, der auf Layouts, Ausschnitte, Wertelisten und Bezugsfelder zugreift. Wie in FileMaker Pro basiert der Zugriff auf Daten, Layouts und Felder auf den Benutzerkontoeinstellungen, die in den Zugriffsrechten der Datenbank definiert sind. Die Web Publishing Engine unterstützt auch mehrere andere Sicherheitsverbesserungen. Weitere Informationen finden Sie unter Schützen veröffentlichter Datenbanken auf Seite Schreiben Sie PHP-Code, der komplexe Scripts mit mehreren Schritten ausführt. Im Web werden ungefähr 70 ScriptMaker -Scriptschritte unterstützt. Weitere Informationen finden Sie unter FileMaker-Scripts und Custom Web Publishing auf Seite Schreiben Sie PHP-Code, der komplexe Suchabfragen ausführt. Anforderungen für Web-Publishing Dieser Abschnitt beschreibt, was für die Entwicklung einer Custom Web Publishing-Lösung mit PHP erforderlich ist, was Web-Benutzer benötigen, um auf eine Custom Web Publishing-Lösung zuzugreifen und welche Auswirkungen die Bereitstellung einer Web Publishing-Lösung auf Ihren Server haben könnte. Voraussetzungen für das Veröffentlichen einer Datenbank mit Custom Web Publishing Um Datenbanken mithilfe von Custom Web Publishing mit PHP zu veröffentlichen, benötigen Sie: 1 einen FileMaker Server-Einsatz, der sich aus drei Komponenten zusammensetzt. 1 einen Web-Server, entweder Microsoft IIS (Windows) oder Apache (Mac OS). Das FileMaker Web Server-Modul ist auf dem Web-Server installiert. 1 die FileMaker Web Publishing Engine. 1 den FileMaker Datenbank-Server.

14 14 FileMaker Server Custom Web Publishing mit PHP 1 PHP ist auf dem Web-Server installiert. FileMaker Server kann die unterstützte Version PHP 5 installieren oder Sie können Ihre eigene Version verwenden. Sie benötigen mindestens die PHP- Version 4.3. Weitere Informationen zu PHP erhalten Sie unter Die auf dem Web-Server installierte PHP-Version muss curl-funktionen (Client URL Library) unterstützen. Weitere Informationen zu curl erhalten Sie unter Wichtig Wenn Sie die von FileMaker Server unterstützte Version PHP 5 installieren, wird es nicht im Mac OS X Server Admin-Tool angezeigt. Die Auflistungsfunktion wird nicht unterstützt. Wenn Sie das Mac OS X Server Admin-Tool für die Aktivierung von PHP verwenden, deaktivieren Sie die von FileMaker Server unterstützte Version PHP 5 und aktivieren Sie Ihre eigene PHP-Version. 1 eine oder mehrere FileMaker Pro-Datenbanken, die FileMaker Server bereitstellt. 1 IP-Adresse oder Domänenname des Hosts, auf dem der Web-Server läuft. 1 einen beliebigen Webbrowser und Zugriff auf den Web-Server, um Ihre Custom Web Publishing-Lösung zu entwickeln und zu testen. Weitere Informationen finden Sie im Handbuch FileMaker Pro Einführung. Voraussetzungen für Web-Benutzer zum Zugriff auf eine Custom Web Publishing-Lösung Für den Zugriff auf eine Custom Web Publishing-Lösung mit PHP benötigen Web-Benutzer: 1 einen Webbrowser 1 Zugang zum Internet oder zu einem Intranet und zum Web-Server 1 IP-Adresse oder Domänenname des Hosts, auf dem der Web-Server läuft Wenn die Datenbank passwortgeschützt ist, müssen Web-Benutzer auch einen Benutzernamen und ein Passwort für ein Datenbankkonto eingeben. Verbindung zum Internet oder zu einem Intranet Wenn Sie Datenbanken im Internet oder in einem Intranet veröffentlichen, muss auf dem Host-Computer FileMaker Server laufen und die freizugebenden Datenbanken müssen bereitgestellt und verfügbar sein. Zusätzlich: 1 Veröffentlichen Sie Ihre Datenbank auf einem Computer, der über eine ständige Verbindung zum Internet bzw. Intranet verfügt. Sie können Datenbanken zwar ohne ständige Verbindung veröffentlichen, aber sie stehen Web-Benutzern nur zur Verfügung, wenn Ihr Computer mit dem Internet bzw. Intranet verbunden ist. 1 Der Host-Computer für den Web-Server, der Teil des FileMaker Server-Einsatzes ist, muss über eine eigene statische (permanente) IP-Adresse oder einen Domänennamen verfügen. Wenn Sie die Verbindung zum Internet über einen Internet-Anbieter (ISP) herstellen, könnte Ihre IP-Adresse dynamisch zugewiesen werden (d. h., sie ändert sich bei jeder Verbindung). Mit einer dynamischen IP-Adresse ist es für Web-Benutzer schwieriger, Ihre Datenbanken zu finden. Wenn Sie sich über Ihre Zugangsart nicht sicher sind, wenden Sie sich an Ihren ISP oder Netzwerkadministrator. Manuelle Installation von FileMaker API for PHP Bei der Installation von FileMaker Server erhalten Sie die Möglichkeit, die von FileMaker unterstützte PHP-Version (PHP 5) zu installieren. Wenn bereits eine PHP-Engine installiert und konfiguriert ist und Sie nur FileMaker API for PHP hinzufügen möchten, installieren Sie die Klasse FileMaker API for PHP manuell, um Sie für Ihre PHP-Scripts zur Verfügung zu stellen. Hinweis FileMaker Server wurde für die PHP-Versionen , PHP und PHP getestet. Wenn Sie eine andere PHP-Version verwenden, sollten Sie auf die von FileMaker unterstützte PHP-Version aufrüsten.

15 Kapitel 2 Erläuterung von Custom Web Publishing mit PHP 15 Bereitstellung von FileMaker API for PHP für Ihre PHP-Scripts Bei der Installation von FileMaker Server wurde das FileMaker API for PHP-Paket als.zip-datei an folgendem Ort gespeichert: 1 Für IIS (Windows): <Laufwerk>:\Programme\FileMaker\FileMaker Server\Web Publishing\FM_API_for_PHP_Standalone.zip wobei <Laufwerk> sich auf das Laufwerk bezieht, auf dem die Web-Server-Komponente Ihres FileMaker- Server-Einsatzes gespeichert ist. 1 Für Apache (Mac OS): /Library/FileMaker Server/Web Publishing/FM_API_for_PHP_Standalone.zip Die Datei FM_API_for_PHP_Standalone.zip enthält die Datei FileMaker.php und den Ordner FileMaker. Entzippen Sie die Datei und kopieren Sie die Datei FileMaker.php und den Ordner FileMaker in einen der folgenden Orte: 1 den Root-Ordner des Web-Servers, in dem Ihre PHP-Scripts gespeichert sind. 1 Für IIS (Windows): <Laufwerk>:\Inetpub\wwwroot, wobei <Laufwerk> sich auf das Laufwerk bezieht, auf dem sich die Web Publishing Engine-Komponente Ihres FileMaker-Servers befindet. 1 Für Apache (Mac OS): /Library/WebServer/Documents 1 eines der Verzeichnisse include_path in Ihrer PHP-Installation. Der Standardpfad für Mac OS X ist /usr/lib/php. Die nächsten Schritte Hier einige Vorschläge, um mit der Entwicklung von Custom Web Publishing-Lösungen zu beginnen: 1 Verwenden Sie FileMaker Server Admin Console für die Aktivierung von Custom Web Publishing. Informationen hierzu finden Sie in der FileMaker Server Hilfe und im Handbuch FileMaker Server Einführung. 1 Öffnen Sie in FileMaker Pro jede FileMaker-Datenbank, die Sie veröffentlichen wollen, und stellen Sie sicher, dass in der Datenbank die geeigneten erweiterten Zugriffsrechte für Custom Web Publishing aktiviert sind. Weitere Informationen finden Sie unter Aktivierung von Custom Web Publishing mit PHP für Datenbanken auf Seite Wie Sie mithilfe von FileMaker API for PHP auf Daten in FileMaker-Datenbanken zugreifen, erfahren Sie in Kapitel 5, Verwendung von FileMaker API for PHP.

16 16 FileMaker Server Custom Web Publishing mit PHP

17 Kapitel 3 Vorbereiten von Datenbanken für Custom Web Publishing Bevor Sie Custom Web Publishing mit einer Datenbank verwenden können, müssen Sie die Datenbank vorbereiten und vor unbefugtem Zugriff schützen. Aktivierung von Custom Web Publishing mit PHP für Datenbanken Sie müssen Custom Web Publishing mit PHP in jeder Datenbank aktivieren, die Sie veröffentlichen wollen. Anderenfalls können Web-Benutzer Custom Web Publishing nicht für den Zugriff auf eine Datenbank verwenden, selbst wenn sie von FileMaker Server bereitgestellt wird, der zur Unterstützung einer Web Publishing Engine konfiguriert ist. So aktivieren Sie Custom Web Publishing in einer Datenbank: 1. Öffnen Sie in FileMaker Pro die zu veröffentlichende Datenbank mit einem Konto, das über die Berechtigung für vollen Zugriff oder die Berechtigung Erweiterte Zugriffsrechte verwalten verfügt. 2. Weisen Sie einer oder mehreren Berechtigungen das erweitere Zugriffsrecht fmphp zu, um Custom Web Publishing mit PHP zu aktivieren. 3. Weisen Sie die Berechtigungen mit dem erweiterten Zugriffsrecht den entsprechenden Konten (zum Beispiel Admin und Gast) zu. Wichtig Wenn Sie Kontonamen und Passwörter für Custom Web Publishing-Lösungen definieren, verwenden Sie druckbare ASCII-Zeichen. Beispiel: a-z, A-Z und 0-9. Verwenden Sie für sicherere Kontonamen und Passwörter zudem bestimmte nicht alphanumerische Zeichen wie ein Ausrufezeichen (!) oder ein Prozentzeichen (%). Doppelpunkte (:) sind nicht zulässig. Informationen über das Einrichten von Konten finden Sie in der FileMaker Pro Hilfe. 4. Stellen Sie mithilfe von FileMaker Server Admin Console sicher, dass die Bereitstellung der Datenbank richtig konfiguriert ist und FileMaker Server auf sie zugreifen kann. Informationen hierzu finden Sie in der FileMaker Server Hilfe. Hinweis Da Custom Web Publishing mit PHP keine persistenten Datenbanksitzungen verwendet, können Verweise auf eine externe ODBC-Datenquelle im FileMaker Pro-Beziehungsdiagramm die Funktionen der PHP-Lösung einschränken. Wenn Ihre Datenbank auf Daten einer externen SQL-Datenquelle zugreift, können Sie die Datensätze der externen Tabelle unter Umständen nicht aktualisieren. Erstellung von Layouts für Custom Web Publishing mit PHP Custom Web Publishing mit PHP bietet keinen direkten Tabellenzugriff auf Daten in FileMaker Pro- Datenbanken, sondern verwendet die in den Datenbanken definierten Layouts. Zwar muss kein eigenes Layout für Custom Web Publishing mit PHP erstellt werden, es kann jedoch aus mehreren Gründen vorteilhaft sein, ein Layout speziell für eine PHP-Lösung zu entwickeln: 1 Verbesserung der Leistung durch die Erstellung eines Layouts, das auf Felder, Beschriftungen und Ausschnitte beschränkt ist, die Sie für Ihre PHP-Lösung benötigen 1 Vereinfachung des PHP-Codes durch einen geringeren Datenverarbeitungsaufwand, da weniger Felder vorhanden sind 1 Trennung der Oberflächengestaltung von den Daten, sodass die Oberfläche an den Web-Benutzer angepasst werden kann

18 18 FileMaker Server Custom Web Publishing mit PHP Schützen veröffentlichter Datenbanken Mit Custom Web Publishing mit PHP können Sie den Zugriff auf Ihre veröffentlichten Datenbanken einschränken. Dabei stehen Ihnen folgende Methoden zur Verfügung: 1 Fordern Sie für Datenbankkonten, die für Custom Web Publishing mit PHP verwendet werden, Passwörter an. 1 Aktivieren Sie das erweiterte Zugriffsrecht für Custom Web Publishing mit PHP nur in den Berechtigungen, denen Sie den Zugriff ermöglichen möchten. 1 Deaktivieren Sie Custom Web Publishing mit PHP für bestimmte Datenbanken, indem Sie das erweiterte Zugriffsrecht fmphp für sämtliche Berechtigungen in dieser Datenbank deaktivieren. Weitere Informationen finden Sie in der FileMaker Pro Hilfe. 1 Aktivieren oder deaktivieren Sie Custom Web Publishing für alle Custom Web Publishing-Lösungen in der Web Publishing Engine mit der FileMaker Server Admin Console. Informationen hierzu finden Sie im Handbuch FileMaker Server Einführung und in der FileMaker Server Hilfe. 1 Konfigurieren Sie Ihren Web-Server, um die IP-Adressen einzuschränken, die über die Web Publishing Engine auf Ihre Datenbanken zugreifen können. Geben Sie beispielsweise an, dass nur Web-Benutzer von der IP-Adresse auf Ihre Datenbanken zugreifen können. Informationen über das Einschränken von IP-Adressen finden Sie in der Dokumentation zu Ihrem Web-Server. 1 Verwenden Sie Secure Sockets Layer (SSL)-Verschlüsselung für die Kommunikation zwischen Ihrem Web-Server und den Webbrowsern. Die SSL-Verschlüsselung wandelt Informationen, die zwischen Servern und Clients übertragen werden, mithilfe von mathematischen Formeln in unverständliche Informationen um. Der englische Fachausdruck für diese Chiffrier-Algorithmen ist Ciphers. Diese Algorithmen nutzt der Empfänger, um mithilfe von Schlüsseln, den sogenannten Chiffrierschlüsseln, die Informationen wieder in verständliche Daten umzuwandeln. Informationen über das Aktivieren und Konfigurieren von SSL erhalten Sie in der Dokumentation zu Ihrem Web-Server. Weitere Informationen zur Sicherung Ihrer Datenbank finden Sie im FileMaker Pro Benutzerhandbuch, das als PDF-Datei unter verfügbar ist. Zugriff auf eine geschützte Datenbank Wenn ein Web-Benutzer mit einer PHP-Lösung auf eine Datenbank zugreift, muss der PHP-Code die Zugangsdaten für die Datenbank über das FileMaker API for PHP bereitstellen. Wenn das Gastkonto für die Datenbank deaktiviert ist oder das erweiterte Zugriffsrecht fmphp nicht aktiviert ist, gibt das FileMaker API for PHP einen Fehler zurück und Ihr PHP-Code muss die Anmeldeinformationen für den Benutzer bereitstellen. Der Lehrgang für das FileMaker API for PHP enthält ein Beispiel, das demonstriert, wie mithilfe der setproperty()-methode ein Benutzername und ein Passwort für eine geschützte Datenbank festgelegt werden. Weitere Informationen finden Sie unter FileMaker API for PHP-Lehrgang auf Seite 27. Der PHP-Site-Assistent unterstützt zwei Optionen für den Zugriff auf geschützte Datenbanken: 1 der PHP-Code kann den Web-Benutzer beim Zugriff auf die Site zur Authentifizierung auffordern. 1 der PHP-Code kann den Datenbankkontonamen und das Passwort in den PHP-Dateien der Site speichern. Genauere Informationen erhalten Sie in der PHP-Site-Assistent Hilfe. Folgende Liste fasst die Abläufe zusammen, wenn Custom Web Publishing für den Zugriff auf eine Datenbank verwendet wird: 1 Wenn einem Konto, das für Custom Web Publishing aktiviert wurde, kein Passwort zugewiesen wurde, muss die PHP-Lösung nur den Kontonamen bereitstellen. 1 Wenn das Gastkonto deaktiviert ist, muss die PHP-Lösung einen Kontonamen und ein Passwort bereitstellen. Die PHP- Lösung kann entweder den Web-Benutzer nach dem Kontonamen und dem Passwort fragen oder den Kontonamen und das Passwort im PHP-Code speichern. Für das Konto muss das erweiterte Zugriffsrecht fmphp aktiviert sein.

19 Kapitel 3 Vorbereiten von Datenbanken für Custom Web Publishing 19 1 Wenn das Gastkonto aktiviert ist und das erweiterte Zugriffsrecht fmphp aktiviert ist: 1 Die PHP-Lösung muss Web-Benutzer beim Öffnen einer Datei nicht zur Eingabe des Kontonamens und Passworts auffordern. Alle Web-Benutzer werden automatisch mit dem Gastkonto angemeldet und erhalten die Gast-Zugriffsrechte. 1 Die Standardberechtigungen für Gastkonten umfassen den Nur-Lese-Zugriff. Sie können für dieses Konto die Standardberechtigungen einschließlich erweiterten Zugriffsrechten ändern. Weitere Informationen finden Sie in der FileMaker Pro Hilfe. 1 Die PHP-Lösung kann den Scriptschritt Erneut anmelden verwenden, um Benutzern zu ermöglichen, sich über ein anderes Konto anzumelden (um beispielsweise von einem Gastkonto in ein Konto mit mehr Berechtigungen zu wechseln). Weitere Informationen erhalten Sie in der FileMaker Pro Hilfe. Da PHP- Verbindungen jedoch keine persistenten Datenbanksitzungen verwenden, muss die PHP-Lösung den Kontonamen und das Passwort speichern, um sie für alle nachfolgenden Abfragen zu verwenden. Hinweis Standardmäßig können Web-Benutzer ihr Kontopasswort nicht von einem Webbrowser aus ändern. Sie können diese Funktion über den Scriptschritt Passwort ändern in Ihrer Datenbank aktivieren, damit Web-Benutzer ihr Passwort vom Browser aus ändern können. Weitere Informationen finden Sie in der FileMaker Pro Hilfe. Veröffentlichen des Inhalts von Medienfeldern im Web Der Inhalt eines Medienfelds, z. B. eine Bilddatei, kann entweder in einer FileMaker-Datenbank oder als Dateiverweis mit einem relativen Pfad gespeichert werden. Verwendung des Inhalts eines Medienfelds in einer PHP-Lösung: 1 Verwenden Sie die richtigen HTML-Tags, um das Web-kompatible Objekt anzugeben, das in dem Medienfeld enthalten ist, und erzeugen Sie eine URL-Zeichenfolge, die den Dateipfad für das Quellattribut des HTML-Tags wiedergibt. <IMG src="img.php?-url=<?php echo urlencode($record->getfield('cover Image'));?>"> 1 Verwenden Sie das FileMaker API for PHP, um das Datenbankobjekt mit den entsprechenden Zugangsdaten (Kontoname und Passwort) zu definieren, und verwenden Sie dann für den Abruf der Medienfelddaten die Methode getcontainerdata(). $fm = & new FileMaker(); $fm->setproperty('database', $databasename); $fm->setproperty('username', $username); $fm->setproperty('password', $password); echo $fm->getcontainerdata($_get['-url']); Der Lehrgang zum FileMaker API for PHP enthält weitere Beispiele zur Verwendung von Medienfeldern. Weitere Informationen finden Sie unter FileMaker API for PHP-Lehrgang auf Seite 27. Wenn ein Medienfeld einen Dateiverweis speichert, gehen Sie wie folgt vor, um die Dateien, auf die verwiesen wird, mit der Web Publishing Engine zu veröffentlichen: 1. Speichern Sie die Medienobjektdateien im Web-Ordner des FileMaker Pro-Ordners. 2. Fügen Sie in FileMaker Pro die Objekte in das Medienfeld ein und wählen Sie die Option Nur Verweis auf die Datei speichern. 3. Kopieren oder verschieben Sie die Objektdateien, auf die verwiesen wird, im Web-Ordner an die gleiche Stelle im relativen Pfad des Root-Ordners der Web-Server-Software. 1 Für IIS (Windows): <Laufwerk>:\Inetpub\wwwroot, wobei <Laufwerk> sich auf das Laufwerk bezieht, auf dem sich die Web Publishing Engine-Komponente Ihres FileMaker-Servers befindet. 1 Für Apache (Mac OS): /Library/WebServer/Documents

20 20 FileMaker Server Custom Web Publishing mit PHP Hinweise 1 Für Medienobjekte, die als Dateiverweise gespeichert sind, muss Ihr Web-Server so konfiguriert sein, dass er die MIME (Multipurpose Internet Mail Extensions)-Typen für alle Arten von Dateien unterstützt, die Sie anbieten wollen (z. B. Filme). Ihr Web-Server bestimmt die Unterstützung für die aktuellen MIME-Typen, die für das Internet registriert sind. Die Web Publishing Engine ändert die MIME-Unterstützung eines Web- Servers nicht. Weitere Informationen finden Sie in der Dokumentation zu Ihrem Web-Server. 1 Alle QuickTime-Filme werden in Medienfeldern als Verweis gespeichert. Anzeige von Medienfelddaten durch Web-Benutzer Bei der Veröffentlichung einer Datenbank mit der Web Publishing Engine gelten folgende Einschränkungen für die Medienfelddaten: 1 Web-Benutzer können keine Töne abspielen oder OLE-Objekte in einem Medienfeld anzeigen stattdessen wird eine Grafik angezeigt. 1 Web-Benutzer können den Inhalt eines Medienfelds nicht ändern oder ihm Inhalte hinzufügen. Web-Benutzer können Medienfelder nicht verwenden, um Daten in die Datenbank hochzuladen. 1 Wenn Ihre Datenbank Grafiken in anderen Formaten als GIF oder JPEG enthält, erstellt die Web Publishing Engine ein temporäres JPEG-Bild, wenn die Grafikdaten von einem Webbrowser angefordert werden. 1 Die Web Publishing Engine unterstützt kein Streaming von Filmen. Web-Benutzer müssen die gesamte Filmdatei herunterladen, bevor sie den Film ansehen können. FileMaker-Scripts und Custom Web Publishing Die ScriptMaker-Funktion in FileMaker Pro kann sich häufig wiederholende Aufgaben automatisieren oder mehrere Aufgaben zusammenfassen. In Kombination mit Custom Web Publishing ermöglichen FileMaker- Scripts den Web-Benutzern, eine Reihe von Aufgaben durchzuführen. FileMaker-Scripts lassen zudem Aufgaben zu, die ansonsten nicht unterstützt werden, wie die Verwendung des Scriptschritts Passwort ändern, um Web- Benutzern die Passwortänderungen über einen Browser zu ermöglichen. FileMaker unterstützt ungefähr 70 Scriptschritte in Custom Web Publishing. Um nicht unterstützte Scriptschritte anzuzeigen, wählen Sie im Dialogfeld Script bearbeiten in FileMaker Pro die Option Web-Kompatibilität anzeigen. Grau dargestellte Scripts werden nicht im Web unterstützt. Informationen über das Erstellen von Scripts finden Sie in der FileMaker Pro Hilfe. Tipps und Überlegungen zu Scripts Auch wenn viele Scriptschritte im Web identisch funktionieren, gibt es einige, die sich anders verhalten. Weitere Informationen erhalten Sie unter Scriptverhalten in Custom Web Publishing-Lösungen auf Seite 22. Testen Sie alle Scripts, die von einem Webbrowser ausgeführt werden, bevor Sie Ihre Datenbank bereitstellen. Stellen Sie sicher, dass Sie sich mit unterschiedlichen Benutzerkonten anmelden, damit Sie sichergehen können, dass die Scripts für alle Clients gleichermaßen funktionieren. Beachten Sie folgende Tipps und Überlegungen: 1 Verwenden Sie Konten und Zugriffsrechte, um die Scripts einzuschränken, die ein Web-Benutzer ausführen kann. Überprüfen Sie, ob die Scripts nur Web-kompatible Scriptschritte enthalten und nur Zugang zu Scripts gewähren, die von einem Webbrowser aus ausgeführt werden sollen. 1 Berücksichtigen Sie die Nebeneffekte von Scripts, die eine Reihe von Scriptschritten ausführen, die durch Zugriffsrechte kontrolliert werden. Wenn ein Script beispielsweise einen Scriptschritt zum Löschen von Datensätzen enthält und der Web-Benutzer sich nicht mit einem Konto anmeldet, das das Löschen von Datensätzen zulässt, führt das Script den Scriptschritt zum Löschen von Datensätzen nicht aus. Das Script könnte jedoch weiter ausgeführt werden, so dass unerwartete Ergebnisse auftreten können.

21 Kapitel 3 Vorbereiten von Datenbanken für Custom Web Publishing 21 1 Wählen Sie im ScriptMaker-Dialogfeld Script bearbeiten Script mit vollen Zugriffsrechten ausführen, damit Scripts Aufgaben ausführen können, für die Sie dem Benutzer an sich keinen Zugang gewähren wollen. Beispielsweise können Sie Benutzern untersagen, Datensätze zu löschen, indem Sie Ihre Konten und Berechtigungen beschränken, ihnen aber die Ausführung eines Scripts gestatten, das unter vordefinierten Bedingungen innerhalb eines Scripts bestimmte Arten von Datensätzen löscht. 1 Wenn Ihre Scripts Schritte enthalten, die nicht unterstützt werden (z. B. Schritte, die nicht Web-kompatibel sind), verwenden Sie den Scriptschritt AnwenderAbbruchZulassen setzen, um festzulegen, wie nachfolgende Schritte gehandhabt werden. 1 Wenn der Scriptschritt AnwenderAbbruchZulassen setzen aktiviert (ein) ist, hindern nicht unterstützte Scriptschritte das Script an der Fortsetzung. 1 Wenn AnwenderAbbruchZulassen setzen ausgeschaltet ist, werden nicht unterstützte Scriptschritte übersprungen und das Script setzt die Ausführung fort. 1 Wenn dieser Scriptschritt nicht enthalten ist, werden Scripts ausgeführt, als ob die Funktion aktiv wäre, d. h., nicht unterstützte Scriptschritte stoppen Scripts. 1 Einige Scripts, die mit einem Schritt von einem FileMaker Pro-Client aus funktionieren, benötigen eventuell einen zusätzlichen Schritt Schreibe Änderung Datens./Abfrage, um die Daten auf dem Host zu speichern. Da Web-Benutzer nicht über eine direkte Verbindung zum Host verfügen, werden sie nicht sofort benachrichtigt, wenn sich Daten ändern. Funktionen wie bedingte Wertelisten funktionieren z. B. nicht gleichermaßen für Web-Benutzer, da die Daten auf dem Host gespeichert werden müssen, bevor sich die Wirkung in einem Wertelistenfeld zeigt. 1 Scripts, die Daten verändern, sollten den Schritt Schreibe Änderung Datens./Abfrage enthalten, da Datenänderungen erst im Browser sichtbar werden, wenn die Daten gespeichert bzw. am Server bestätigt wurden. Dies gilt für einige Scriptschritte wie Ausschneiden, Kopieren, Einfügen usw. Viele Aktionen mit nur einem Scriptschritt sollten in Scripts umgewandelt werden, die den Schritt Schreibe Änderung Datens./ Abfrage enthalten. Wenn Sie Scripts entwerfen, die von einem Webbrowser aus ausgeführt werden, nehmen Sie den Schritt Schreibe Änderung Datens./Abfrage am Ende des Scripts auf, um sicherzustellen, dass alle Änderungen gespeichert werden. 1 Um von der Art des Clients abhängige Scripts zu erstellen, verwenden Sie die Funktion Hole(ProgrammVersion). Wenn der zurückgegebene Wert Web Publishing Engine enthält, wissen Sie, dass der aktuelle Benutzer über Custom Web Publishing auf Ihre Datenbank zugreift. Weitere Informationen zu Funktionen finden Sie in der FileMaker Pro Hilfe. 1 Nachdem Sie Ihre Dateien konvertiert haben, öffnen Sie jedes Script, das Web-Benutzer ausführen könnten, und aktivieren Sie die Option Web-Kompatibilität anzeigen, um sicherzustellen, dass das Script mit Custom Web Publishing einwandfrei ausgeführt wird.

22 22 FileMaker Server Custom Web Publishing mit PHP Scriptverhalten in Custom Web Publishing-Lösungen Die nachfolgenden Scriptschritte arbeiten im Web anders als in FileMaker Pro. Weitere Informationen zu allen Scriptschritten finden Sie in der FileMaker Pro Hilfe. Scriptschritt Script ausführen Programm beenden AnwenderAbbruchZul assen setzen Fehleraufzeichnung setzen Scriptpause setzen Sortieren URL öffnen Gehe zu Feld Schreibe Änderung Datens./Abfrage Verhalten in Custom Web Publishing-Lösungen Scripts können nur dann in anderen Dateien ausgeführt werden, wenn die Dateien auf FileMaker Server bereitgestellt werden und Custom Web Publishing in den anderen Dateien aktiviert ist. Meldet Web-Benutzer ab, schließt alle Fenster, beendet aber den Webbrowser nicht. Legt fest, wie nicht unterstützte Scriptschritte gehandhabt werden. Aktivieren, damit Scripts gestoppt werden; deaktivieren, damit nicht unterstützte Schritte übersprungen werden. Weitere Informationen finden Sie unter Tipps und Überlegungen zu Scripts auf Seite 20. Hinweis Web-Benutzer können Custom Web Publishing-Scripts nicht abbrechen, aber diese Option ermöglicht, dass nicht unterstützte Scriptschritte die Fortsetzung des Scripts stoppen. Diese Option ist bei Custom Web Publishing immer aktiviert. Web-Benutzer können Custom Web Publishing-Scripts nicht abbrechen. Diese Scriptschritte werden zwar in Custom Web Publishing unterstützt, sollten aber nicht verwendet werden. Wenn der Scriptschritt Scriptpause setzen ausgeführt wird, hält das Script an. Nur ein Script, das erneut den Schritt Scriptpause setzen enthält, kann die Ausführung fortsetzen. Wenn das Script im Pausezustand bleibt, bis die Sitzung endet, wird das Script nicht vollständig ausgeführt. Eine festgelegte Sortierfolge muss mit dem Scriptschritt gespeichert werden, um mit Custom Web Publishing ausgeführt zu werden. Dieser Scriptschritt hat keine Wirkung in einer Custom Web Publishing-Lösung. Im Webbrowser können Sie Gehe zu Feld nicht verwenden, um zu einem bestimmten Feld zu wechseln. Sie können diesen Scriptschritt jedoch in Kombination mit anderen Scriptschritten verwenden, um Aufgaben auszuführen. Beispielsweise können Sie zu einem Feld gehen und den Inhalt kopieren und dann zu einem anderen Feld gehen und den Wert einfügen. Um die Wirkung im Browser zu sehen, müssen Sie den Datensatz mit dem Scriptschritt Schreibe Änderung Datens. speichern. Sendet den Datensatz zur Datenbank.

23 Kapitel 4 Übersicht über Custom Web Publishing mit PHP Das FileMaker API for PHP unterstützt Sie bei der Integration von Daten aus FileMaker Pro-Datenbanken in PHP-Lösungen. Dieses Kapitel beschreibt die Funktionsweise von PHP mit der FileMaker Server Custom Web Publishing Engine und stellt ein Tool vor, das Ihnen den Einstieg in die Erstellung von PHP-Lösungen erleichtert: den FileMaker PHP-Site-Assistenten. Weitere Informationen über das FileMaker API for PHP finden Sie in Kapitel 5, Verwendung von FileMaker API for PHP. Funktionsweise der Web Publishing Engine mit PHP-Lösungen FileMaker Server besteht aus drei Komponenten: dem Web-Server, der Web Publishing Engine und dem Datenbank-Server. (Diese Komponenten können sich auf bis zu drei Rechner verteilen. Weitere Informationen hierzu finden Sie in der FileMaker Server Einführung.) FileMaker Server stellt die PHP-Lösung bereit, wenn Sie die PHP-Dateien auf dem Web-Server speichern, auf dem die PHP-Engine installiert ist. 1 Wenn ein Web-Benutzer eine PHP-Lösung öffnet, leitet der Web-Server die Anforderung an die PHP-Engine weiter, die den PHP-Code verarbeitet. 1 Wenn der PHP-Code Aufrufe für das FileMaker API for PHP enthält, werden diese Aufrufe interpretiert und als Abfragen an die Web Publishing Engine gesendet. 1 Die Web Publishing Engine fordert Daten von den Datenbanken an, die der Datenbank-Server bereitstellt. 1 Der Datenbank-Server sendet die angeforderten Daten an die Web Publishing Engine. 1 Die Web Publishing Engine sendet die Daten als Antwort auf den API-Aufruf an die PHP-Engine auf dem Web-Server. 1 Die PHP-Lösung verarbeitet die Daten und zeigt sie dem Web-Benutzer an. Allgemeine Schritte bei Custom Web Publishing mit PHP Zusammenfassung der Schritte bei der Verwendung von Custom Web Publishing mit PHP: 1. Stellen Sie in Admin Console sicher, dass PHP Publishing aktiviert ist. Weitere Informationen finden Sie in der FileMaker Server Einführung. 2. Öffnen Sie in FileMaker Pro jede FileMaker-Datenbank, die Sie veröffentlichen wollen, und stellen Sie sicher, dass in der Datenbank das erweiterte Zugriffsrecht fmphp für Custom Web Publishing mit PHP aktiviert ist. Weitere Informationen finden Sie unter Kapitel 3, Vorbereiten von Datenbanken für Custom Web Publishing. Hinweis Stellen Sie sicher, dass Sie entsprechende FileMaker-Datenbankberechtigungen verwenden, wenn Sie PHP-Lösungen entwickeln, die an den Endbenutzer gegeben werden. Andernfalls haben Sie in der FileMaker-Datenbank eventuell Zugriff auf Layouts und Funktionen, die dann dem Endbenutzer nicht zur Verfügung stehen und damit zu inkonsistentem Verhalten führen. 3. Verwenden Sie für die Erstellung Ihrer PHP-Lösung PHP-Authoring-Tools. Sie können den FileMaker PHP-Site-Assistenten verwenden, um den grundlegenden PHP-Code für Ihre Site zu erstellen. Verwenden Sie diesen erstellten Code, ohne Änderungen vorzunehmen, oder verwenden Sie ihn als Grundlage für die Entwicklung einer komplexeren Site. Der vom PHP-Site- Assistenten entwickelte PHP-Code beinhaltet alle Voraussetzungen und Funktionen, um korrekt auf die Daten in einer FileMaker Pro-Datenbank zuzugreifen. Weitere Informationen finden Sie unter Generieren von PHP-Websites mithilfe des FileMaker PHP-Site-Assistenten auf Seite 24.