XML-Importschnittstelle für extern erfasste Noten von Oberstufenschülern (Dokumentation für ...

anonymous@undisclosed.example.com (Anonymous) — Thu, 26 Sep 2024 21:04:38 +0000

XML-Importschnittstelle für extern erfasste Noten von Oberstufenschülern (Dokumentation für Entwickler)

Die Schnittstelle ermöglicht den Import der Notendurchschnitte der großen und kleinen Leistungsnachweise, des Gesamtschnittes und der Zeugnisnoten sowie der Seminarleistungen aus einem externen Programm nach ASV.

Schnittstellendefinition

Ein Archiv mit Informationen zur Definition der Schnittstelle können Sie hier herunterladen:

Es enthält:

Die XSD-Dateien zur Beschreibung des Importformats,
graphische Veranschaulichungen der XSD-Schemata
sowie eine bespielhafte, XSD-konforme XML-Datei.

Eine Wertelistenübersicht finden Sie im Download-Bereich für externe Anbieter.

Für Rückfragen steht Ihnen zur Verfügung:

Herr Leonhard Fellermayr

Die XML-Schemadefinitionen sowie die enthaltenen Grafiken wurden mit Hilfe von Liquid Studio erstellt.

Changelog

Version	Beschreibung
1.0	Initiale Version, veröffentlicht nur für Entwickler
1.1	Initiale Version mit korrigierter Muster-XML, veröffentlicht nur für Entwickler
3.23.4	Version vom Oktober 2023 (unterstützt G8 und G9; minimale Änderungen für G8 waren erforderlich)
24.4.x	Anpassung des Semester_Notenimport_G9 (Achtung: Erst ab ASV 24.4)

Bitte beachten Sie, dass in der Beispiel-XML bei Sonderfall-Belegungen Korrekturen vorgenommen wurden.

Bei den folgenden Belegungskombinationen müssen beide Fächer als Sonderfall-Belegungen markiert werden:

Geschichte und einstündige Sozialkunde (Sk)
Kunst und Bildnerische Praxis (KuB)
Musik und Instrument (MuI)
Sport und Sporttheorie (S-T)

In diesen Fällen haben die Fächer Sk, KuB, MuI und S-T keine Zeugnisnote.

Wenn ein zweistündiges Sozialkunde belegt wird, wird keine Gesamtnote aus Sozialkunde und Geschichte verrechnet. Die beiden Fächer erhalten in diesem Fall keine Sonderfall-Markierung und jeweils eine eigene Zeugnisnote.

XML-Ausschnitt für G8 bei Belegung von Sport und Sporttheorie (sowohl in 3.23.4, als auch in 24.4.x)

   <Belegung_NotenImport>
            <FachSubGroup>
                <Schluessel_NotenImport>
                    <Schluessel>0400301800</Schluessel>
                </Schluessel_NotenImport>
            </FachSubGroup>
            <Kursdaten>
                <Semester_Notenimport Sonderfall="true">
                    <Nummer>1</Nummer>
                    <Leistung>
                        <Schnitt_Kleine_Leistung>12.50</Schnitt_Kleine_Leistung>
                        <Schnitt_Grosse_Leistung>10.00</Schnitt_Grosse_Leistung>
                    </Leistung>
                    <Unterrichtselement>4028c675-6fe83a4c-0170-60df88a3-1123</Unterrichtselement>
                </Semester_Notenimport>
                <Semester_Notenimport Sonderfall="true">
                    <Nummer>2</Nummer>
                    <Leistung>
                        <Schnitt_Kleine_Leistung>12.00</Schnitt_Kleine_Leistung>
                        <Schnitt_Grosse_Leistung>10.00</Schnitt_Grosse_Leistung>
                    </Leistung>
                    <Unterrichtselement>4028c675-6fe83a4c-0170-60df88a3-1123</Unterrichtselement>
                </Semester_Notenimport>
            </Kursdaten>
   </Belegung_NotenImport>
   <Belegung_NotenImport>
            <FachSubGroup>
                <Schluessel_NotenImport>
                    <Schluessel>0400300400</Schluessel>
                </Schluessel_NotenImport>
            </FachSubGroup>
            <Kursdaten>
                <Semester_Notenimport Sonderfall="true">
                    <Nummer>1</Nummer>
                    <Leistung>
			<Schnitt_Kleine_Leistung>9.00</Schnitt_Kleine_Leistung>
                        <Schnitt_Gesamt>9.00</Schnitt_Gesamt>
			<Note>10</Note>
                    </Leistung>
                    <Unterrichtselement>4028c675-6fe83a4c-0170-60df88a3-1da1</Unterrichtselement>
                </Semester_Notenimport>
                <Semester_Notenimport Sonderfall="true">
                    <Nummer>2</Nummer>
                    <Leistung>
			<Schnitt_Kleine_Leistung>11.00</Schnitt_Kleine_Leistung>
                        <Schnitt_Gesamt>11.00</Schnitt_Gesamt>
			<Note>11</Note>
                    </Leistung>
                    <<Unterrichtselement>4028c675-6fe83a4c-0170-60df88a3-1da1</Unterrichtselement>
                </Semester_Notenimport>
            </Kursdaten>
    </Belegung_NotenImport>

XML-Ausschnitt für G9 bei Belegung von Leistungsfach Sport (FTU: ''ff808181-91e1d8a3-0192-2eec7a1b-5c84'', FPU: ''ff808181-91e1d8a3-0192-2eec7a1b-5cb5'')

(FTU = fachtheoretischer Unterricht; FPU = fachpraktischer Unterricht)

Bitte beachten Sie, dass in Fächern, deren Zeugnisnote sich aus der Teilnahme an zwei verschiedenen Unterrichtselementen zusammensetzt, die bereits verrechnete Zeugnisnote jeweils nur einmal pro Semester geliefert werden darf. Es ist nicht relevant, in welchem der beteiligten Semester_Notenimport_G9-Elemente diese enthalten ist. Sofern entgegen dieser Vereinbarung jedoch mehrere Zeugnisnoten für das gleiche Semester geliefert werden, wird die erste im XML enthaltene Zeugnisnote eingebucht und alle weiteren verworfen.

<Belegung_NotenImport_G9>
	<FachSubGroup>
		<Schluessel_NotenImport>
			<Schluessel>0400300400</Schluessel>
		</Schluessel_NotenImport>
	</FachSubGroup>
	<Kursdaten>
		<Semester_Notenimport_G9>
			<Nummer>1</Nummer>
			<Leistung>
				<Schnitt_Kleine_Leistung>9.87</Schnitt_Kleine_Leistung>
				<Schnitt_Grosse_Leistung>1.32</Schnitt_Grosse_Leistung>
				<Schnitt_Gesamt>5.59</Schnitt_Gesamt>
				<Note>5</Note>
				<Belegungsart>1038_30</Belegungsart>
			</Leistung>
			<Unterrichtselement>ff808181-91e1d8a3-0192-2eec7a1b-5c84</Unterrichtselement>
		</Semester_Notenimport_G9>
		<Semester_Notenimport_G9>
			<Nummer>2</Nummer>
			<Leistung>
				<Schnitt_Kleine_Leistung>12.9</Schnitt_Kleine_Leistung>
				<Schnitt_Grosse_Leistung>14.93</Schnitt_Grosse_Leistung>
				<Schnitt_Gesamt>13.91</Schnitt_Gesamt>
				<Note>13</Note>
				<Belegungsart>1038_30</Belegungsart>
			</Leistung>
			<Unterrichtselement>ff808181-91e1d8a3-0192-2eec7a1b-5c84</Unterrichtselement>
		</Semester_Notenimport_G9>
	</Kursdaten>
</Belegung_NotenImport_G9>
<Belegung_NotenImport_G9>
	<FachSubGroup>
		<Schluessel_NotenImport>
			<Schluessel>0400300400</Schluessel>
		</Schluessel_NotenImport>
	</FachSubGroup>
	<Kursdaten>
		<Semester_Notenimport_G9>
			<Nummer>1</Nummer>
			<Leistung>
				<Schnitt_Kleine_Leistung>14.36</Schnitt_Kleine_Leistung>
				<Schnitt_Gesamt>11.83</Schnitt_Gesamt>
				<Schnitt_Praktische_Leistung>14.76</Schnitt_Praktische_Leistung>
				<Belegungsart>1038_30</Belegungsart>
			</Leistung>
			<Unterrichtselement>ff808181-91e1d8a3-0192-2eec7a1b-5cb5</Unterrichtselement>
		</Semester_Notenimport_G9>
		<Semester_Notenimport_G9>
			<Nummer>2</Nummer>
			<Leistung>
				<Schnitt_Kleine_Leistung>9.22</Schnitt_Kleine_Leistung>
				<Schnitt_Gesamt>7.47</Schnitt_Gesamt>
				<Schnitt_Praktische_Leistung>6.07</Schnitt_Praktische_Leistung>
				<Belegungsart>1038_30</Belegungsart>
			</Leistung>
			<Unterrichtselement>ff808181-91e1d8a3-0192-2eec7a1b-5cb5</Unterrichtselement>
		</Semester_Notenimport_G9>
	</Kursdaten>
</Belegung_NotenImport_G9>

Amtliche Schulverwaltung - Dokumentation - alle:schnittstellen:xml_sst:notenimport:doku_fuer_externe