Schnittstellenbeschreibung
Der folgende Artikel beschreibt die einzelnen Dateien der Schnittstelle Schild-NRW und wie diese zum Import vorliegen müssen.
Faecher.dat
Beschreibung: Diese Datei enthält die Unterrichtsfächer. Es brauchen nur solche Fächer aufgeführt werden, die auch in den Leistungsdaten der Schüler auftauchen, es schadet aber nicht, wenn die Datei weitere Fächer enthält, die nicht belegt sind.
Beispiel:
InternKrz|StatistikKrz|Bezeichnung|BezeichnungZeugnis|BezeichnungÜZeugnis|Unterrichtssprache|Sortierung S1|Sortierung S2|Gewichtung
D|D|Deutsch|Deutsch|Deutsch|D|1|2|1
E5|E5|Englisch|Englisch|Englisch (ab Kl. 5)|D|2|14|1
L5|L5|Latein|Latein|Latein (ab Kl. 5)|D|3|13|1
L7|L7|L7|Latein|Latein (ab Kl. 7)|D|4|11|1
M|M|Mathematik|Mathematik|Mathematik|D|5|6|1
Download einer Beispiel Faecher.dat
Jahrgaenge.dat
Beschreibung: Diese Datei enthält die an der Schule vorkommenden Jahrgänge. Die einzelnen Jahrgänge müssen in der „natürlichen“ (chronologischen) Reihenfolge in der Datei vorliegen.
Beispiel:
InternKrz|StatistikKrz|Gliederung
E1|E1|***
E2|E2|***
E3|E3|***
03|03|***
04|04|***
Lehrkraefte.dat
Beschreibung: Diese Datei enthält die Lehrer-Grunddaten (Kürzel, Name, Adresse usw.). Alternativ können die Lehrer-Daten aber auch über eine von ASD-PC erzeugte Datei mit Abteilungsdaten importiert werden (bei der Lehrerverwaltung von SchILD-NRW). Dann kann auf die Datei Lehrkraefte.dat verzichtet werden, allerdings muss der Import der Abteilungsdaten dann auch zuerst erfolgen.
Beispiel:
InternKrz|StatistikKrz|Anrede|Titel|Nachname|Vorname|Geschlecht|Geburtsdatum|Staatsang|PLZ|Ort|Straße|Tel. Festnetz|Tel. mobil|E-Mail|Rechtsverhältnis|Beschäftigungsart|Einsatzstatus|Pflichtstunden-Soll| Schulleitung|Statistik-relevant|Stammschulnr.
MUE|MÜ1|Frau|Dr.|Müller|Johanna|w|21.4.1957|000|54321|Musterstadt|Teststraße 7|01234-76543|0173-9876543|jmueller@web.de|L|V|*|26|Vertret|J|
MUE2|MÜ2|Herr|StR.|Müller|Albrecht|m|6.8.1960|000|54352|Testdorf|Mustergasse 2|01243-345123||amueller@gmx.de|U|T|*|13||J|123456
LehrkraefteSonderzeiten.dat
Beschreibung: Diese Datei enthält Sonderzeiten (Mehrleistung, Minderleistung, Anrechnung) mit Gründen für die einzelne Lehrkräfte.
Beispiel:
Lehrkraft|Zeitart|Grund|Anzahl Stunden
MÜ1|MEHRLEISTUNG|100|3 MÜ1|ANRECHNUNG|510|2 MÜ2|MINDERLEISTUNG|260|2
LehrkraefteLehraemter
Beschreibung: Diese Datei enthält Daten zu den Lehrämtern der Lehrkräfte. Zu jedem Lehramt können mehrere Lehrbefähigungen (mit Anerkennungen) und Fachrichtungen (mit Anerkennungen) übergeben werden. Diese sind dann innerhalb eines durch „|“ getrennten Blockes durch „-“ zu trennen (siehe Beispiel). Für eine Lehrkraft können auch mehrere Lehrämter (in separaten Zeilen) mit zugeordneten Lehrbefähigungen und Fachrichtungen importiert werden.
Beispiel:
Lehrkraft|Lehramt|Anerkennung Lehramt|Lehrbefähigung|Anerkennung Lehrbef.|Fachrichtung|Anerkennung Fachr.
BA|25|AL|CH-AW|2-1|21|1 BA|00|ST|AM|3|BB|2 BK|24|ST|E|1|SQ|3 MÜ1|24|ST|D|1||
Klassen.dat
Beschreibung: Diese Datei enthält die an der Schule vorkommenden Klassen. Die einzelnen Klassen müssen in der „natürlichen“ (chronologischen) Reihenfolge in der Datei vorliegen.
Beispiel:
InternBez|StatistikBez|SonstigeBez|Jahrgang|Folgeklasse|Klassenlehrer|OrgForm|Klassenart|Gliederung|Fachklasse
04A|04A|04A|04|05A|L97|1|RK|***| 05A|05A|05A|05|06A|L73|1|RK|***|
Kurse.dat
Beschreibung: Diese Datei enthält Angaben zu Kurs- oder Klassen -Unterricht.
Beispiel:
KursBez|Jahr|Abschnitt|Jahrgang|Fach|Kursart|Wochenstd.|Wochenstd. KL|Kursleiter|Klassenunterricht
KU_11_GK_Mü|2005|2|11|Kunst|GK|3|3|Müller| M_12_LK_My|2005|2|12|Mathematik|LK|6|6|Meyer|N 05A|2005|2|05|D||4|4|Schulze|J
Alternativ-Format
Aufgrund des vielfach geäußerten Wunsches, über die Datei Kurse.dat noch weitere Daten zu importieren, steht nun auch das folgende Alternativ-Format zur Verfügung. Darin können insbesondere auch mehrere Lehrkräfte eingetragen werden, so dass bei Verwendung dieses Formates die Datei KurseLehrkraefte.dat (s.u.) nicht benötigt wird.
Zum Begriff „team-teaching“:
Team-Teaching liegt dann vor, wenn eine „Hauptlehrkraft“ den Unterricht in einem Fach während der gesamten Wochenstunden leitet (in der Regel im Klassenverband), dabei während einer bestimmten Anzahl von Stunden (was auch alle sein können) von einer zweiten Lehrkraft unterstützt wird. Team-Teaching liegt nicht vor, wenn z.B. bei einem 4-stündigen Sportunterricht eine Lehrkraft 3 Stunden allgemeinen Sport unterrichtet, eine andere 1 Stunde Schwimmen (oder noch mehr Lehrkräfte beteiligt sind). Der Fall „mehr als zwei Lehrkräfte“ kann nur über einen Kurs mit Zusatz-Einträgen in der Datei „KurseLehrkraefte.dat“ (s.u.) abgebildet werden.
Beispiele (Hinweis: die Kopfzeilen sind hier weggelassen)
Beispiel 1:
2 Std. Sport als Klassenunterricht in Klasse 06A im 2. Hj. 2006/07 bei Lehrer „BO“, kein Epochenunterricht
|06A|2006|2||SP|PUT|2||BO|N
Beispiel 2:
2 Std. Sport als Klassenunterricht in Klasse 06A im 2.Hj. 2006/07 bei Lehrer „BO“, Lehrer „ALD“ nimmt 1 Std. als „team-teacher“ teil.
|06A|2006|2||SP|PUT|2||Bo|N||1|ALD
Beispiel 3:
2-stündiger Sportkurs „Basketball“ in Jahrgang 06 im 2. Hj. 2006/07, 1 Std. bei Lehrer „BO“, 1 Std. bei Lehrer „ALD“, wird nur als Kurs eingerichtet (d.h. keine Zuweisungen bei Schülern)
Basketball||2006|2|06|SP|AGGT|2|1|BO|N||1|ALD
Beispiel 4:
4-stündiger Sportkurs „Basketball“ in Jahrgang 06 im 2. Hj. 2006/07, 3 Std. bei Lehrer „BO“, 1 Std. bei Lehrer „ALD“, 1 Std. bei Lehrer ‚MÜ“, alle Schüler der Klasse 06A nehmen teil (Hinweis: Wenn Teile des Unterrichtes von mehreren Lehrern gleichzeitig betreut werden, kann die Summe der Lehrerstunden größer als die der Schülerstunden sein).
Basketball|06A|2006|2|06|SP|AGGT|4|3|BO|N||1|ALD|1|MÜ
Beispiel 5:
2-stündiger Sportkurs „Basketball“ in Jahrgang 06 im 2. Hj. 2006/07, wird an Partnerschule mit Schulnr. 123456 gegeben.
Basketball||2006|2|06|SP|AGGT|2|||N|123456
KurseLehrkraefte.dat
Beschreibung: Diese Datei enthält zusätzliche Informationen zu Kursen, falls diese von mehreren Lehrkräften gehalten werden.
Beispiel:
KursBez|Jahr|Abschnitt|Lehrkraft|Wochenstd|Jahrgang
F_12_LK|2005|2|Schmitz|2|12 E_13_LK|2005|2|Moore|1|13
SchuelerBasisdaten.dat
Beschreibung: Enthält die Basis-Stammdaten der Schüler, insbesondere solche, die für die Statistik relevant sind.
Wenn die in den Dateien
- SchuelerZusatzdaten.dat
- SchuelerLernabschnittsdaten.dat
- SchuelerLeistungsdaten.dat
- SchuelerSprachenfolgen.dat
- SchuelerAbitur.dat
- SchuelerTelefonnummern.dat
- SchuelerErzieher.dat
- SchuelerMerkmale.dat
- SchuelerAdressen.dat
enthaltenen Schüler schon in SchILD-NRW existieren (anhand von Nachname, Vorname und Geburtsdatum), so wird diese Datei beim Import nicht zwingend benötigt. Existieren die Schüler dagegen noch nicht, so muss diese Datei vorhanden sein.
Wichtig: Jede Zeile der Importdatei muss entweder 50 oder 56 „Spalten“ enthalten.
Beispiel:
Nachname|Vorname|Geburtsdatum|Geschlecht|Status|PLZ|Ort|Straße|Aussiedler|1. Staatsang.|Konfession|StatistikKrz Konfession|Aufnahmedatum|Abmeldedatum Religionsunterricht|Anmeldedatum Religionsunterricht|Schulpflicht erf.|Reform-Pädagogik|Nr. Stammschule|Jahr|Abschnitt|Jahrgang|Klasse|Schulgliederung|OrgForm|Klassenart|Fachklasse|Noch frei|Verpflichtung Sprachförderkurs|? Teilnahme Sprachförderkurs|Einschulungsjahr|Übergangsempf. JG5|Jahr Wechsel S1|1. Schulform S1|Jahr Wechsel S2|Förderschwerpunkt|2. Förderschwerpunkt|Schwerstbehinderung|Autist|LS Schulnr.|LS Schulform|Herkunft|LS Entlassdatum|LS Jahrgang|LS Versetzung|LS Reformpädagogik|LS Gliederung|LS Fachklasse|LS Abschluss|Abschluss|Schulnr. neue Schule|Zuzugsjahr|Geburtsland Schüler|Geburtsland Mutter|Geburtsland Vater|Verkehrssprache|Dauer Kindergartenbesuch
Barnes|Daniela|17.11.1995|w|2|46499|Hamminkeln|Eppenbrunner Weg 352|N|000|ohne B.|OH|01.08.2001|||N|||2005|2|05|05A|***|||||N|N||||||||N|N||||||0||||||||124|151|de|3 Blöde|Marcel|22.03.1995|m|2|44869|Bochum|Froschteichplatz 5|N|000|ev.|ER|01.08.2001|||N|||2005|2|05|05A|***|||||N|N||||||||N|N||||||0|||||||||||4
Wichtig: Zur Identifizierung eines Schülers werden normalerweise der Name, der Vorname und das Geburtsdatum verwendet. Dies gilt auch für die oben genannten „abhängige“ Dateien. Existiert in der Datenbank ein Schüler mit der Kombination „Name,Vorname,Geburtsdatum“, so wird der Schüler als bereits existierend angenommen. In manchen Fällen kann es aber auch notwendig sein, dass ein Schüler mehrfach als getrennte Datensätze importiert werden muss, z.B. dann, wenn der Schüler an einem Berufskolleg mehrere Ausbildungsgänge besucht. In diesem Fall reicht die Kombination „Name, Vorname und Geburtsdatum“ nicht aus, um zwei getrennte Datensätze zu erzeugen. Um dies dennoch realisieren zu können, muss die Klasse als ein weiteres Kriterium verwendet werden, damit beim Import eindeutig entschieden werden kann, ob ein Datensatz schon existiert. Damit die bisherige Struktur der Importdateien nicht verändert werden muss, wird die Klasse nicht als zusätzliche Spalte angegeben, sondern dem Nachnamen angehängt, mit einem #-Zeichen als Trenner.
Beispiel 1:
Barnes|Daniela|17.11.1995|...
...
Barnes|Daniela|17.11.1995|...
In diesem Fall enthält die Importdatei den Eintrag „Barnes, Daniela“ zweimal, trotzdem wird beim Import nur ein Datensatz angelegt.
Beispiel 2:
Barnes#A01-1|Daniela|17.11.1995|...
...
Barnes#C02-1|Daniela|17.11.1995|…
In diesem Fall enthält die Importdatei den Eintrag „Barnes, Daniela“ zweimal, aber mit unterschiedlichen Klassenbezeichnungen nach dem Nachnamen. Daher werden zwei Datensätze angelegt.
Wichtig: Wenn die Klassenbezeichnung als zusätzliches Identifizierungsmerkmal verwendet werden soll, so muss sie auch bei allen abhängigen Tabellen in der beschriebenen Form vorhanden sein.
SchuelerZusatzdaten.dat
Beschreibung: Enthält zusätzliche Stammdaten der Schüler, die nicht statistik-relevant sind.
Beispiel:
Nachname|Vorname|Geburtsdatum|Namenszusatz|Geburtsname|Geburtsort|Ortsteil|Telefon-Nr.|E-Mail|2. Staatsang.|Externe ID-Nr|Sportbefreiung|Fahrschülerart|Haltestelle|Einschulungsart|Entlassdatum|Entlassjahrgang|Datum Schulwechsel|Bemerkungen
Fatirmay|Jasemin|26.01.1995|||Gütersloh|Roisdorf|01234-803324|JFatirmay@w123.de|163||temporär - Ausdaueranforderung|Schulbus|Ottostraße|||||
SchuelerLernabschnittsdaten.dat
Beschreibung: Enthält die Daten für einen Lernabschnitt (=Halbjahr oder Quartal) eines Schülers.
Beispiel:
Nachname|Vorname|Geburtsdatum|Jahr|Abschnitt|Jahrgang|Klasse|Schulgliederung|OrgForm|Klassenart|Fachklasse|Förderschwerpunkt|2. Förderschwerpunkt|Schwerstbehinderung|Wertung|Wiederholung|Klassenlehrer|Versetzung|Abschluss|Schwerpunkt
Alford|Daniel|03.12.1994|2005|2|05|05C|***|1|RK||||N|J|N|Müller|V|0 Bader|Heike|25.02.1995|2005|2|05|05D|***|1|RK||||N|J|N|Müller|V|0|
Download einer Beispiel SchuelerLernabschnittsdaten.dat
SchuelerLeistungsdaten.dat
Beschreibung: Enthält die Leistungsdaten (Fächer und Noten) eines Lernabschnittes (=Halbjahr oder Quartal) der Schüler.
Beispiel:
Nachname|Vorname|Geburtsdatum|Jahr|Abschnitt|Fach|Fachlehrer|Kursart|Kurs|Note|Abiturfach|Wochenstd.|Externe Schulnr|Zusatzkraft|Wochenstd. ZK
Fatirmay|Jasemin|26.01.1995|2005|2|Deutsch|Meyer|PUT||3||3||Müller|1 Fatirmay|Jasemin|26.01.1995|2005|2|Mathe|Schulze|WPII||2||3||| Fatirmay|Jasemin|26.01.1995|2005|2|Englisch ab 5|Schmidt|PUT|PUT||2||3|||
Optional können noch die Felder |Fehlstd.|unentsch. Fehlstd. angefügt werden. Damit können dann die Fehlstunden zu dem jeweiligen Fach erfasst werden.
Download einer Beispiel SchuelerLeistungsdaten.dat
SchuelerSprachenfolgen.dat
Beschreibung: Enthält Angaben zu Sprachenfolgen der Schüler.
Beispiel: Nachname|Vorname|Geburtsdatum|Fach|Reihenfolge|Jahrgang von|Abschnitt von|Jahrgang bis|Abschnitt bis
Abel|Jennifer|09.11.1990|Englisch|1|05|1||2 Abel|Jennifer|09.11.1990|Latein|2|07|1||2
Abendroth|Marko|04.05.1987|Englisch|1|05|1||2 Abendroth|Marko|04.05.1987|Latein|2|07|1||2
SchuelerAbitur.dat
Beschreibung: Enthält Angaben zu Abiturdaten der Schüler.
Hinweis: Die Abiturfächer werden über die entsprechenden Einträge bei SchuelerLeistungsdaten.dat ermittelt.
Beispiel:
Nachname|Vorname|Geburtsdatum|Zugelassen|Bestanden|Gesamtnote|Jahr|Abschnitt
Abenden|Jennifer|09.11.1988|J|J|1,8|2006|2 Abendroth|Marko|04.05.1987|J|J|2,4|2006|2
SchuelerErzieher.dat
Beschreibung: Enthält Angaben zu den Erziehern der Schüler. Pro Datensatz können die Namen von 1 (bei allein erziehendem Elternteil) oder 2 Personen (i.d.R. Mutter und Vater) eingegeben werden. Falls zu einem Schüler mehrere Datensätze existieren, sollen diese in der Reihenfolge der „Wichtigkeit“ (wichtigste Adresse zuerst) erscheinen.
Wichtig: Jede Zeile der Importdatei muss entweder 16 oder 18 „Spalten“ enthalten.
Beispiel:
Nachname|Vorname|Geburtsdatum|Erzieherart|Anrede 1.Person|Titel 1.Person|Nachname 1.Person|Vorname 1.Person|Anrede 2.Person|Titel 2.Person|Nachname 2.Person|Vorname 2.Person|Straße|PLZ|Ort|Ortsteil
Abel|Jennifer|09.11.1990|Mutter|Frau||Abel|Andrea|||||Kresseweg 188|33145|Warnburg|Osterfelde|andrea.abel@mymail.de|J
Abendroth|Marko|04.05.1987|Eltern|Frau|Dr.|Abendroth|Almuth|Herr||Abendroth|Anton|Basilikumweg 105|33145|Warburg|Westerstede|familie.abendroth@t-online.de|J
SchuelerTelefonnummern.dat
Beschreibung: Enthält zusätzliche Telefonnummern der Schüler bzw. der Erzieher.
Beispiel:
Nachname|Vorname|Geburtsdatum|Telefonnr.|Art
Abel|Jennifer|09.11.1990|01234-775303|Eltern
Achterberg|David|01.04.1992|01234-182861|Eltern
Addens|Sophie|05.12.1991|01234-561482|Eltern
SchuelerBisherigeSchulen.dat
Beschreibung: Enthält weitere Schulen, die bisher besucht wurden
(zusätzlich zu der in den Basisdaten enthaltenen letzten Schule).
SchuelerAdressen.dat
Beschreibung: Enthält weitere Adressen (z.B. von Ausbildungsbetrieben) der Schüler
Optional kann die Datei auch noch die folgenden Daten enthalten.
Wichtig: Jede Zeile der Importdatei muss entweder 20 oder 25 „Spalten“ enthalten.
Beispiel: (ohne die obigen Zusatzinformationen)
Nachname|Vorname|Geburtsdatum|Adressart|Name1|Name2|Straße|PLZ|Ort|1. Tel.-Nr.|2. Tel.-Nr.|E-Mail|Betreuer Nachname|Betreuer Vorname|Betreuer Anrede|Betreuer Tel.-Nr.|Betreuer E-Mail|Betreuer Abteilung|Vertragsbeginn|Vertragsende
Abel|Sandra|19.01.1986|Betrieb|Elektro Blau||Kirchsgasse 430|32978|Weveringen|01234-880016|||Müller|Anton|Herr|04567-98765|mueller@elektro-blau.de|Instandsetzung|01.08.2005|
Download einer Beispiel SchuelerAdressen.dat
SchuleMerkmale.dat
Beschreibung: Enthält spezielle Merkmale der Schule (z.B. ob Offene Ganztagsschule angeboten wird usw.)
Beispiel:
Merkmal
13+
OFFGANZ
VERBUND
SchuelerMerkmale.dat
Beschreibung: Enthält spezielle Merkmale der Schüler (z.B. Teilnahme am BUS-Projekt, Offene Ganztagsschule usw.)
Beispiel:
Nachname|Vorname|Geburtsdatum|Merkmal
Kortmann|Marina|26.04.1996|13+
Krannowski|Mariana|21.07.1996|GANZTAG
SchuelerVermerke.dat
Beschreibung: Enthält Vermerke (z.B. Bemerkungen) zu den Schülern, optional mit Datum. Zu jedem Vermerk kann ein beliebig langer Bemerkungstext hinzugefügt werden. Aus diesem Grunde ist der Dateiaufbau auch etwas anders als bei den übrigen Dateien: Auf eine Zeile, die zum einen zur Identifikation des Schülers (über Name und Geburtsdatum) dient, zum anderen die Vermerkart und das Datum des Vermerkes enthält, folgt der Bemerkungstext, der auch mehrere Zeilen umfassen kann. Der Bemerkungstext ist durch die „Tags“ <V> und </V> abgegrenzt, diese müssen jeweils in einer separaten Zeile stehen. Die Tags müssen auch vorhanden sein, wenn ein leerer Bemerkungstext übergeben wird.
Der Aufbau der „Identifikationszeile“ ist wie folgt:
Auf jede Identifikationszeile folgt der eigentliche Bemerkungstext, der durch die Tags <V> und </V> begonnen bzw. beendet wird.
Beispiel:
Nachname|Vorname|Geburtsdatum|Vermerkart|Vermerkdatum
Kortmann|Marina|26.04.1996|Tadel|01.02.2007
<V>
Marina ist mehrfach dem Unterricht ferngeblieben
</V>
SchuelerZeugnisBemerkungen.dat
Beschreibung: Mit dieser Datei können die Zeugnisbemerkungen zum jeweiligen Lernabschnitt exportiert/importiert werden. Der Aufbau gleicht dabei den Vermerken, ist jedoch an das Schuljahr und den Abschnitt gekoppelt.
Beispiel:
Nachname|Vorname|Geburtsdatum|Jahr|Abschnitt
Müller|Hans|10.03.1971|2013|
<V>
Alles super auf dem Zeugnis!
</V>
SchuelerASV.dat
Beschreibung: Mit dieser Datei können die Bemerkungen zum Arbeits- und Sozialverhalten des jeweiligen Lernabschnitts exportiert/importiert werden. Der Aufbau gleicht dabei den Vermerken, ist jedoch an das Schuljahr und den Abschnitt gekoppelt.
Beispiel:
Nachname|Vorname|Geburtsdatum|Jahr|Abschnitt
Müller|Hans|10.03.1971|2013|
<V>
Hans ist stets bemüht!
</V>
SchuelerLELS.dat
Beschreibung: Mit dieser Datei können die Bemerkungen zum außerunterrichtlichen Engagement des jeweiligen Lernabschnitts exportiert/importiert werden. Der Aufbau gleicht dabei den Vermerken, ist jedoch an das Schuljahr und den Abschnitt gekoppelt.
Beispiel:
Nachname|Vorname|Geburtsdatum|Jahr|Abschnitt
Müller|Hans|10.03.1971|2013|
<V>
Hans wurde zum Schulsanitäter ausgebildet!
</V>
Anhang
Allgemeine Kursarten: Die in Kurse.dat vorkommenden Einträge für die „allgemeine Kursart“
entsprechen in den meisten Fällen den „individuellen Kursarten“ (aus Statkue.mdb, Tabelle „ZulKuArt“).
In folgenden Fällen müssen aber andere Einträge verwendet werden:
| individuelle Kursarten | zugehörige allgemeine Kursart |
|---|---|
| AB3 | GK |
| AB4 | GK |
| AK3 | GK |
| AK4 | GK |
| GKM | GK |
| GKS | GK |
| LK1 | LK |
| LK2 | LK |