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