Version 0.26: Für FOSBOS wurden die beiden optionalen XML-Elemente sonderfall
und einbringung
vorgesehen.
Beschreibung | Feldname im XML | Beschreibung und Wertebereich |
---|---|---|
Leistungsverweigerung | sonderfall | FOSBOS erfordert die Angabe, ob HJ-Leistungen wegen Leistungsverweigerung 0 Punkte haben, was zur Nicht-Zulassung zum Abitur führt. sonderfall == 0 oder leer: normale Leistung ohne Leistungsverweigerung sonderfall == 1 bedeutet, dass der Schüler die Leistung verweigert hat. |
Notengewicht | einbringung | FOSBOS DBFH-Bildungsgänge können im Abschnitt 3/2 HJ-Leistungen einfach oder doppelt gewichtet einbringen. einbringung == 0: keine Einbringung einbringung == 1: (normale einfach gewichtete) Einbringung einbringung == 2: doppelt gewichtete Einbringung (nur für DBFH möglich) |
In der Version 0.25 der Importschnittstelle wird das Element <belegart> als Unterelement des XML Knoten <Note> hinzugefügt. Wenn Zeugnisnoten importiert werden und keine Belegart vorhanden ist, wird der Defaultwert der Datenbank (13 entspricht Pflichtunterricht) eingebucht. Durch diese Erweiterung ist es nun möglich, unter anderem die Noten des Projekt-Seminars zur beruflichen Orientierung (11. Jahrgangsstufe) am Gymnasium über die Importschnittstelle zu importieren.
Hier finden Sie eine Anleitung für die Schulen zur Benutzung der Schnittstelle in ASV.
Für technische Unterstützung und Feedback steht Ihnen von Seiten des StMUK zur Verfügung:
Die Schnittstelle erwartet eine XML-Datei mit festgelegtem Format. In der hier herunterladbaren Entwicklerdokumentation, Stand 08.10.2024 finden Sie
Die Schnittstelle akzeptiert auch in Zip-Archive gepackte und per AES verschlüsselte Dateien (Dateiendung: .zip). Innerhalb des Zip-Archivs muss sich eine XML-Datei (Endung: .xml) befinden, die die Importdaten enthält.
Erfolgreich getestet wurden bereits Archive, die mit
erstellt wurden.
Falls sich das Passwort für das Zip-Archiv in der Zwischenablage befindet, erkennt dies die Importschnittstelle und verzichtet auf die Passwortabfrage.
Im Interesse des praktischen Datenschutzes möchten wir Sie nachdrücklich darum bitten, nur verschlüsselte zip-Archive zu exportieren. Die Passwörter sollten zufällig generiert und am Bildschirm angezeigt werden. Falls sie zudem automatisch in die Zwischenablage kopiert werden, vereinfacht dies das Vorgehen für die Programmbenutzer (vorausgesetzt, der ASV-Client und die exportierende Software befinden sich auf einem Rechner).
Die Kardinalität der XML-Elemente ersehen Sie in der XSD-Datei durch die Angaben minOccurs
und maxOccurs
, beispielsweise
<element name="schule" minOccurs="0" maxOccurs="unbounded">
Insbesondere werden Pflichtelemente gekennzeichnet durch minOccurs=„1“
.
Die in der XML-Datei akzeptierten Datentypen werden als <restriction>
-Elemente im XSD formuliert, beispielsweise
<restriction base="string"> <pattern value="\d\d\d\d"></pattern> </restriction>
für eine vierstellige Schulnummer,
<restriction base="string"> <maxLength value="32"></maxLength> </restriction>
für längenbeschränkten Text,
<restriction base="string"> <pattern value="(true|false)"></pattern> </restriction>
für einen booleschen Wert oder
<restriction base="string"> <pattern value="(0[1-9]|[12][0-9]|3[01])\.(0[1-9]|1[012])\.(19|20)\d\d"></pattern> </restriction>
für einen Datumswert.
Referenzen auf Werte aus ASV-Wertelisten haben in der XSD-Datei folgende Form:
<element name="ziel_jgst_vorjahr" minOccurs="0" maxOccurs="1"> <annotation> <appinfo> <werteliste plkey="2185">Klassenziel</werteliste> </appinfo> <documentation><![CDATA[Information über das Erreichen des Ziels der Jahrgangsstufe im Vorjahr]]></documentation> </annotation> <simpleType> <restriction base="string"> <maxLength value="40"></maxLength> </restriction> </simpleType> </element>
Hieraus ist ersichtlich, dass in der Importdatei ein Wert aus der Werteliste Klassenziel
(Wertelistennummer: 2185
) erwartet wird. Sie finden die vollständige Werteliste im Wertelistenverzeichnis (Schuelerstammdatenimport_Wertelisten_xxx.zip
) in der Datei Klassenziel_(2185).xml
.
Ein Beispieleintrag in der Werteliste (nicht in der Importdatei!) sieht so aus:
<eintrag> <schluessel><![CDATA[50]]></schluessel> <kurzform><![CDATA[e]]></kurzform> <anzeigeform><![CDATA[Klassenziel erreicht]]></anzeigeform> <langform><![CDATA[Ziel der Jahrgangsstufe erreicht]]></langform> <bemerkung><![CDATA[#kuerzel_alt=50#nicht BS/BSF]]></bemerkung> <schulart_schluessel><![CDATA[04]]></schulart_schluessel> <schulart_kurzform><![CDATA[GY]]></schulart_kurzform> <schulart_anzeigeform><![CDATA[Gymnasium]]></schulart_anzeigeform> </eintrag>
In der XML-Importdatei wird von diesem Eintrag nur der Wert des Feldes schluessel
erwartet.
Ein gültiges Element für die Importdatei wäre also
<ziel_jgst_vorjahr>50</ziel_jgst_vorjahr>
Bitte achten Sie darauf, nur Werte zu übermitteln, die zur Schulart der importierenden Schule passen. Der obige Wert 50
in der Werteliste Klassenziel
passt beispielsweise zur Schulart Gymnasium (siehe obigen Eintrag).
Natürlich kann ein Schlüsselwert zu mehreren Schularten passen. Zu welchen, ersehen Sie aus der XML-Datei, die die Werteliste enthält.
Schulfachliche Dokumentation ist in der XSD-Datei in <documentation>
-Elementen abgelegt, beispielsweise
<element name="auswaertige_unterbringung" minOccurs="0" maxOccurs="1"> <annotation> <documentation><![CDATA[Gastschulverhätlnis: auswärtige Unterbringung notwendig? Nur anzugeben für Gastschüler bzw. Umschüler! Für den Besuch der Berufsschule ist eine auswärtige Unterbringung gemäß Art. 10 Abs.8, Art. 20 Abs. 1 oder Art. 37 BaySchFG notwendig .]]> </documentation> </annotation> <simpleType> <restriction base="string"> <pattern value="(true|false)"></pattern> </restriction> </simpleType> </element>