Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- erp:schultraegerprogramm:user:imexport [2013/09/20 14:49] – [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 **Textdatei**. 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.|
-\\
-Es dürfen **keine** doppelten Anführungzeichen (") als Feldbegrenzer (bei Textfeldern) vorkommen!
+=== Formate ===
-Beispiel: \\
-\\
+Grundsätzlich ist das ANSI- und das Unicode-Format (UTF-8) zulässig.
-<code>
-"eindeutige Nummer (GUID)"|"Nachname"|"Vorname"|"Postleitzahl"|"Ortsname"|"Ortsteil"|"Straße"|"Schul-Nummer"|"Klasse"|"Status"|"Entlassdatum"
+**Text-Datei wie bisher**
-"{B118DDEE-07C6-47D6-AD0E-DB12827727F4}"|"Mustermann"|"Hans"|"34414"|"Musterstadt"|"Ortsteil"|"Dorfstr. 29"|"4711"|"1A"|9|31.07.2011
-</code>
+   * mit Pipe-Zeichen | als Trennzeichen: \\ Es dürfen **keine**  doppelten Anführungzeichen (") als Feldbegrenzer (bei Textfeldern) vorkommen! Beispiel:
-\\
-\\
-**statt dessen:**\\
 <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**:
+  * Format 1: Alle o.g. Spalten Semikolon-getrennt **;**  angeben. 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>
+  * 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 #ff0000>**GANZ WICHTIG: Die Datei muss im sog. ANSI-Format vorliegen. Andere Dateiformate (UTF8, UNICODE usw.) führen zu Einlesefehlern bzw. der Import wird abgelehnt!**</fc> \\
-\\
-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-bis 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 ab 14.06.2014 bis zum 01.09.2014 nur Importe mit Neuanlagen zugelassen.
-\\
-\\
-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 =====
@@ Zeile 58: / Zeile 76: @@
 Klicken Sie auf die Schaltfläche "Schülerdaten ausgeben", um den Export anzustoßen.\\
 Der Pfad mit dem Dateinamen wird unten angezeigt und dient zur Orientierung wo die Datei vom Programm ausgegeben wird.\\
+Klicken Sie auf [Protokoll], wird Ihnen ein Exportprotokoll angezeigt (s.u.) \\
 \\
 //Sind noch Schüler mit ungültiger Haltestelle im Bestand, wird der Export abgebrochen und die Schülerübersicht wird mit den ungültigen Schülern aufgerufen. Sie können nun die Schüler nacharbeiten. Danach können Sie erneut exportieren.//\\
@@ Zeile 69: / Zeile 88: @@
 Technischer Hinweis: \\
 __Exportbesonderheiten__: Wenn die Schüler exportiert werden, wird für Schüler mit Löschdatum das Exportsperrkennzeichen gesetzt. Dies bewirkt, dass gelöschte Schüler nur ein Mal übertragen werden. Das Löschdatum wird gesetzt, wenn der Schüler im Schülerstamm mit der Löschen-Schaltfläche gelöscht wird. Vorher muss aber der Haken im Feld "Löschen" gesetzt sein.
+\\
+\\
+Exportprotokoll: Klicken Sie unten rechts auf die Schaltfläche "Protokoll" erscheint diese Exportübersicht.\\
+{{.:schuelerexportprotokoll.png|}}\\
+Sortiert wird nur nach Exportdatum absteigend, sodass Sie chronologisch sehen können, wann Sie welche Schule zuletzt exportiert haben. Sie können hier wie gewohnt sortieren, filtern usw.

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge