XML Schema Dokumentation
Die Dokumentation befindet sich als Zip Version im Downloadbereich.
Sie können sich auch die XML Schemadokumentation direkt im Browser unter folgendem Link ansehen.
Übersicht
Die SaatXML-Schnittstelle stellt einen XML-Datenaustauschdialekt für die Saat- und Pflanzgutanmeldungen dar. Ziel ist es, die bisherige Fixed Length-Schnittstelle abzulösen und durch ein robustes Austauschformat zu ersetzen.
Folgende Vorteile können mit einer neuen XML Schnittstelle realisiert werden:
- gesicherte Zeichenkodierung (Umlaute und Sonderzeichen werden korrekt behandelt)
- strukturiertes Datenformat (XML bekommt eine Syntaxdefinition mittels XML-Schema (XSD))
- Wertelisten für Statusfelder oder Aktionen
- Syntaxprüfungen für alle Felder
- XML kann beliebig transformiert und angepasst werden
- Verarbeitung innerhalb der Anwendungsprogramme vereinfacht sich wesentlich
- Struktur ist flexibel und versionierbar (fehlende Felder können nachgetragen werden, ohne die Verarbeitung zu stören)
Struktur
Die Struktur der SaatXML-Schnittstelle wurde so angelegt, dass die An- oder Rückmeldung einer Vermehrung sämtliche Daten enthalten. Dies bedeutet, dass bewusst auf XML-Referenzen wie z.B.: Adressen im allgemeinen verzichtet wurden.
Der Grund liegt darin, dass es derzeit keine zentrale Datenverwaltung sämtlicher Adressen und Sorten im Datenaustauschprozess gibt.
Daher ist nicht erwartbar, dass z.B. eine Adresse, die innerhalb einer Vermehrung angegeben wurde, auf der Empfängerseite existiert.
Der Strukturaufbau einer SaatXML Datenmeldung gliedert sich wie folgt:
- transaktion = die gesamte Dokumentenklammer
- header = Attribute wie Sendezeit und Sender und Empfänger
- vorgang = bezeichnet den logischen Umschlag um:
- Adressenlieferungen,
- Sortenlieferungen,
- Anmeldungen von Vermehrungen,
- Rückmeldung von Feldbesichtigungen (Bescheiden)
- Rückmeldung von Beschaffenheitsprüfungen (Attest, inkl. Partie)
Nachfolgend ein Übersichtsbild der Struktur: Root Element - transaktion
Anwendung
Eine gültige SaatXML-Datei beginnt mit folgender Deklaration:
<?xml version="1.0" encoding="UTF-8"?> <transaktion xmlns="http://www.saat-xml.de" xsi:schemaLocation="http://www.saat-xml.de http://www.saat-xml.de/saatxml/schema/saatxml.xsd"> <header> ...
XML-Editoren zur Darstellung sowie Erzeugung von XML gibt es viele auf dem Markt. Siehe Altova XMLSpy (http://www.altova.com/xmlspy.html - kostenpflichtig) oder Eclipse (http://www.eclipse.org/downloads/packages/eclipse-ide-javascript-web-developers/heliosr - kostenfrei)