Vorbemerkungen-Schnittstelle: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen
keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 5: Zeile 5:
Der Import erfolgt aus mehreren Textdateien, deren Struktur nachfolgend erläutert ist. Für alle Textdateien gelten folgende Bedingungen:
Der Import erfolgt aus mehreren Textdateien, deren Struktur nachfolgend erläutert ist. Für alle Textdateien gelten folgende Bedingungen:


; Schild-NRW erwartet, dass die Schnittstellendateien genau die hier angegebenen Dateinamen haben. Beispielsweise wird Sbasis.dat an Stelle von SchuelerBasisdaten.dat nicht erkannt.
Schild-NRW erwartet, dass die Schnittstellendateien genau die hier angegebenen Dateinamen haben. Beispielsweise wird Sbasis.dat an Stelle von SchuelerBasisdaten.dat nicht erkannt.


Jede Zeile muss genau einen Datensatz enthalten
Jede Zeile muss genau einen Datensatz enthalten.


Als Trennzeichen zwischen einzelnen „Spalten“ (Feldern) wird das Pipe-Symbol „|“ verwendet. Dies hat den Vorteil, dass z.B. in Bemerkungen auch ein Semikolon möglich ist.
Als Trennzeichen zwischen einzelnen „Spalten“ (Feldern) wird das Pipe-Symbol „|“ verwendet. Dies hat den Vorteil, dass z.B. in Bemerkungen auch ein Semikolon möglich ist.


Textfeldern werden nicht durch (doppelte) Anführungsstriche begonnen und beendet
Textfeldern werden nicht durch (doppelte) Anführungsstriche begonnen und beendet.


Datumsfelder müssen als TT.MM.JJJJ vorliegen
Datumsfelder müssen als TT.MM.JJJJ vorliegen.


Die Spalten (Felder) müssen genau in der vorgegebenen Reihenfolge erscheinen
Die Spalten (Felder) müssen genau in der vorgegebenen Reihenfolge erscheinen.


Jede Datei enthält eine Header-Zeile mit den Bezeichnungen der einzelnen „Spalten“, diese dient aber nur zur Information und wird ansonsten beim Import nicht verwendet. Die einzelnen Bezeichnungen in der Header-Zeile müssen auch mit „|“-Zeichen getrennt sein.
Jede Datei enthält eine Header-Zeile mit den Bezeichnungen der einzelnen „Spalten“, diese dient aber nur zur Information und wird ansonsten beim Import nicht verwendet. Die einzelnen Bezeichnungen in der Header-Zeile müssen auch mit „|“-Zeichen getrennt sein.


Bei leeren Feldern muss dennoch ein Trennzeichen „|“ ausgegeben werden, d.h. jede Zeile muss exakt die Anzahl der erwarteten Trennzeichen enthalten
Bei leeren Feldern muss dennoch ein Trennzeichen „|“ ausgegeben werden, d.h. jede Zeile muss exakt die Anzahl der erwarteten Trennzeichen enthalten


Bei den einzelnen Spalten ist angebeben, ob diese leer sein dürfen. Dabei treten folgende Zustände auf:
Bei den einzelnen Spalten ist angebeben, ob diese leer sein dürfen. Dabei treten folgende Zustände auf:


* Nein: Spalte darf nicht leer sein, d.h. muss einen (gültigen) Wert enthalten. Ein Eintrag wird aus datentechnischen Gründen benötigt.
* Nein: Spalte darf nicht leer sein, d.h. muss einen (gültigen) Wert enthalten. Ein Eintrag wird aus datentechnischen Gründen benötigt.
Zeile 29: Zeile 29:
* Ja: Spalte darf leer sein
* Ja: Spalte darf leer sein


Bei den einzelnen Spalten ist jeweils der erwartete Datentyp angegeben:
Bei den einzelnen Spalten ist jeweils der erwartete Datentyp angegeben:


* Text(n): Text mit einer maximalen Länge von n Zeichen (Beispiel: Text(20) bedeutet, dass die Spalteninhalt maximal 20 Zeichen umfassen darf
* Text(n): Text mit einer maximalen Länge von n Zeichen (Beispiel: Text(20) bedeutet, dass die Spalteninhalt maximal 20 Zeichen umfassen darf
Zeile 37: Zeile 37:
* Float: Gleitkommazahl (es kann entweder ein Komma oder ein Punkt als dezimales Trennzeichen verwendet werden)
* Float: Gleitkommazahl (es kann entweder ein Komma oder ein Punkt als dezimales Trennzeichen verwendet werden)


Es ist nicht unbedingt notwendig, dass alle der nachfolgend beschriebenen Dateien in einem Zug importiert werden, d.h. es ist auch möglich, einzelne Dateien nachträglich zu importieren. Voraussetzung dafür ist aber, dass „übergeordnete“ Informationen, auf die in der jeweiligen Importdatei verwiesen wird, bereits in der Datenbank von SchILD-NRW existieren (z.B. durch einen vorangegangenen Import). Wenn z.B. Lernabschnitts- und Leistungsdaten separat importiert werden sollen, müssen die folgenden Daten bereits vorhanden sein:
Es ist nicht unbedingt notwendig, dass alle der nachfolgend beschriebenen Dateien in einem Zug importiert werden, d.h. es ist auch möglich, einzelne Dateien nachträglich zu importieren. Voraussetzung dafür ist aber, dass „übergeordnete“ Informationen, auf die in der jeweiligen Importdatei verwiesen wird, bereits in der Datenbank von SchILD-NRW existieren (z.B. durch einen vorangegangenen Import). Wenn z.B. Lernabschnitts- und Leistungsdaten separat importiert werden sollen, müssen die folgenden Daten bereits vorhanden sein:


* Die Basisdaten der Schüler, deren Lernabschnitts- und Leistungsdaten importiert werden sollen
* Die Basisdaten der Schüler, deren Lernabschnitts- und Leistungsdaten importiert werden sollen

Navigationsmenü