Zuletzt bearbeitet vor 2 Jahren
von Daniel Quathamer

Maschinenlesbare Schnittstellen für Ergebnistabellen: Unterschied zwischen den Versionen

Zeile 37: Zeile 37:


{{ImagePara |imgsrc=XML_Schnittstelle_Row_Col.png|width=400|caption=Die Elemente row und col}}
{{ImagePara |imgsrc=XML_Schnittstelle_Row_Col.png|width=400|caption=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
</blockquote>
</blockquote>
{{Achtung|Es wird mit amerikanischem Zahlenformat gearbeitet (Punkt als Dezimaltrenner).
Das Datumsformat ist dd.MM.yyyy}}


==Weiterverarbeitung==
==Weiterverarbeitung==
* XML-Parser zum Abfragen
* XML-Parser zum Abfragen
* Import mit Kettle
* Import mit Kettle

Version vom 7. Juni 2022, 14:32 Uhr

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