Sidebar
Druck/Export
Inhaltsverzeichnis
Wertelisteninformationen für externe Softwareanbieter
Bei rechtlichen oder schulfachlichen Änderungen kommt es immer wieder zur Anpassung von Wertelisten. Neue Wertelisteneinträge werden angelegt, alte Wertelisteneinträge ungültig oder es kommt zu Änderungen der Kurzform, Anzeigeform oder Langform eines Eintrags. Um die referenzielle Integrität der Datenbank zu erhalten, werden dabei nie bestehende Einträge gelöscht. Stattdessen verfügt jeder Wertelisteneintrag über die Attribute Gültig von und Gültig bis, deren Werte entsprechend gesetzt werden. Dabei bedeutet bspw.
- Gültig bis == null: Der Wert ist bis auf weiteres zeitlich unbeschränkt gültig
- Gültig bis == 01.08.2015: Der Wert war bis 01.08.2015 gültig
- Gültig von == 01.08.2015: Der Wert ist seit 01.08.2015 gültig.
Änderungen der Werte Gültig bis und Gültig von werden seitens des Ministeriums in das System ASD („Amtliche Schuldaten“) eingepflegt und können auf Veranlassung des ASV-Anwenders mittels Datei→ASD-Schnittstelle→Wertelisten aktualisieren per Internet in die lokale ASV-Installation der Schule übertragen werden. Diese Datenübertragung findet an allen Schulen regelmäßig zuverlässig mindestens zur US (Zeitraum 1.10. - 10.10.) statt, in der Regel aber öfters im Schuljahr.
Damit Sie bereits erfolgte und zukünftig anstehende Wertelistenänderungen rechtzeitig bei der Weiterentwicklung Ihrer Software berücksichtigen können, stellen wir Ihnen in regelmäßigen Zeitabständen ein Paket „Wertelisteninformationen“ im Downloadbereich Material für externe Anbieter zur Verfügung.
Für den Zugang zu diesem Bereich benötigen Sie ein Benutzerkonto mit den erforderlichen Rechten, das Sie - sofern Sie nicht bereits darüber verfügen - per Mail bei gerhard.neff@stmbw.bayern.de beantragen können.
Inhalt des Pakets "Wertelisteninformation"
Das Paket „Wertelisteninformationen“ ist eine Zip-Datei, die einen html-Seitenbaum enthält. Darin enthalten sind
- Tabellen, die den kompletten Inhalt der Wertelisten zum Zeitpunkt der Dateierstellung enthalten und
- Tabellen, in denen nur diejenigen Werte enthalten sind, die sich im Zeitraum Erstelldatum +/- 1 Jahr geändert haben bzw. ändern werden.
Damit für die Entwicklung einer konkreten Schnittstelle alle relevanten Informationen auf einen Blick zu sehen sind, gibt es für jede Schnittstelle zudem eine html-Seite, die die nur diejenigen Wertelistenänderungen enthält, die die jeweilige Schnittstelle betreffen.
Bitte beachten Sie:
- Das Paket „Wertelisteninformation“ enthält i.d.R. nicht alle Wertelistenänderungen im Zeitraum Erstelldatum +/- 1 Jahr, da nach der Erstellung des Pakets weitere Änderungen seitens des Ministeriums in ASD eingepflegt werden können, die in den Zeitraum fallen.
- Mit dem Vorhandensein neuer Werte in den ASV-Installationen der Schulen (insbesondere zur Verwendung in Importschnittstellen) kann nach Beginn der Wertgültigkeit erst ab der nächstfolgenden Oktobermeldung sicher gerechnet werden.
Referenzierung der Wertelisteneinträge in den Schnittstellen
ASV bietet mehrere XML-basierte Import- und Exportschnittstellen, die durch
- eine XSD-Datei (Schema)
- ein Zip-Archiv mit allen referenzierten Wertelisten im XML-Format,
- im Falle von Importschnittstellen eine Beispieldatei und
- eine ergänzende Dokumentation der Semantik auf Wiki-Seiten
dokumentiert sind. Hier der Link zur Dokumentation
Die Wertelisteneinträge in ASV werden in allen XML-Schnittstellen über ihre Schlüssel referenziert. Für die Werteliste Anrede beispielsweise
| Schlüssel | Schulart | Gültig von | Gültig bis | kurzform | anzeigeform | langform | bemerkung |
|---|---|---|---|---|---|---|---|
| 1 | 01.08.2008 | — | F | Frau | Frau | ||
| 2 | 01.08.2008 | — | H | Herr | Herr | ||
| 3 | 01.08.2008 | — | K | keine | keine |