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 stehen von Seiten des StMUK zur Verfügung:

• Matthias Gold matthias.gold@stmuk.bayern.de
• Leonhard Fellermayr leonhard.fellermayr@stmuk.bayern.de

• In der Importdatei können Noten zu beliebig vielen Zeugnisarten beliebig vieler Schüler beliebig vieler Schulen enthalten sein.
• Zu jedem Zeugnis können auch Informationen zum Erreichen des Ziels der Jahrgangsstufe und zur Gefährdung (Zwischenzeugnis!) in der Importdatei enthalten sein.
• Die Identifikation der Schüler geschieht entweder (vorzugsweise!) über Angabe des lokalen Differenzierungsmerkmals oder über gleichzeitige die Angabe folgender vier Merkmale des Schülers:
  • Familienname
  • Rufname
  • Geburtsdatum
  • Geschlecht
• Kann die Schnittstelle einen Schüler und die angegebene Zeugnisart identifizieren, so löscht sie zunächst alle Noten des Schülers zur angegebenen Zeugnisart und schreibt dann die in der Importdatei angegebenen Noten in die Datenbank.

Die Schnittstelle erwartet eine XML-Datei mit festgelegtem Format. In der hier herunterladbaren Entwicklerdokumentation, Stand 29.04.2024 finden Sie

• Die XSD-Datei Zeugnisnotenimport_xxx.xsd zur Beschreibung der akzeptierten Struktur
• Ein Zip-Archiv Zeugnisnotenimport_Wertelisten_xxx.zip mit allen benutzten Wertelisten im HTML-Format
• Eine Beispieldatei Schülerstammdatenimport Beispiel-Importdatei_Zeugnisnoten.xml, die schulisch zwar keinen Anspruch auf Korrektheit erhebt, aber auf einfache Art klärt, wie Header/Kodierung/Struktur einer zulässigen XML-Datei aussehen könnten.

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>

Ein gültiges Element für die Importdatei wäre also

<ziel_jgst_vorjahr>50</ziel_jgst_vorjahr>

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>