Version vom 12. Juli 2018, 20:26 Uhr

Diese Seite enthält eine Linksammlung und dient der Informationsweitergabe an kommerzielle Anbieter und Schulen, die kein kommerzielles Produkt verwenden.

Ziel der Schnittstelle zwischen komm. Produkt und SaxSVS-BBS

Die berufsbildenden Schulen in Sachsen haben meistens ein komm. Produkt im Einsatz. Da in SaxSVS nicht alle Bereiche abgedeckt werden können, soll eine Schnittstelle eine doppelte Eingabe der Schülerdaten überflüssig machen. Die Schnittstelle basiert auf festgelegten Schlüsseln, die an die amtliche Schulstatistik Phönix angelehnt sind.

Linksammlung

Muster der Schülermasken in SaxSVS-BBS: http://saxsvs-bbs.de/index.php/Schuelerdaten
Schnittstelleninformationen (Schlüssel und Bildungsgänge): https://web1.extranet.sachsen.de/bbsp/public/schnittstellen/
Einrichtungsregister: https://schuldatenbank.sachsen.de/xml/einregister_komplett_saxsvs.xml
BSCW-Server (Ablage von Dokumenten, Präsentationen, Musterdateien und Tools): https://bscw.sachsen.schule/bscw/bscw.cgi/3193184
XML-Schema: (07.12.2017: neues Schema)

Ausbaustufen/Zeitplan

bis Februar 2018:

Pflichtfelder laut Schema und die Äste "foerderung" und "migration"

März 2018

Test durch AG-Leiter und in einer Musterschule

April 2018

Übergabe der aktuellen Version des komm. Produktes an die Schulen

April bis Juli 2018

Einlesen der Schülerdaten - Test und falls erforderlich Anpassung der Schülerdaten im komm. Produkt

August bis Oktober

Nutzung der Schnittstelle für den 2. Stichtag

Parallel dazu erfolgt die Programmierung der restlichen Felder und der Test der vollumfänglichen Schnittstelle durch die komm. Anbieter und der Test durch den AG-Leiter.

Ende Oktober 2018

Übergabe der vollumfänglichen Version des komm. Produkts und Bedienung der kompletten Schnittstelle

ab Oktober 2018

erneutes Übertragen der Schülerdaten und falls erforderlich, Anpassung der Daten im komm. Produkt

Beschreibung der Schnittstelle

In der Schnittstelle müssen alle Datenfelder der Schülerdaten sein, die für die Planung, die Schulpflichtüberwachung und die amtliche Schulstatistik erforderlich sind. Diese Daten müssen:

teilweise mit einer gültigen Zeitscheibe oder für das Schuljahr abgelegt werden.
gültige Schlüssel und Schlüsselwerte enthalten
gültige Bildungsgänge enthalten

Absolvieren Schüler nach einer ersten Ausbildung mit Abschluss eine weitere Ausbildung, muss der Schülerdatensatz für die zweite Ausbildung kopiert (mit neuer UUID) und darf nicht nur verändert werden. Nur so ist es möglich, den Abschluss der ersten Ausbildung für die amtliche Schulatatistik zu nutzen.

schuljahresbezogene Daten

Für das Einlesen der Daten muss eine gültige Zeitscheibe übertragen werden. Die Datenübertragung muss schuljahresbezogen erfolgen. Wird kein "von_Datum" und "bis_Datum" in der Schnittstelle bei den dafür vorgesehenen Feldern übertragen, gilt der Wert grundsätzlich für das ganze Schuljahr. Bei jeder Übertragung in SaXSVS werden die Daten übertragen, auf Gültigkeit lt. xml-Schema getestet und danach eingelesen. Sind Daten nach dem Schema nicht gültig, wird die Datei abgelehnt und es wird eine detaillierte Fehlermeldung ausgegeben. Die Daten müssen danach im komm. Produkt angepasst und erneut übertragen werden. Der Abgleich findet immer über eine UUID statt. Damit können Schülerdaten auch mehrmals abgeglichen werden.

aktuelles Schuljahr

Datenfluss komm. Produkt --> SaxSVS-BBS:
Das komm. Produkt dient als primäres Arbeitsmittel in den Schulen. In SaxSVS werden die Daten für die Planung und Schulpflichtüberwachung benötigt. Dazu ist es erforderlich, alle Schülerdaten zu übertragen.

Datenfluss SaxSVS-BBS --> komm. Produkt:
Wenn Schüler die Schule wechseln (auch innerhalb des Schuljahres), sollen die Schülerdaten in der ankommenden Schule nicht erneut eingegeben werden. Die Schule wechselt in SaxSVS bei dem Schüler die Stammschule und am Folgetag ist der Schüler Stammschüler der neuen Schule. Die abgebende Schule muss parallel dazu im komm. Produkt die Laufbahn des Schülers in der abgebenden Schule beenden. Die Folgeschule hat den Datensatz nun in SaxSVS und kann ihn aus SaxSVS exportieren und in das komm. Produkt importieren.

Folgeschuljahr

Datenfluss komm. Produkt --> SaxSVS-BBS:
Bereits im komm. Produkt angelegte Schüler für das Folgeschuljahr (bspw. für das Bewerberverfahren) werden in SaxSVS nicht benötigt, deshalb ist eine Datenübertragung hierfür nicht erforderlich.

Datenfluss SaxSVS-BBS --> komm. Produkt:
Einige Schüler wechseln innerhalb der Ausbildung die Berufsschule. Durch das SMK wird jedes Jahr erneut festgelegt, welche Ausbildung an welcher Schule stattfindet. Nach der ortsnahen Grundausbildung im ersten Jahr findet häufig die Fachausbildung konzentriert an wenigen Standorten statt. Da Schüler nur einmal im System sein dürfen, werden diese am Ende des Schuljahres an die neue Schule mit einer Zeitscheibe im Folgeschuljahr eingegeben. Die Daten können somit bereits im 2. Schulhalbjahr von der Folgeschule aus SaxSVS exportiert werden und sollen bereits in das komm. Produkt importiert werden können, damit bereits am Schuljahresende bspw. Klassenlisten für das Folgeschuljahr erstellt werden können.

letztes Schuljahr

Datenfluss komm. Produkt --> SaxSVS-BBS:
Über SaxSVS sollen zukünftig auch die Tabellen der amtlichen Schulstatistik Phönix gefüllt werden. Benötigt werden dazu auch die Abschlüsse der Abgangsklasssen des letzten Schuljahres. Da diese Daten oft erst im September vorliegen und im komm. Produkt gepflegt werden können, muss eine Datenübertragung der Schüler des abgelaufenen Schuljahres möglich sein.

Datenfluss SaxSVS-BBS --> komm. Produkt:
Diese Datenübertragung wird nicht benötigt und ist deshalb nicht vorgesehen.

Daten in der Schnittstelle

Kategorie der Datenfelder

Grundlage für eine erfolgreiche Datenübertragung ist die Einhaltung des XML-Schemas. In der abgelegten xsd-Datei gibt es folgende Bereiche:

Pflichtfelder

Diese werden benötigt, um den Schüler eindeutig einer Klasse und einer Ausbildung zuzuordnen.

Felder, die als Grundlage für den Bedarf erforderlich sind

Merkmale der Äste "foerderung" und "migration" erzeugen einen Bedarf, der bei der Schulaufsicht zusätzlich zum Unterricht beantragt wird

alle anderen Felder der Schnittstelle

Diese werden für die Schulpflichtüberwachung und amtliche Schulstatistik benötigt.

Schüler mit dem Archivbit (archiv_schueler)

Dieses Merkmal dient dazu, früher übertragene Schüler wieder in SaxSVS zu löschen (bspw. bei Abbruch der Ausbildung)

Verarbeitung der Daten in SaxSVS laut Schema

Für die eindeutige Zuordnung der Schüler müssen alle Pflichtfelder vorhanden und valid sein. Damit auch alle anderen Schülermerkmale immer valid sind, gilt folgende Festlegung:

ein Tag mit Inhalt ersetzt in SaxSVS den bisherigen Eintrag
ein nicht vorhandener Tag (bezogen auf die xsd-Datei) löscht den bisherigen Inhalt des Feldes in SaxSVS
ein leerer Tag ist nicht erlaubt

Löschen eines Schülers nach der Ausbildung

Ein Schüler verlässt aus unterschiedlichen Gründen eine Schule.

Fall1 (Normalfall):

Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Der Abschluss war erfolgreich. Der Abschluss dieses Schülers wird im Oktober 2018 für die amtliche Schulstatistik benötigt. Wir blicken deshalb auf das letzte Schuljahr zurück und zählen den Abschluss. Die Pflege des Abschlusses kann im Juli 2018 erfolgen. Der Schüler muss also im Oktober exportiert werden (aber für das vergangene Schuljahr). Deshalb muss die Schule einstellen können, für welches Schuljahr der Schüler exportiert werden soll. Im Oktober 2018 darf er nicht mehr für das Schuljahr 2018/2019 im Export sein, weil der Schüler ja da die Schule schon verlassen hat.

Fall2 (selten, aber möglich):

Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Der Abschluss in der Berufsschule war erfolgreich, er ist allerdings durch die Facharbeiterprüfung gefallen. Damit muss der Abschluss im komm. Produkt wieder gelöscht werden, weil bei einer Lehrverlängerung die Schulberechtigung wieder da ist, der Schüler besucht noch ein halbes Jahr (bis zur nächsten Facharbeiterprüfung) die Schule. Dann besteht der Schüler die Prüfung und er bekommt jetzt den Abschluss der Schule. Das heißt also, dass die Schule ein evtl. im Juli eingegebenen Abschluss im September rückwirkend wieder löschen muss und im Februar 2019 wieder einträgt (allerdings dann im Schuljahr 2018/2019).

Fall3 (selten, aber möglich)

Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Allerdings verkürzt er durch gute Leistungen und einen Antrag die Lehre um ein halbes Jahr. Damit wird das Zeugnis schon im Februar 2018 erstellt und der Schüler muss dann trotzdem bei der amtlichen Schulstatistik gezählt werden.

Für die Fälle1, 2 und 3 darf das Archivbit der Schnittstelle nicht gesetzt werden, welches das Löschen des Schülers in SaxSVS bedeutet. Der Schüler wird nicht in die Datenbank von SaxSVS des Folgeschuljahres übertragen, wenn das Abschlussdatum im aktuellen Schuljahr liegt. Nach der amtlichen Schulstatistik im Oktober werden die Datensätze bereinigt und die Schüler in SaxSVS gelöscht. Die gesetzlich vorgeschriebene Archivierung erfolgt nicht in SaxSVS, sondern im täglichen Arbeitsinstrument (also im komm. Produkt).

Fall4 (selten, aber möglich)

Der Schüler wird in der Probezeit entlassen und bekommt damit keinen Abschluss, bei Umzug in ein anderes Bundesland ist der Vorgang analog. Bei der amtlichen Schulstatistik werden nur positive Abschlüsse gezählt. Dieser Schüler hat keinen und ist damit im laufenden Schuljahr und Folgeschuljahr nach Beendigung der Schulzeit für SaxSVS uninteressant. Damit der Schüler nicht im komm. Produkt und in SaxSVS durch die Schule gelöscht werden muss, soll dieser Schüler ein Archivbit bekommen (bspw. durch eine Schaltfläche „Schüler in SaxSVS löschen“). Damit ist gewährleistet, dass die Anzahl der Schüler in einer Klasse im komm. Produkt und in SaxSVS immer gleich ist. Angedacht ist, diese Daten einmal pro Monat abzugleichen.

Gültigkeit der Daten

Durch das Schema werden nur allgemeine Festlegungen der Datenstruktur geprüft. Bildungsgänge, Schlüssel und Adressen werden nicht durch das Schema validiert, sondern erst beim Import der Daten in SaxSVS selbst. Dadurch ist bei einer Änderung dieser Daten gewährleistet, dass nach Änderungen kein neues Schema erstellt werden muss.

Schlüssel

Schlüssel werden selten angepasst. Trotzdem kann es sein, dass bei benutzten Schlüsseln weitere Schlüsselwerte erforderlich sind. Die Schlüsseldatei wird jede Nacht neu generiert und zur Verfügung gestellt. s. Pkt. 2, (2)

Bildungsgänge

Eine Anpassung der Liste aller Bildungsgänge kann mehrmals im Schuljahr erfolgen. Auch wenn die meisten Ausbildungen fortgeführt werden, muss teilweise eine Anpassung der erfolgen.
Neue Kennziffern (neue Bildungsgänge) sind erforderlich bei:

neuen Ausbildungen
Umbenennungen von Bildungsgängen

Wenn die Ausbildung neu organisiert wird, laufen oftmals die bisherigen Bildungsgänge aus und die neuen Bildungsgänge werden jahrgangsweise eingeführt.

Für die Nutzung gelten folgende Regeln:

Es werden keine Bildungsgänge im Export gelöscht.
Jeder Bildungsgang enthält eine gültige Zeitscheibe.
Da das Anlegen und Übertragen der Schüler im komm. Produkt erst nach Anlegen der Bildungsgänge in SaxSVS erfolgt, nutzen die Schulen im komm. Produkt nur gültige Kennziffern (Bildungsgänge). Die Überwachung der Gültigkeit erfolgt beim Übertragen der Schüler in SaxSVS.
Jede Nacht wird der Export der Bildungsgänge neu generiert und zur Verfügung gestellt. s. Pkt. 2, (2)

weitere erforderliche valide Zuordnungen

Adressen:

Die Zuordnung der PLZ zum Ort muss innerhalb von Sachsen gültig sein. Gültige Zuordnungen sind im Regionalregister.

--> s. Pkt 2, (4)

Abschlüsse der Vorbildung

--> s. Pkt. 5

Zuordnungstabellen

Zuordnungstabelle S1083 --> S0503

Zeugnisart (549-065-->S1083)	Schulart (549-070-->S0503)
Abgangszeugnis der allgemeinbildenden Schule	Mittelschule	Allgemeinbildendes Gymnasium	Allgemeinbildende Förderschule	Freie Waldorfschule	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates
Hauptschulabschluss oder gleichwertiger Abschluss	Mittelschule	Allgemeinbildendes Gymnasium	Allgemeinbildende Förderschule	Freie Waldorfschule	Abendmittelschule	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates
Qualifizierender Hauptschulabschluss oder gleichwertiger Abschluss	Mittelschule	Allgemeinbildende Förderschule	Freie Waldorfschule	Abendmittelschule	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates
Realschulabschluss oder gleichwertiger Abschluss	Mittelschule	Allgemeinbildendes Gymnasium	Allgemeinbildende Förderschule	Freie Waldorfschule	Abendmittelschule	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates
Allgemeine Hochschulreife	Allgemeinbildendes Gymnasium	Freie Waldorfschule	Abendgymnasium	Kolleg	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates
Sonstiger allgemeinbildender Abschluss eines anderen Bundeslandes bzw. Staates	Sonstige allgemeinbildende Schulart eines anderen Bundeslandes bzw. Staates

Zuordnungstabelle S1084-->S0504

Zeugnisart (549-075-->S1084)	Schulart (549-073-->S0504)
Noch kein Abschluss einer berufsbildenden Schule	keine
Zeugnis	BvB	BvB-rehaspezifisch	Einstiegsqualifizierung	Berufsgrundbildungsjahr	Berufsgrundbildungsjahr (berufsbildende Förderschule)
Zeugnis (entspricht Vermerk: "mit Erfolg besucht" + zusätzlich zuerkannter HSA)	Berufsvorbereitungsjahr	Berufsvorbereitungsjahr (berufsbildende Förderschule)	Berufsgrundbildungsjahr	Berufsgrundbildungsjahr (berufsbildende Förderschule)
Abschlusszeugnis	Berufsschule	Berufsschule (berufsbildende Förderschule)	Fachschule	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates	Berufsfachschule	Berufsfachschule (berufsbildende Förderschule)
Abschlusszeugnis + zusätzlich zuerkannter Hauptschulabschluss	Berufsschule	Berufsschule (berufsbildende Förderschule)	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates	Berufsfachschule	Berufsfachschule (berufsbildende Förderschule)
Abschlusszeugnis + zusätzlich zuerkannter qualifizierter beruflicher Bildungsabschluss/mittlerer Schulabschluss	Berufsschule	Berufsschule (berufsbildende Förderschule)	Fachschule	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates	Berufsfachschule	Berufsfachschule (berufsbildende Förderschule)
Abschlusszeugnis + zusätzlich zuerkannte Fachhochschulreife	Berufsschule	Berufsschule (berufsbildende Förderschule)	Fachschule	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates	Berufsfachschule	Berufsfachschule (berufsbildende Förderschule)
Zeugnis der Fachhochschulreife	Fachoberschule	Fachoberschule (berufsbildende Förderschule)	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates
Zeugnis der allgemeinen Hochschulreife	Berufliches Gymnasium	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates
Sonstiger berufsbildender Abschluss eines anderen Bundeslandes bzw. Staates	Sonstige berufsbildende Schulart eines anderen Bundeslandes bzw. Staates

Zuordnungen Abschlüsse der aktuellen Ausbildung (S1085)

Kürzel	Merkmal1
Abbrecher	BS/BS, BS-F/BS, BFS/BFS (v), BFS/BFS (t), FS/FS (v), FS/FS (t), FOS/FOS, FOS/FOS 12L (v), FOS/FOS 12L (t), BS/BGJ, BS-F/BGJ, BS/BVJ, BS-F/BVJ, BS/gBVJ, BS-F/kBVJ, BGY, BS/VKl bA, BS/EQ, BS/BvB, BS-F/BvB
Abgangszeugnis	BS/BS, BS-F/BS, BFS/BFS (v), BFS/BFS (t), FS/FS (v), FS/FS (t), FOS/FOS, FOS/FOS 12L (v),FOS/FOS 12L (t), BGY
Abschlusszeugnis	BS/BS, BS-F/BS, BFS/BFS (v),BFS/BFS (t), FS/FS (v), FS/FS (t)
Zeugnis (Vermerk "ohne Erfolg besucht")	BS/BVJ, BS/gBVJ, BS-F/BVJ, BS-F/kBVJ, BS/BGJ, BS-F/BGJ
Zeugnis (Vermerk "mit Erfolg besucht")	BS/BGJ, BS-F/BGJ, BS/BVJ, BS/gBVJ, BS-F/BVJ, BS-F/kBVJ
Abschlusszeugnis (Zeugnis der allgemeinen Hochschulreife)	BGY
Absolvent BvB	BS/BvB
Absolvent BvB-rehaspezifisch	BS-F/BvB
Absolvent EQ	BS/EQ
Zeugnis (VKl bA)	BS/VKl bA
Abschlusszeugnis (Zeugnis der Fachhochschulreife)	FOS/FOS, FOS/FOS 12L (v), FOS/FOS 12L (t)
Zeugnis (Berufsschulpflichterfüller)	BS/BS, BS-F/BS

@@ Zeile 88: / Zeile 88: @@
 Ein Schüler verlässt aus unterschiedlichen Gründen eine Schule.
-* BSP1 (Normalfall):
+* Fall1 (Normalfall):
 Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Der Abschluss war erfolgreich. Der Abschluss dieses Schülers wird im Oktober 2018 für die amtliche Schulstatistik benötigt. Wir blicken deshalb auf das letzte Schuljahr zurück und zählen den Abschluss. Die Pflege des Abschlusses kann im Juli 2018 erfolgen. Der Schüler muss also im Oktober exportiert werden (aber für das vergangene Schuljahr). Deshalb muss die Schule einstellen können, für welches Schuljahr der Schüler exportiert werden soll. Im Oktober 2018 darf er nicht mehr für das Schuljahr 2018/2019 im Export sein, weil der Schüler ja da die Schule schon verlassen hat.
-* BSP2 (selten, aber möglich):
+* Fall2 (selten, aber möglich):
 Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Der Abschluss in der Berufsschule war erfolgreich, er ist allerdings durch die Facharbeiterprüfung gefallen. Damit muss der Abschluss im komm. Produkt wieder gelöscht werden, weil bei einer Lehrverlängerung die Schulberechtigung wieder da ist, der Schüler besucht noch ein halbes Jahr (bis zur nächsten Facharbeiterprüfung) die Schule. Dann besteht der Schüler die Prüfung und er bekommt jetzt den Abschluss der Schule. Das heißt also, dass die Schule ein evtl. im Juli eingegebenen Abschluss im September rückwirkend wieder löschen muss und im Februar 2019 wieder einträgt (allerdings dann im Schuljahr 2018/2019).
-* BSP3 (selten, aber möglich)
+* Fall3 (selten, aber möglich)
 Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Allerdings verkürzt er durch gute Leistungen und einen Antrag die Lehre um ein halbes Jahr. Damit wird das Zeugnis schon im Februar 2018 erstellt und der Schüler muss dann trotzdem bei der amtlichen Schulstatistik gezählt werden.
@@ Zeile 102: / Zeile 102: @@
 Für die Fälle1, 2 und 3 darf das Archivbit der Schnittstelle nicht gesetzt werden, welches das Löschen des Schülers in SaxSVS bedeutet. Der Schüler wird nicht in die Datenbank von SaxSVS des Folgeschuljahres übertragen, wenn das Abschlussdatum im aktuellen Schuljahr liegt. Nach der amtlichen Schulstatistik im Oktober werden die Datensätze bereinigt und die Schüler in SaxSVS gelöscht. Die gesetzlich vorgeschriebene Archivierung erfolgt nicht in SaxSVS, sondern im täglichen Arbeitsinstrument (also im komm. Produkt).
-* BSP4 (selten, aber möglich)
+* Fall4 (selten, aber möglich)
 Der Schüler wird in der Probezeit entlassen und bekommt damit keinen Abschluss, bei Umzug in ein anderes Bundesland ist der Vorgang analog. Bei der amtlichen Schulstatistik werden nur positive Abschlüsse gezählt. Dieser Schüler hat keinen und ist damit im laufenden Schuljahr und Folgeschuljahr nach Beendigung der Schulzeit für SaxSVS uninteressant. Damit der Schüler nicht im komm. Produkt und in SaxSVS durch die Schule gelöscht werden muss, soll dieser Schüler ein Archivbit bekommen (bspw. durch eine Schaltfläche „Schüler in SaxSVS löschen“). Damit ist gewährleistet, dass die Anzahl der Schüler in einer Klasse im komm. Produkt und in SaxSVS immer gleich ist. Angedacht ist, diese Daten einmal pro Monat abzugleichen.

Informationen: Unterschied zwischen den Versionen