Achtung!

Im Gegensatz zur Nutzung der JSON-Daten für die DAVINCI-WEBBOX oder DAVINCI MOBILE erfolgt keine individuelle Benutzer-Autorisierung.

Wir empfehlen daher ausdrücklich den Einsatz der DAVINCI WEBBOX auf Ihren Webseiten.

XML-Daten

Folgender Aufruf liefert beispielsweise die Unterrichtstermine aus Klassensicht für den aktuellen Tag ab der aktuellen Uhrzeit:

http://127.0.0.1/DAVINCIIS.dll?content=xml& filename=test& type=class &detail=lessons

Über den Parameter content=xml können Sie dem INFOSERVER mitteilen, dass Sie XML-Daten anfordern. Über den Parameter filename=test können Sie dem INFOSERVER ferner mitteilen, dass die XLST Datei „test.xsl“ zur Filterung und Darstellung der Daten verwendet werden soll. Die weiteren Parameter geben an, welche Daten genau geliefert werden sollen, wobei mindestens der type Parameter angegeben werden muss.

Formatparameter

Parameter Beschreibung
content=xml Inhalt der Ergebnisdatei ist XML

Inhaltsparameter

Parameter Beschreibung
category=prüfung Name der Kategorie für calevents, hier z.B. „Prüfung“
content=xml Inhalt der Ergebnisdatei ist XML
detail=calevents Kalendereinträge (Nicht-Unterrichtstermine)
detail=absences Mitteilung über fehlende Klassen bzw. Lehrer
detail=modified Liste der Klassen, Lehrer, Räume mit Änderungen
detail=lessons Unterrichtstermine inkl. Vertretungsänderungen
filename=test Name der Ergebnisdatei, hier „test“
items=2 Maximale Anzahl der Listenelemente (Records) je Klasse, Lehrer, Raum, Fach (Standardvorgabe items=0, d.h. alle Einträge)
name=8a Name der Klasse, des Raums, des Fachs, des Lehrers oder Personennummer des Schülers
type=class Klassenindex
type=teacher Lehrerindex
type=room Raumindex
type=subject Fachindex
type=daysubsthour Tagesvertretungen nach Stunden
type=daysubstclass Tagesvertretungen nach Klassen
type=daysubstteacher Tagesvertretungen nach Lehrern
type=classsubst Klassenvertretungen
type=teachersubst Lehrervertretungen
type=substteacher Vertretungslehrer

Zeitparameter

Parameter Beschreibung
starttime=0800 Startzeit am ersten Tag des Zeitraums als vierstellige Zahl, d.h. 8:00 Uhr (Standardvorgabe ist die aktuelle Uhrzeit)
startdate=11.06.2013 Startdatum des Zeitraums (Standardvorgabe ist das heutige Datum)
enddate=16.06.2013 Enddatum des Zeitraums (Standardvorgabe ist das heutige Datum)
startday=1 Startdatum ist der 1. Werktag nach heute (Standardvorgabe startday=0, d.h. heute)
days=2 Anzahl der Werktage inkl. Heute, hier also heute und morgen. (Standardvorgabe days=1, d.h. nur heute)
week=0 Wochennummer von heutiger Woche (week=0, Standardvorgabe) aus gerechnet, z.B. week=+1 für nächste Woche oder absolute Kalenderwoche des aktuellen Kalenderjahres, z.B. week=24 für die 24. Kalenderwoche.

Allgemeine Beispiele für die Parameterverwendung

Beispiel Ergebnis
content=xml& filename=test&type=class Liste aller Klassen
content=xml& filename=test&type=class&detail=lessons&week=0 Unterrichtstermine aller Klassen für die aktuelle Woche
content=xml& filename=test&type=class&detail=lessons&name=8a&week=0 Unterrichtstermine der Klasse 8a für die aktuelle Woche
content=xml& filename=test&type=class&name=8a&detail=lessons&week=0 Liste aller Klassentermine Klasse 8a für die aktuelle Woche
content=xml& filename=test&type=class&detail=lessons&startday=0&items=1 Liste aller Klassentermine für heute (startday=0) und zwar nur der jeweils erste Termin (items=1) für die jeweilige Klasse
content=xml& filename=test&type=class&detail=lessons&startday=1&items=1 Liste aller Klassentermine für nächsten Arbeitstag (startday=1) und zwar nur der jeweils erste Termin (items=1) für die jeweilige Klasse
content=xml& filename=test&type=daysubsthour Tagesvertretungen nach Klassen für heute ab der aktuellen Uhrzeit
content=xml& filename=test&type=daysubsthour&days=2 Tagesvertretungen nach Klassen für heute ab der aktuellen Uhrzeit und den folgenden Werktag
content=xml& filename=test&type=daysubsthour&startday=1 Tagesvertretungen nach Klassen für den folgenden Werktag

Bei den Vertretungsplanausgaben „type=daysubsthour/ daysubstclass / daysubstteacher / classsubst / teachersubst / substteacher“ wird für das aktuelle Datum die aktuelle Uhrzeit als Startzeit gesetzt, insofern keine Uhrzeit explizit angegeben wird. D.h. wenn Sie z.B. „type=daysubsthour“ ohne weitere Parameter morgens aufrufen, werden Ihnen Vertretungen zurückgeliefert, bei einem Aufruf am Nachmittag liegen evtl. keine Vertretungen mehr vor.

Beispiele für die Parameterverwendung in Smartphone Apps

Beispiel Ergebnis
content=xml&type=class&name=8a&detail=lessons Stundenplan der Klasse “8a” mit Änderungen
content=xml&type=class&name=8a&detail=changes Nur die Liste der Änderungen für die Klasse “8a”
content=xml&type=teacher&name=Con&detail=lessons Stundenplan des Lehrers “Con” mit Änderungen
content=xml&type=teacher&name=Con&detail=changes Nur die Liste der Änderungen für den Lehrer “Con”
content=xml&type=student&name=4711&detail=lessons Stundenplan des Schülers “4711” mit Änderungen
content=xml&type=student&name=4711&detail=changes Nur die Liste der Änderungen für den Schüler mit der Personennummer “4711”

results matching ""

    No results matching ""