Zuletzt bearbeitet vor 2 Jahren
von Daniel Quathamer

Maschinenlesbare Schnittstellen für Ergebnistabellen

Es ist geplant, mit SuperX eine REST-Schnittstelle für Ergebnistabellen anzubieten. Bis dahin können Sie auch mit der XML-Schnittstelle arbeiten.

XMLSchnittstelle

Aufruf über http

  • Deeplink der Ergebnistabelle erzeugen
  • Download mit wget oder curl, dabei Übergabe von den Parametern:
    • benutzer = Benutzerkennung
    • passwort = Passwort
    • contenttype=text/xml
    • stylesheet=tabelle_xml.xsl

Beschreibung des XML-Formats

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

XML Navigation in Jedit

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

Ergebnistabelle 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:

Das Element felder


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

Das Element headers

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

Die 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:

  • 1=string (Default)
  • 3=DecimalFormat
  • 4=integer
  • 6=date
  • 8=timestamp
  • 9=time
attention.svg Es wird mit amerikanischem Zahlenformat gearbeitet (Punkt als Dezimaltrenner).

Das Datumsformat ist dd.MM.yyyy

Weiterverarbeitung

  • XML-Parser zum Abfragen
  • Import mit Kettle