XML-Format

Extensible Markup Language (XML) ist eine Sprache zum Austausch strukturierter Daten. XML ist kein fest vorgegebenes Dateiformat, sondern eine Sprache zum Definieren von Formaten, die innerhalb einer Gruppe festgelegt und dann für den Datenaustausch verwendet werden können. Diese Sprache wird von zahlreichen Einzelpersonen, Organisationen und Unternehmen zur Übermittlung von Produktinformationen, Transaktionen, Inventardaten und anderen geschäftlichen Informationen genutzt.

Beispieldateien für den XML-Import und XML-Export stehen für Sie auf der Seite Updates und Versionshinweise zum Download bereit. Allgemeine Informationen zu XML sowie Links zu XML-Ressourcen finden Sie auf der Claris-Website.

Importieren von XML

FileMaker Pro unterstützt die FMPXMLRESULT-Grammatik für den XML-Import. Wenn Sie mit XML-Code in einem anderen Format arbeiten, können Sie ihn während des Imports mithilfe eines Stylesheets in Extensible Stylesheet Language for Transformations (XSLT) in FMPXMLRESULT konvertieren.

Exportieren von XML

FileMaker Pro kann XML in zwei verschiedenen Grammatiken exportieren: FMPXMLRESULT und FMPDSORESULT. Sie können beide Grammatiken beim Export mithilfe eines XSLT-Stylesheets in andere XML-Formate oder in Formate wie HTML oder Text konvertieren. So können Sie mithilfe der XML-Exportfunktion beispielsweise datenbasierte Webseiten oder Textdateien mit Daten erstellen, deren Felder durch ein benutzerdefiniertes Trennzeichen begrenzt werden.

Hinweis Die XML Import- und Exportfunktionen in FileMaker Pro nutzen den XML-Parser libxml2 und den XSLT-Stylesheet-Prozessor libxslt. Bei der Entwicklung von XML und XSL müssen Sie Ihren XML- und XSLT-Code möglicherweise testen. Verwenden Sie dazu einen der libxml2- und libxslt-basierten Parser und Prozessoren, wie etwa die Befehlszeilenprogramme xmllint oder xsltproc, die in macOS verfügbar sind. Weitere Informationen finden Sie in den Repositories von libxml2 und libxslt oder auf den Webseiten anderer Hersteller.

XML FMPDSORESULT-Grammatik

Die FMPDSORESULT-Grammatik eignet sich zum Export von Datenbanken, die Sie mithilfe von Cascading Style Sheets oder XSL formatieren möchten.

Hinweis Datenfeldnamen dürfen nicht mit Ziffern oder 1-Byte-Kana-Zeichen beginnen (zum Beispiel: „7“). Die FMPDSORESULT-Grammatik lässt keine numerischen oder 1-Byte-Kana-Zeichen als Feldnamen-Tag zu und zeigt die resultierende XML-Datei nicht in einem Browser an.

Jedes ROW-Element der exportierten FMPDSORESULT-Grammatik enthält eine Reihe von FIELD-Elementen, die den Feldnamen entsprechen, die Sie exportieren.

Leerschritte oder einzelne Doppelpunkte in Feldnamen werden in den Namen der Elemente in Unterstriche umgewandelt (Beispiel: <TELEFON_PRIVAT>). Doppelte Doppelpunkte in Ausschnittfeldern werden zu Punkten konvertiert (Beispiel: <TELEFON.TELEFON_PRIVAT>). Dies ist erforderlich, da Doppelpunkte in XML für Namensräume reserviert sind und Leerschritte in XML-Elementnamen nicht zulässig sind.

Für Wiederhol- und Bezugsfelder enthält jedes FIELD-Element ein DATA-Element, das einer Wiederholung oder einem Ausschnittdatensatz entspricht.

Der XML-Export unterstützt nicht den Export von Containerfelddaten.

Aufgrund von XML-Einschränkungen wird nur ein Datensatz von jedem Bezugsfeld exportiert.

XML FMPXMLRESULT-Grammatik

Die FMPXMLRESULT-Grammatik enthält zusätzliche Informationen zur Datenbank (beispielsweise die Anzahl der Datensätze, die Feldtypen oder die Feldformate), die nicht in der FMPDSORESULT-Grammatik enthalten sind. Diese Elemente und Attribute sind für die korrekte Überprüfung der XML-Daten erforderlich.

Verwenden Sie die FMPXMLRESULT-Grammatik, wenn Sie die von dieser Grammatik bereitgestellten METADATA-Informationen benötigen. FileMaker Pro unterstützt sowohl den Import als auch den Export in der FMPXMLRESULT-Grammatik. Daher eignet sich dieses Format zur Übertragung von Daten zwischen FileMaker Pro-Dateien.

Hinweis Die FMPXMLRESULT-Grammatik eignet sich nicht besonders gut zur Verwendung mit Cascading Style Sheets (CSS). Wenn Sie CSS im Zusammenhang mit XML-Daten verwenden möchten, sollten Sie auf die FMPDSORESULT-Grammatik zurückgreifen.

In der FMPXMLRESULT-Grammatik enthält das DATABASE-Element die Attribute NAME, RECORDS, DATEFORMAT, LAYOUT und TIMEFORMAT.

Das DATEFORMAT-Attribut legt das Datumsformat des XML-Dokuments fest.

Feld	Langform	Kurzform
Jahr	JJJJ (4 Stellen)	JJ (2 Stellen)
Monat	MM (2 Stellen)	M (1 oder 2 Stellen)
Tag	TT (2 Stellen)	T (1 oder 2 Stellen)

Das TIMEFORMAT-Attribut legt das Zeitformat des XML-Dokuments fest.

Feld	Langform	Kurzform
Stunde (1-12)	hh (2 Stellen)	h (1 oder 2 Stellen)
Stunde (1-24)	hh (2 Stellen)	h (1 oder 2 Stellen)
Minuten	mm
Sekunde	ss
AM/PM	a

Das METADATA-Element enthält ein oder mehrere FIELD-Elemente, von denen jedes Informationen zu einem Feld bzw. einer Spalte enthält, darunter auch den Namen des Felds, wie er in der Datenbank festgelegt ist, den Feldtyp, ob leere Felder zulässig sind (EMPTYOK-Attribut) und die Höchstzahl sich wiederholender Werte (MAXREPEAT-Attribut). Gültige Werte für Feldtypen sind TEXT, NUMBER, DATE, TIME, TIMESTAMP und CONTAINER.

Das RESULTSET-Element enthält alle ROW-Elemente, die die Datensatzdaten in dem XML-Dokument festlegen. Jedes ROW-Element enthält die Daten zum Feld bzw. zur Spalte für eine Zeile des Ergebnissatzes. Dazu gehören u. a. die DatensatzID für die Zeile, die ÄnderungsID für die Zeile und das COL-Element, das die Daten für ein Feld bzw. eine Spalte der Zeile enthält (mehrfache DATA-Elemente stehen hierbei für einen der Werte in einem Wiederhol- oder Ausschnittfeld).