Amtliche Schulverwaltung - Dokumentation - alle:schnittstellen:xml_sst:xmlexport

Änderungen an der XML-Export-Schnittstelle

anonymous@undisclosed.example.com (Anonymous) — Tue, 22 Nov 2016 10:39:38 +0000

Änderungen an der XML-Export-Schnittstelle

Kleinere Änderungen (Umbenennungen)

Das Element <lfd_nr> (Kindelement von den Elementen <lehrkraftdaten_nicht_schulbezogen> und <schuelerin>) wurde in <lokales_differenzierungsmerkmal> umbenannt.
Das Element <lehrkraft_nicht_schulbezogen_id> wurde (analog zum bestehenden Element <lehrkraftdaten_nicht_schulbezogen>) in <lehrkraftdaten_nicht_schulbezogen_id> umbenannt.

Änderungen, die im September 2013 nach Rückmeldung durch die Entwickler eingearbeitet wurden:

Element (alphabetisch)	Kommentar
Im Element SchuelerSchuljahr:
abweisung
aufnahmeberechtigung
besuchtes_fach	Dieses Element war ursprünglich unter <unterrichtselement><schueler_im_unterrichtselement> zu finden
eingabewahl
eintritt_jahrgangsstufe
eintrittsdatum
ganztag_betreuung
gefaehrdung
jahr_nachpruefung
jahrgangsstufe_stichtag_vorjahr
jgst_stichtag_vor_eintritt
lokales_differenzierungsmerkmal
nachholfristen
nachpruefung_bestanden
notenausgleich
notenausgleich_vorjahr
probezeit_bis
religion_ethik	Enthält auch Aussagen über den Grund (z.B. Ethik wg. Religionslosigkeit). Den wirklich besuchten Religionsunterricht erhält man auch aus den Unterrichtselementen.
religionszugehoerigkeit
schuelerfunktionen
schullaufbahnliste	voraussichtlich ab ASV Version > 1.16.671, Ende Januar 2014
sortierung	Achtung: Sortiernummern können mehrfach vorkommen und es können Lücken in der Nummerierung auftreten
sportbefreiung	Dieses Element ist auf Oberstufe Gymnasien bezogen und damit erst mit dem Oberstufenmodul nutzbar.
sportbefreiung_1hj	Sportbefreiung 1. Hj und 2. Hj ist im Schülermodul verfügbar.
sportbefreiung_2hj	Sportbefreiung 1. Hj und 2. Hj ist im Schülermodul verfügbar.
staatsangehoerigkeit
unterbringung
wiederholungsart
ziel_jgst_ende_schuljahr
ziel_jgst_vorjahr
Im Element Schuelerfach:
besonderheit_zeugnis
bezeichnung_abschlusszeugnis
bezeichnung_abschlusszeugnis_2
bezeichnung_jahreszeugnis
bezeichnung_weitere_form
bezeichnung_zwischenzeugnis
zusatzbezeichnung_zeugnis
Im Element Unterrichtselement:
koppel

Folgende Anregungen/Wünsche wurden nicht umgesetzt:

Element	Kommentar
Wahlpflichtfach 1/Wahlpflichtfach 2	siehe <schuelerSchuljahr><besuchtes_fach>. Weder WinSD noch ASV legen eine Reihenfolge fest!
Kopie des Namenskuerzels im Pfad <schulen><lehrkraftdaten_nicht_schulbezogen_liste><lehrkraftdaten_nicht_schulbezogen>, vereinfacht Import	Ist eine Lehrkraft an mehreren Schulen in der Datenbasis eingesetzt, so kann je Schule ein anderes Kürzel erfasst werden. Das Kürzel kann daher nur im Pfad <schulen><schule><lehrkraefte><lehrkraft><namenskuerzel> gespeichert werden.
svp_schueler_stamm.lk1_schuelerfach_id bzw. svp_schueler_stamm.lk2_schuelerfach_id (Notenberechnung)	Beide Attribute sind verwaist. Ob sie im neuen Oberstufenmodul wiederverwendet werden, ist fraglich.
Schüler → Laufbahn → Art der Störung/Schwäche → LRS/Legasthenie	Wird schon im Element <schuelerliste><schuelerin><stoerungschwaecheliste><stoerungschwaeche><art> exportiert
svp_koppel.asd_id	Die Kurzform beschreibt die Koppel in ASV eindeutig. Die ASD-ID dient nur intern der Kommunikation ASV-ASD und bietet keinen Vorteil.
svp_koppel.langform	Das Attribut lässt sich derzeit in ASV nicht erfassen
svp_schueler_schuljahr.wl_vorruecken_probe_vorjahr_id	Das Element wird nur in Baden-Württemberg benutzt
svp_schueler_schuljahr_alt_berechnung.schueler_schuljahr_id svp_schueler_schuljahr_alt_berechnung.schuelerfach_id svp_schueler_schuljahr_alt_berechnung.alt_berechnung	Diese Attribute lassen sich nur innerhalb der Notenverwaltung von ASV pflegen. Falls eine externe Notenverwaltung genutzt wird, sollten sie dort gepflegt werden. Der Export macht aus unserer Sicht keinen Sinn.

XML-Export-FAQ

anonymous@undisclosed.example.com (Anonymous) — Fri, 12 May 2023 10:44:43 +0000

XML-Export-FAQ

Häufig gestellte Fragen aus Sicht der Entwickler von Schulverwaltungsprogrammen:

Wird das StMUK die XML-Exportschnittstelle in regelmäßigen Abständen den Bedürfnissen der Entwickler anderer Schulverwaltungsprogramme anpassen? Soll heißen: Darf man damit rechnen, dass bei sich ändernden Rahmenbedingungen die XML-Schnittstelle angepasst wird oder sollen jetzt schon alle Datenmerkmale aufgelistet werden, die vielleicht erst zukünftig benötigt werden?

Bitte melden Sie uns die jetzt bzw. in naher Zukunft zusätzlich benötigten Merkmale, damit eine erste Version der Schnittstelle entstehen kann.
Jedoch ändern sich die Schullandschaft und damit die zu verarbeitenden Daten ständig - sicher wird sich infolgedessen auch die Schnittstelle im Laufe der Jahre in kleineren oder größeren Details ändern. Gehen Sie davon aus, dass das StMUK innerhalb von ca. drei Monaten auf veränderte Rahmenbedingungen reagieren und die Schnittstelle anpassen kann. Maßgeblich für zukünftige Anpassungen sind einerseits der Datenbedarf externer Verfahren, andererseits aber auch die datenschutzrechtlichen Randbedingungen, insbesondere das Gebot der Datensparsamkeit.

Im Menü "Auswertungen" sind weitere Export-Mechanismen erreichbar; diesen fehlt jedoch ein ID-Feld zur Zuordnung zu Daten aus der XML-Export-Schnittstelle. Ist da noch eine Ergänzung angedacht?

Die erwähnten Exportformate haben nur eine flache Struktur und sind eher für menschenlesbare Listen oder nur im Falle sehr einfach strukturierter Daten zur maschinellen Verarbeitung gedacht.
Die derzeit entstehenden XML-Exporte enthalten umfangreiche, komplex strukturierte Daten für den maschinellen Import in andere Verfahren.

Es erscheint aus unserer Sicht nicht zweckmäßig, aus beiden Systemen Daten zu exportieren und in externen Verfahren dann wieder zu verknüpfen. Falls im XML-Export benötigte Merkmale fehlen sollten, bitten wir wie erwähnt um Rückmeldung; ggf. wird das StMUK den XML-Export entsprechend erweitern.

In welcher Form sollen Entwickler die zusätzlich benötigten Datenmerkmale übermitteln?

grundsätzlich: je präziser, desto besser (weniger Missverständnisse!); Beispiel: in der Form Tabelle.Datenfeld (zu recherchieren im Download ASV_SchemaSpy.zip, abrufbar unter Materialien für externe Entwickler)
möglich wäre z.B. auch die Angabe der Maske (z.B: Datei→Schüler→Tab xxx, Feld yyy)
Falls es sich um Merkmale des vergangenen oder zukünftigen Schuljahres handelt, geben Sie dies bitte unbedingt zusätzlich mit an.

Wie wird sichergestellt, dass Unterrichtselemente (Oberstufe) einer Klasse/Klassengruppe zugeordnet werden können?

Derzeit wird das Konzept für das neue Oberstufenmodul entwickelt. Es ist geplant, den Unterricht in der Qualifikationsphase zukünftig in der Matrix zu führen und so die Zuordnung zur Klasse zu ermöglichen.
Für die Übergangszeit haben wir eine Importschnittstelle von WinQD nach ASV ermöglicht, die den Unterrichtselementen der Qualifikationsphase die Schüler zuordnet, die sie besuchen. Diese Zuordnung wird durch die vorliegende XML-Exportschnittstelle in Dateiform exportiert, so dass sich daraus die Klassen der Schüler ermitteln lassen, die das Unterrichtselement besuchen.

Wie kann mit den Unterrichtselementen des Besonderen Unterrichts verfahren werden bzgl. der Zuordnung Unterrichtselement - Schüler?

Hier werden die Schulen angehalten werden, die Zuordnung Unterrichtselement→Schüler in ASV zu erfassen.

In welcher Form wird beim Export der Oberstufenelemente kenntlich gemacht, ob der Unterricht ein normaler Kurs oder Seminar ist?

Beim Tag <bereich> innerhalb des Tags <unterrichtselement> wurde leider die falsche Werteliste mitgeliefert (Unterrichtsbereich statt Unterrichtselement-Bereich). Die korrekte Werteliste enthält Einträge für W-Seminar und P-Seminar.

Was ändert sich an den exportierten Daten durch die Einführung des Oberstufenmoduls in ASV?

Die Änderungen sind auf dieser Seite ausführlich dargestellt.

Ist das lokale Differenzierungsmerkmal von Schülern aus WinSV auch in ASV und als Merkmal in der Exportschnittstelle verfügbar?

Diese Anforderung ist technisch in kurzer Zeit nicht realsierbar. Im Schuljahr 2013/14 kann aber mit dem WinSV-Datenexport vom Schuljahresanfang gearbeitet werden. Die Schülerdaten müssten im Laufe des Schuljahres entweder doppelt gepflegt werden oder das eingesetzte Programm bietet zeitweise eine Schnittstelle, die anhand von Rufname/Familienname/Geburtsdatum bestmöglich zuordnet.

Wie wird in Zukunft sichergestellt, dass externe Anbieter über Programmänderungen oder Wertelistenupdates informiert werden?

Ein eigener Informationsdienst für externe Entwickler kann aufgrund der begrenzten Ressourcen zum gegenwärtigen Zeitpunkt nicht angeboten werden. Auf der Plattform www.asv.bayern.de wird aber in Kürze eine News Plattform aufgebaut, auf welcher die angefragten Informationen zugänglich sein werden.

Wie wird die Auskunftsberechtigung (bzw. Auskunftssperre) im Export abgebildet?

Das Element <auskunftsberechtigt> ist im XML enthalten, wenn für den jeweiligen Anschriftenreiter das entsprechende Flag in der Datenbank gesetzt ist:

DB: auskunftsberechtigt <> 0 ⇒ XML: auskunftsberechtigt><![CDATA[true]]></auskunftsberechtigt>
DB: auskunftsberechtigt == 0 ⇒ XML: auskunftsberechtigt><![CDATA[false]]></auskunftsberechtigt>

Der Fall DB: auskunftsberechtigt == NULL wird von der Anwendung als auskunftsberechtigte Person interpretiert. Zielsysteme, die den Export nutzen, sollten mit dieser Datenlage daher identisch umgehen.
Diese Konstellation tritt regelmäßig beim Reiter „Schüler“ (Reiter Nr. 3) auf (dort gibt es kein Häkchen für die Auskunftssperre), wird aber von einigen Importschnittstellen auch für andere Reiter so erzeugt. Maßgeblich ist das Verhalten von ASV, siehe oben.

Allgemeine XML-Exportschnittstelle

anonymous@undisclosed.example.com (Anonymous) — Tue, 22 Nov 2016 10:39:43 +0000

Allgemeine XML-Exportschnittstelle

Die Allgemeine XML-Exportschnittstelle ist ein Framework, das - ausgehend von einem umfassenden, baumförmigen Datenmodell mit Querreferenzen - die Schnelle Implementierung von Schnittstellen als Teile des Gesamtbaums erlaubt.

Mit diesem Framework wurden bisher implementiert:

Exportschnittstelle für Verfahren zur Notenverwaltung
Exportschnittstelle für Verfahren zur Mehrarbeitsabrechnung

Amtliche Schulverwaltung - Dokumentation - alle:schnittstellen:xml_sst:xmlexport

Änderungen an der XML-Export-Schnittstelle

Änderungen an der XML-Export-Schnittstelle

Kleinere Änderungen (Umbenennungen)

Änderungen, die im September 2013 nach Rückmeldung durch die Entwickler eingearbeitet wurden:

Folgende Anregungen/Wünsche wurden **nicht** umgesetzt:

XML-Export-FAQ

XML-Export-FAQ

Im Menü "Auswertungen" sind weitere Export-Mechanismen erreichbar; diesen fehlt jedoch ein ID-Feld zur Zuordnung zu Daten aus der XML-Export-Schnittstelle. Ist da noch eine Ergänzung angedacht?

In welcher Form sollen Entwickler die zusätzlich benötigten Datenmerkmale übermitteln?

Wie wird sichergestellt, dass Unterrichtselemente (Oberstufe) einer Klasse/Klassengruppe zugeordnet werden können?

Wie kann mit den Unterrichtselementen des Besonderen Unterrichts verfahren werden bzgl. der Zuordnung Unterrichtselement - Schüler?

In welcher Form wird beim Export der Oberstufenelemente kenntlich gemacht, ob der Unterricht ein normaler Kurs oder Seminar ist?

Was ändert sich an den exportierten Daten durch die Einführung des Oberstufenmoduls in ASV?

Ist das lokale Differenzierungsmerkmal von Schülern aus WinSV auch in ASV und als Merkmal in der Exportschnittstelle verfügbar?

Wie wird in Zukunft sichergestellt, dass externe Anbieter über Programmänderungen oder Wertelistenupdates informiert werden?

Wie wird die Auskunftsberechtigung (bzw. Auskunftssperre) im Export abgebildet?

Allgemeine XML-Exportschnittstelle

Allgemeine XML-Exportschnittstelle

Details zur Schnittstelle

Folgende Anregungen/Wünsche wurden nicht umgesetzt: