Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- erp:schultraegerprogramm:user:imexport [2015/03/19 10:33] – [Import externe Schülerdaten] Frank Geisler
+++ erp:schultraegerprogramm:user:imexport [2024/02/27 08:30] (aktuell) – Frank Geisler
@@ Zeile 1: / Zeile 1: @@
 ====== Import / Export ======
 ===== Import externe Schülerdaten =====
-{{.:import_externe_schuelerdaten.png|}}\\
-Importieren Sie Schülerdaten aus einer **Text- oder CSV-Datei**. Stellen Sie in den [[.:einstellungen#Reiter Import externe Schülerdaten|Parametern]] ein, wo die Einlesedatei zu finden ist. \\
+{{.:import_externe_schuelerdaten.png}}\\
+Importieren Sie Schülerdaten aus einer **Text- oder CSV-Datei**. Stellen Sie in den [[.:einstellungen#reiter_import_externe_schuelerdaten|Parametern]] ein, wo die Einlesedatei zu finden ist.\\
 Enthält die Einlesedatei in der ersten Zeile Spaltenüberschriften, haken Sie bitte "Datei enthält Überschriften" an.\\
 Der Pfad mit dem Dateinamen wird unten angezeigt und dient zur Orientierung wo die Datei (und wie sie heißen muss) vom Programm erwartet wird.\\
-Sollten mehr als als die, im [[einstellungen#reiter_import_externe_schuelerdaten|Importparameter]] eingestellten, Anzahlen Schüler mehr in der Importdatei stehen als im aktiven Bestand vorhanden sind, erfolgt eine Sicherheitsabfrage, bevor der Import durchgeführt wird.\\
+Sollten mehr als als die, im [[.:einstellungen#reiter_import_externe_schuelerdaten|Importparameter]] eingestellten, Anzahlen Schüler mehr in der Importdatei stehen als im aktiven Bestand vorhanden sind, erfolgt eine Sicherheitsabfrage, bevor der Import durchgeführt wird.\\
+\\
+Verwalten Sie mehr als einen Kartentyp, stellen Sie hier ein, mit welchem Kartentyp (Wegekarte, Monatskarte,…) der Import neue Schüler importieren soll. Standard ist der in den Parametern eingestellte Standardkartentyp.\\
 \\
 Folgende Felder werden benötigt:
 |Feldname|Typ|Länge|Beschreibung|
 |Eindeutiger Schlüsselwert(GUID)|Text|100|Eindeutige Nummer aus externer Anwendung (bei SCHILD ist es ein GUID)|
 |Nachname|Text|50| |
 |Vorname|Text|50| |
 |Postleitzahl|Text|10| |
 |Ort|Text|50| |
 |Ortsteil|Text|100| |
@@ Zeile 18: / Zeile 22: @@
 |Schul-Nr.|Text|50| |
 |Klasse|Text|10| |
-|Status des Schülers|Zahl| |0= Neuaufnahme (führt dazu, dass der Folgeschuljahreszeitraum eingetragen wird - aufpassen zum Ende des Schuljahres!!!)\\ 2 = aktiv\\ 8 = Abi beendet\\ 9 = Abgemeldet |
+|Status des Schülers|Zahl| |0= Neuaufnahme (führt dazu, dass der Folgeschuljahreszeitraum eingetragen wird - aufpassen zum Ende des Schuljahres!!!) \\ 2 = aktiv \\ 8 = Abi beendet \\ 9 = Abgemeldet|
-|Änderungsdatum des Status|Datum| |Entlassungsdatum (nur bei Status 9)  |
+|Entlassungsdatum|Datum| |(nur bei Status 9)  |
-\\
+|Geburtsdatum|Datum| |Ab Version 1.7.3: Das Geburtsdatum wird mit dem kommenden Deutschlandticket Schüler ein sehr wichtiger Bestandteil des Tickets.|
 === Formate ===
-Grundsätzlich ist das ANSI- und -jetzt neu - das Unicode-Format (UTF-8) zulässig. \\
-**Text-Datei wie bisher**\\
+Grundsätzlich ist das ANSI- und das Unicode-Format (UTF-8) zulässig.
-  * mit Pipe-Zeichen | als Trennzeichen: \\ Es dürfen **keine** doppelten Anführungzeichen (") als Feldbegrenzer (bei Textfeldern) vorkommen! Beispiel: <code>
+**Text-Datei wie bisher**
+   * mit Pipe-Zeichen | als Trennzeichen: \\ Es dürfen **keine**  doppelten Anführungzeichen (") als Feldbegrenzer (bei Textfeldern) vorkommen! Beispiel:
+<code>
 eindeutige Nummer (GUID)|Nachname|Vorname|Postleitzahl|Ortsname|Ortsteil|Straße|Schul-Nummer|Klasse|Status|Entlassdatum
 {B118DDEE-07C6-47D6-AD0E-DB12827727F4}|Mustermann|Hans|34414|Musterstadt|Ortsteil|Musterstr. 29|4711|1A|9|31.07.2011
 </code>
-\\
-\\
+  *  **CSV-Format**:
-**CSV-Format**:
+  * Format 1: Alle o.g. Spalten Semikolon-getrennt **;**  angeben. Beispiel:
-  * Format 1: Alle o.g. Spalten Semikolon-getrennt **;** angeben. Beispiel: <code>
+<code>
 eindeutige Nummer (GUID);Nachname;Vorname;Postleitzahl;Ortsname;Ortsteil;Straße;Schul-Nummer;Klasse;Status;Entlassdatum
 {B118DDEE-07C6-47D6-AD0E-DB12827727F4};Mustermann;Hans;34414;Musterstadt;Ortsteil;Musterstr. 29;4711;1A;9;31.07.2011
 </code>
-  * Format 2: Alle o.g. Spalten Semikolon-getrennt und doppelten Anführungzeichen " als Texttrennzeichen. Beispiel: <code>
+  * Format 2: Alle o.g. Spalten Semikolon-getrennt und doppelten Anführungzeichen " als Texttrennzeichen. Beispiel:
+<code>
 "eindeutige Nummer (GUID)";"Nachname";"Vorname";"Postleitzahl";"Ortsname";"Ortsteil";"Straße";"Schul-Nummer";"Klasse";"Status";"Entlassdatum"
 "{B118DDEE-07C6-47D6-AD0E-DB12827727F4}";"Mustermann";"Hans";"34414";"Musterstadt";"Ortsteil";"Musterstr. 29";4711;"1A";9;31.07.2011
 </code>
+<color #00ff00>**Die Datei darf im sog. ANSI-Format oder auch im Unicode-Format (UTF-8 codiert) vorliegen.**</color> Andere Unicode-Formate führen zu Einlesefehlern. \\  \\ Hinweise:
+  * Überschriften werden in der Importdatei nicht benötigt. **Die Einlesung stützt sich allein auf die richtige Reihenfolge und Anzahl der Felder in der Importdatei.**
+  * Hausnummern dürfen keine Leerzeichen zwischen Nummer und Buchstaben besitzen, wenn die Hausnummer einen Buchstaben besitzt. Beispiel: 23a wird in Hausnummer gespeichert. 23 a wird nicht als Hausnummer erkannt und in der Straße gespeichert.
+  * Beim Import wird bei Neuanlagen der Monat der Einlesung als //gültig von//  genommen. Ab dem 15. eines Monats wird der Folgemonat eingetragen. \\ Beispiel: Bis zum 14.11. wird 201211 in //gültig von//  eingetragen, ab 15.11. steht hier 201212.
+  * Nur für Schulen, die Daten aus dem Schulsystem zum Importieren verwenden: Ab dem Tag des Schuljahreswechsels bis zum 12. Tag des Monats vor! dem 1. Tag des //gültig von // ([[.:einstellungen#reiter_allgemein|Parameter]]) werden nur noch Neuanlagen akzeptiert. \\  Beispiel: Sie führen einen Schuljahreswechsel am 14.06.2017 durch. Nach dem Schuljahreswechsel ist das //gültig von//  = 201709. Also werden vom 14.06.2017 bis zum 12.08.2017 nur Importe mit Neuanlagen zugelassen. \\ Der Wert //gültig von//  wird bestimmt vom Eintrag der [[.:einstellungen#reiter_schuelerstamm|Standard-Kartenart]]! Achten Sie bitte darauf, wenn Sie unterschiedliche Gültigkeitszeiträume für Wege- bzw. Monatskarten haben.
+ \\ Es findet zuerst eine Vorprüfung auf die Schul-Nr. statt. Ist in der Datei eine andere Schulnummer enthalten, wird der Import mit einer Meldung abgebrochen. Dies ist vornehmlich eine Sicherheitsbedingung für Schulen mit Teilstandorten. \\ Es findet eine Prüfung auf die ersten 3 Buchstaben der Straße statt. Unterscheiden sie sich wird angenommen, dass der Schüler umgezogen ist. Zusätzlich prüft easyTicket, ob neue Schüler hinzugekommen sind. \\ Am Ende des Imports wird die Schülerübersicht geöffnet mit den Schülern die umgezogen bzw. neu sind. {{.:schuelerimport_umzug.png?850}} \\ Bei diesen Schülern kontrollieren Sie bitte die Einstiegshaltestelle und ändern sie wenn nötig. \\  \\  \\ Werden Fehler festgestellt, wird dies in einem Protokoll in Seitenansicht ausgegeben. \\ Korrigieren Sie die Fehler im externen Programm und lesen Sie die Schülerdaten erneut ein. \\ {{.:import_externe_schuelerdaten_report.png}} \\  \\ Ist im Parameter [[.:einstellungen#reiter_system|System]] der Eintrag Anwendungstyp auf "Schulträger" bzw. "Schulträger (Selbsteingabe)" gestellt, wird nur der Import-Knopf im Formular dargestellt. Es wird hierbei immer ein Import aus dem FTP-Verzeichnis Ihres Verkehrsserviceunternehmens verarbeitet. \\
+ \\
+Für den Anwendungstyp Anwendungstyp "Schulträger (Schüler-Online)" existiert eine spezielle Datei, die aus dem Webbrowser kopiert und in eine Datei gebracht wird. Weitere Hinweise finden Sie [[.:einstellungen:speziell|hier]]
 \\
-\\
-<fc #00ff00>**Jetzt neu: Die Datei darf im sog. ANSI-Format oder auch im Unicode-Format (UTF-8 codiert) vorliegen.**</fc> Andere Unicode-Formate führen zu Einlesefehlern. \\
-\\
-Hinweise: \\
-  *Überschriften werden in der Importdatei nicht benötigt. **Die Einlesung stützt sich allein auf die richtige Reihenfolge und Anzahl der Felder in der Importdatei.**\\
-  *Hausnummern dürfen keine Leerzeichen zwischen Nummer und Buchstaben besitzen, wenn die Hausnummer einen Buchstaben besitzt. Beispiel: 23a wird in Hausnummer gespeichert. 23 a wird nicht als Hausnummer erkannt und in der Straße gespeichert.
-  * Beim Import wird bei Neuanlagen der Monat der Einlesung als //gültig von// genommen. Ab dem 15. eines Monats wird der Folgemonat eingetragen. \\ Beispiel: Bis zum 14.11. wird 201211 in //gültig von// eingetragen, ab 15.11. steht hier 201212.
-  * Nur für Schulen, die Daten aus dem Schulsystem zum Importieren verwenden: Ab dem Tag des Schuljahreswechsels bis zum 1. Tag des Monats des //gültig von //([[einstellungen#reiter_allgemein|Parameter]]) werden nur noch Neuanlagen akzeptiert. \\ Beispiel: Sie führen einen Schuljahreswechsel am 10.06.2014 durch. Nach dem Schuljahreswechsel ist das //gültig von// = 201409. Also werden vom 14.06.2014 bis zum 01.09.2014 nur Importe mit Neuanlagen zugelassen. \\ Der Wert //gültig von// wird bestimmt vom Eintrag der [[einstellungen#reiter_schuelerstamm|Standard-Kartenart]]! Achten Sie bitte darauf, wenn Sie unterschiedliche Gültigkeitszeiträume für Wege- bzw. Monatskarten haben.
-\\
-Es findet eine Prüfung auf die ersten 5 Buchstaben der Straße statt. Unterscheiden sie sich wird angenommen, dass der Schüler umgezogen ist. Zusätzlich prüft easyTicket, ob neue Schüler hinzugekommen sind. \\
-Am Ende des Imports wird die Schülerübersicht geöffnet mit den Schülern die umgezogen bzw. neu sind. {{:erp:schultraegerprogramm:user:schuelerimport_umzug.png?850|}} \\
-Bei diesen Schülern kontrollieren Sie bitte die Einstiegshaltestelle und ändern sie wenn nötig.\\
-\\
-\\
-Werden Fehler festgestellt, wird dies in einem Protokoll in Seitenansicht ausgegeben. \\
-Korrigieren Sie die Fehler im externen Programm und lesen Sie die Schülerdaten erneut ein.\\
-{{.:import_externe_schuelerdaten_report.png|}}
-\\
-\\
-Ist im Parameter [[.:einstellungen&#reiter_system|System]] der Eintrag Anwendungstyp auf "Schulträger" bzw. "Schulträger (Selbsteingabe)" gestellt, wird nur der Import-Knopf im Formular dargestellt. Es wird hierbei immer ein Import aus dem FTP-Verzeichnis Ihres Verkehrsserviceunternehmens verarbeitet.
 ===== Schülerexport =====

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge