Schnittstellenbeschreibung
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 nichts, wenn die Datei weitere Fächer enthält, die nicht belegt sind.
Tabelle
Beispiel:
InternKrz|StatistikKrz|Bezeichnung|BezeichnungZeugnis|BezeichnungÜZeugnis|Unterrichtsprache|Sortierung S1|Sortierung S2|Gewichtung
Deutsch|D|Deutsch|Deutsch|Deutsch|D|1|2|1
Englisch ab 5|E5|Englisch|Englisch|Englisch (ab Kl. 5)|D|2|14|1
Latein ab 5|L5|Latein|Latein|Latein (ab Kl. 5)|D|3|13|1
Latein ab 7|L7|L7|Latein|Latein (ab Kl. 7)|D|4|11|1
M|M|Mathematik|Mathematik|Mathematik|D|5|6|1
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 mehrer 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 Zeile) 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 der Dateien
- SchuelerZusatzdaten.dat
- SchuelerLernabschnittsdaten.dat
- SchuelerLeistungsdaten.dat
- SchuelerSprachenfolgen.dat
- SchuelerAbitur.dat
- SchuelerTelefonnummern
- 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 wird 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 Ausbildunggä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 Klassenzeichnungen 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|
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|||
SchulerSprachenfolgen.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