Informationen

Aus SAXSVS BBS
Zur Navigation springen Zur Suche springen

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

  1. Muster der Schülermasken in SaxSVS-BBS: http://saxsvs-bbs.de/index.php/Schuelerdaten
  2. Schnittstelleninformationen (Schlüssel und Bildungsgänge): https://web1.extranet.sachsen.de/bbsp/public/schnittstellen/
  3. Einrichtungsregister: https://schuldatenbank.sachsen.de/xml/einregister_komplett_saxsvs.xml
  4. Regionalregister: https://www.statistik.sachsen.de/regioreg/REServlet?function=Suchen&id=16002%0A%09%09%09%09%09%09%09&type=11
  5. BSCW-Server (Ablage von Dokumenten, Präsentationen, Musterdateien und Tools): https://bscw.sachsen.schule/bscw/bscw.cgi/3193184
  6. 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.

  • BSP1 (Normalfall - ca. 95 % der Schüler):

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 - ca. 2 % der Schüler):

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 - ca. 1 % der Schüler)

Der Schüler erhält im Abgangsjahr (2017/2018) der Regelausbildung ein Zeugnis. Allerdings lernt er durch gute Leistungen und Antrag eine Lehrvertragskürzung 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).

  • BSP4 (selten - ca. 2 % der Schüler)

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