X1 Grundlagen für Drittprogramme und Entwickler

Für die Übermittlung der AP sind Halbjahresleistungen, AP-Leistungen und berechnete Gesamt- und Prüfungsergebnisse nötig. Die Bereitstellung erfolgt gruppiert nach Fach, wobei ein Fach n Prüfungsteile enthalten kann. Das Fachreferat und oder Seminar muss als eigenes, ggf. zusätzliches Fach mit nur einem Prüfungsteilschlüssel vorliegen.

In ASV können die für eine AP nötigen Leistungen folgendermaßen erfasst werden:

Die Abschlussprüfung in ASV setzt sich aus Halbjahresleistungen (= Zeugnisnoten) und Abschlussprüfungsleistungen zusammen. Es gibt zwei grunsätziliche Varianten, wie man die Daten importieren kann. Egal welchen Weg man wählt, ist danach immer die Tabelle der Zeugnisnoten und die der Abschlussprüfungsleistungen befüllt.

Der Import der Zeugnisnoten = Halbjahresleistungen kann auf zwei unterschiedliche Wege erfolgen:

• Variante 1
  • Nutzung Import Zeugnisnoten (importiert in die ASV > Schüler > Reiter Zeugnisnoten)
  • dann können beim Import der AP-Leistungen die Prüfungsteile mit den Schlüsseln (1243_xx, siehe Tabelle unten, z.B. 1243_452, 1243_474) weggelassen werden, die für das Zeugnis bestimmt sind.
• Variante 2
  • keine Nutzung vom Import Zeugnisnoten
  • dann müssen beim Import der AP-Leistungen ALLE Prüfungsteile übergeben werden. Also sowohl die mit eimem Schlüssel für die AP-Leistungen (z.B. 1243_414) als auch die für Zeugnisse (z.B. 1243_452) - siehe Punkt 4) auf dieser Seite

Grundlage dieses Imports ist die Dokumentation für Entwickler. Übergeben werden neben den Abschlussprüfungs-Schüler-Objekten Prüfungsteile. Über den Prüfungsteilschlüssel wird gesteuert, ob eine Leistung als Zeugnisnote , Abschlussprüfungsleistung oder berechnetes Prüfungs- und Gesamtergebnis ankommt.

Alle technisch nötigen Informationen finden Sie hier: Entwickler.

Alle für die FOSBOS nötigen fachlichen Informationen sind in folgendem Abschnitt dargestellt:

Eintrag laut XSD	Beispiel	Anmerkung
Datenpaket.Schulinformation
Schulnummer	1234	Amtliche Schulnummer
Schulart	1152_52 = FOSBOS 1152_27 = FOF	Keine Trennung in BOS und FOS mehr
Datenpaket
Schuljahr	SCHULJAHR_2025	2025 steht für 2025/26 Halbjahresleistungen müssen im korrekten Schuljahr verbucht sein, also z.B. für die FOS12 in 2025/26 und die FOS11 in 2024/25.
Pruefungsart	064 = Fachabitur 074 = Abitur	Abitur umfasst fachgebundenes und allgemeines Abitur; die Erkennung, ob ein Abitur vorliegt, erfolg automatisch über den Fremdsprachennachweis als Prüfungsteil
Datenpaket.Schueler.Person
Rufname	Katharina
Familienname	Tanner
LDM	p21f44bmls	Lokales Differenzierungsmerkmal Schüler laut ASV
SchuelerStatus	1330_20 = Stammschüler 1330_21 = anderer Bewerber	Stammschüler ist der Regelfall
Datenpaket.Schueler
Gesamtpunktzahl	213	Errechnete, gerundete ganzzalige Punktesumme
Gesamtnote	2,9	Errechnete, gerundete Gesamtnote als Dezimalzahl, eine Vor- und Nachkommastelle mit Komma
Pruefungsstatus optional*	1139_10 = Nicht zugelassen 1139_15 = zugelassen 1139_15 = nicht bestanden 1139_30 = bestanden	Prüfungsstatus des Schülers als Gesamturteil
Datenpaket.Schueler.Einzeldaten.BasePruefungsteil (= für Abschlussprüfungsleistungen = Abiturnoten und berechnete Prüfungs- und Gesamtergebnisse)
Note	12 3	Punktezahl [0-15], kein Text, keine Sonderzeichen, auch kein -
Schuelerfach	00155db3/dc06/18d1ce67/8b6/1e475	Technische Datensatz-ID für das Schülerfach zu einem Unterrichtsfach. Ist nötig, da die AP-Prüfungsteile im Schüler-Kontext geliefert werden müssen. Schülerfächer können durch vorherigen Export der AP-Daten ermittelt, im Drittprogramm verarbeitet und dann mit dem Drittprogramm korrext für diese Schnittstelle exportiert werden.
Teil	1243_414 = schriftlich 1243_418 = mündlich 1243_490 = Prüfungsergebnis 1243_491 = Gesamtergebnis	siehe Tabelle zu Prüfungsteil weiter unten; Beispiel „1243_414“ kennzeichnet z.B. eine schriftliche Abiturleistung. Neben schriftlichen und mündlichen Prüfungsleistungen - das gilt auch für die anderen Bewerber - muss in (Fach)Abitur-Prüfungsfächern zusätzlich das errechnete Prüfungsergebnis mit übermittelt werden. Bei jedem Fach, auch eines wo kein Abitur geschrieben wird, muss das berechnete Gesamtergebnis mit übergeben werden.
Datenpaket.Schueler.Einzeldaten.ExtendedPruefungsteil (= für Halbjahresleistungen = Zeugnosnoten, eingebracht und nicht-eingebracht)
Note	12 3	Punktezahl [0-15], kein Text, keine Sonderzeichen, auch kein - wenn keine Leistung vorliegt, ist dieser Datensatz nicht an den Import zu übergeben
SchuleFach	297eb771-920e8584-0192-0e912ec7-10de	Technische Datensatz-ID für das SchuleFach zu einem Unterrichtsfach. Unterschied ist, dass ein SchuleFach einen Schuljahreskontext hat. Es ist nötig, da die Zeugnisnoten im SchuleFach-Kontext geliefert werden müssen. SchuleFächer können durch vorherigen Export der AP-Daten ermittelt, im Drittprogramm verarbeitet und dann mit dem Drittprogramm korrext für diese Schnittstelle exportiert werden. SchuleFächer sind pro Schule = pro Schulnummer unterschiedlich.
Teil	Auszug: 1243_430 = fpA 11/1 1243_432 = Fachreferat 1243_451 = nicht eingebr. 11/2 1243_452 = eingebracht 12/1	siehe Tabelle zu Prüfungsteil weiter unten; hier dürfen keine Schlüssel eines AP-Prüfungsteils übergeben werden (1243_ 414, 418, 490, 491), da hier nur Zeugnisnoten erwartet werden. Wichtig ist, dass sowohl die eingebrachten als auch nicht-eingebrachten Halbjahresleistungen übergeben werden müssen. ABER: es sind nur die HJ-Leistungen zu übergeben, welche für den in diesem Schuljahr erstrebten Abschluss relevant sind. Beispiel: Für FOSBOS13 nur die HJ-Leistungen aus Jgst. 13 und nicht die, eventuell vorhandenen aus VKL, Jgst. 11 und Jgst. 12.
Belegart	1038_13 = Pflichtunterricht 1038_26 = WahlpflichtUnt. 1038_34 = Seminar 1038_35 = Fachreferat	Zu jedem Element muss die Belegart übergeben werden; Profilfächer sind als Pflichtunterricht zu verbuchen. Wahlunterricht ist ohnehin nicht zu importieren. Seminar und Fachreferat sind hier mit einer eigenen Belegart zu kennzeichnen - zusätzlich zum eigenen Prüfungsteil-Schlüssel 1243_432 und _433 (siehe oben).
Zeugnisart	(1198_01 = Zwischenzeugnis) 1198_25 = Jahreszeugnis (1198_40 = Bescheinigung) 1198_51 = HJ-Leistung VKL/1 1198_52 = HJ-Leistung VKL/2 1198_58 = HJ-Leistung 13/1 1198_59 = HJ-Leistung 13/2 1198_76 = HJ-Leistung 11/1 1198_77 = HJ-Leistung 11/2 1198_78 = HJ-Leistung 12/1 1198_79 = HJ-Leistung 12/2	Das Zwischenzeugnis und die Bescheinigung sind für den AP-Import nicht relevant. Die Verwaltung der einzelnen Zeugnisnoten erfolgt auf Basis der HJ-Leistungen, auch bei der Vorklasse. Ausnahme: bei Fachreferat und Seminar muss die Zeugnisart 1198_25 = Jahreszeugnis verwendet werden. FpA nutzt die Schlüssel für 11/1 und 11/2.
Jahrgangsstufe	JAHRGA_997 = Vorklasse JAHRGA_111 = Jgst. 11 JAHRGA_121 = Jgst. 12 JAHRGA_131 = Jgst. 13	Die Jahrgangsstufe muss der Realität entsprechen. Auch bei Wiederholern muss die Jgst. korrekt sein.
Einbringung	0 = nicht eingebracht 1 = eingebracht 2 = Doppeleinbringung (DBFH)	Die Information der Einbringung muss sowohl hier als auch mittelbar über den Prüfungsteil-Schlüssel 1243_xx erfolgen. Für DBFH kann ein Fach mit zweifacher Gewichtung eingebracht werden.
Schuljahr	SCHULJAHR_2025	2025 steht für 2025/26 Halbjahresleistungen müssen im korrekten Schuljahr verbucht sein, also z.B. für die FOS12 in 2025/26 und die FOS11 in 2024/25.
Sonderfall	false = Normalfall true = Leistungsverweigerung	Übergabe eines Boolean-Wertes, wobei dieser immer false lautet, außer der Schüler hat die Leistungs verweigert, dann wird true gesetzt. Die Leistungsverweigerung, z.B. im Fachreferat, hat die Nicht-Zulassung zum Fachabitur zur Folge.

Schlüssel der Werteliste Prüfungsteil 1243

*optionale Werte werden von ASV berechnet, wenn diese nicht übergeben wurden.

Die unter 2) beschriebenen Varianten führen dazu, dass Leistungen unterschiedlich importiert werden. Folgende Tabelle zeigt, welche einzelnen Prüfungsteile beim Import der AP-Leistungen übergeben werden müssen.

Beachten Sie, dass in jedem der beiden Varianten, Einträge für Prüfungsergebnis (alle Fächer mit mündlicher und oder schriftlicher Prüfung) und Gesamtergebnis (jedes Fach) vorhanden sein müssen.

Diese Auflistung sammelt besondere Hinweise:

• das Jahreszeugnis Vorkurs (VII.1) benötigt keine HJ-Leistungen als Zeugnisart, sondern die Zeugnisart „Jahreszeugnis“ (Schlüssel 25)

Zurück zur AP-Übersicht