Maschinenlesbare Schnittstellen für Ergebnistabellen

XML-Schnittstelle

Derzeit bieten wir einen XML-Export, der sich leicht weiterverarbeiten läßt. XML ist seit vielen Jahren ein beliebtes Austauschformat für komplexere Datenbereiche, und hat sich in der B2B-Kommunikation bewährt, z.B. die XRechnung. Wir nutzen XML in SuperX seit 2001, jeder Standardbericht läßt sich in der Benutzeroberfläche als XML exportieren. Darüber hinaus können Sie den Abruf auch automatisieren.

Aufruf über http

Beispiel unter Linux für die Maske 16000 Studierende und Studienanfänger nach Geschlecht:

wget -O test.xml 'https://mein-superx-server/superx/servlet/SuperXmlTabelle?tid=16000&kennung=public&passwort=1234567&contenttype=text/xml&stylesheet=tabelle_xml.xsl'

Unter Windows/DOS kann man das Binary-Paket wget installieren und dann so starten:

wget -O test.xml "https://mein-superx-server/superx/servlet/SuperXmlTabelle?tid=16000&kennung=public&passwort=1234567&contenttype=text/xml&stylesheet=tabelle_xml.xsl"

Beschreibung des XML-Formats

Das XML-Format hat ein Schema, das hier technisch dokumentiert ist.

Dieser Abschnitt befasst sich mit den wesentlichen Elementen der XML-Schnittstelle. Der Editor Jedit liefert einen übersichtlichen Baum zur Navigation in XML-Dateien:

imgsrcXML_Schnittstelle_Uebersicht.pngwidth400captionXML Navigation in Jedit

Hierbei handelt es sich um die XML der Ergebnistabelle des Berichtes "Studierende nach Erst- und Neueinschreibung (Zeitreihe)":

imgsrcErgebnistabelle_Stud_ErstNeuEinschr_Zeitr.pngwidth700captionErgebnistabelle des Berichtes "Studierende nach Erst- und Neueinschreibung (Zeitreihe)"

Die Ergebnistabelle ist hierarchisch strukturiert, unterhalb des Root-Elements sind 1-n ergebnis-Elemente verfügbar. Das Element felder enthält jene Felder, welcher für die Selektion genutzt wurden. Das Element completefields enthält alle Felder der jeweiligen Auswahlmaske:

imgsrcXML_Schnittstelle_Felder.pngwidth400captionDas Element felder

Das Element headers enthält die Spaltenüberschriften der Ergebnistabelle:

imgsrcXML_Schnittstelle_Header.pngwidth400captionDas Element headers

Das Element row und sein Unterelement col enthalten die Werte der Ergebnistabelle:

imgsrcXML_Schnittstelle_Row_Col.pngwidth400captionDie Elemente row und col

Dem Beispiel entsprechend gibt es 4 row-Elemente und 13 col-Elemente.

Das Attribut typ innerhalb der col-Elemente definiert den Datentyp:

Es wird mit amerikanischem Zahlenformat gearbeitet (Punkt als Dezimaltrenner).

Das Datumsformat ist dd.MM.yyyy

Weiterverarbeitung