Zuletzt bearbeitet vor 2 Jahren
von Daniel Quathamer

Maschinenlesbare Schnittstellen für Ergebnistabellen: Unterschied zwischen den Versionen

Zeile 10: Zeile 10:


==Beschreibung des XML-Formats==
==Beschreibung des XML-Formats==
<blockquote>
Dieser Abschnitt befasst sich mit den wesentlichen Elementen der XML-Schnittstelle. Der Editor Jedit liefert einen übersichtlichen Baum zur Navigation in XML-Dateien:
Dieser Abschnitt befasst sich mit den wesentlichen Elementen der XML-Schnittstelle. Der Editor Jedit liefert einen übersichtlichen Baum zur Navigation in XML-Dateien:


Zeile 17: Zeile 18:


{{ImagePara |imgsrc=Ergebnistabelle_Stud_ErstNeuEinschr_Zeitr.png|width=700|caption=Ergebnistabelle des Berichtes "Studierende nach Erst- und Neueinschreibung (Zeitreihe)"}}
{{ImagePara |imgsrc=Ergebnistabelle_Stud_ErstNeuEinschr_Zeitr.png|width=700|caption=Ergebnistabelle des Berichtes "Studierende nach Erst- und Neueinschreibung (Zeitreihe)"}}
</blockquote>


Die Ergebnistabelle ist hierarchisch strukturiert, unterhalb des Root-Elements sind 1-n "ergebniselemente" verfügbar. Diese wiederum enthalten im Abschnitt
<blockquote>
* felder: die jeweilige Legende der Selektion
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:
* header: die Spaltenüberschriften
*sqlerg: das tabellearische Ergebnis, mit
** row-Elementen für die Zeilen, und
** col-Elementen für die Spalten und somit Zellen


#hier Screenshot XML-Baum jedit
{{ImagePara |imgsrc=XML_Schnittstelle_Felder.png|width=400|caption=Das Element felder}}
</blockquote>


Im generischen Standardlayout würde die erste Zeile z.B. so aussehen:


#screenshot kamQB gener. standardlayout
<blockquote>
Das Element headers enthält die Spaltenüberschriften der Ergebnistabelle:
 
{{ImagePara |imgsrc=XML_Schnittstelle_Header.png|width=400|caption=Das Element headers}}
</blockquote>
 
<blockquote>
Das Element row und sein Unterelement col enthalten die Werte der Ergebnistabelle:
 
{{ImagePara |imgsrc=XML_Schnittstelle_Row_Col.png|width=400|caption=Die Elemente row und col}}
</blockquote>


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

Version vom 7. Juni 2022, 13:29 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

Weiterverarbeitung

  • XML-Parser zum Abfragen
  • Import mit Kettle