Handbuch

ExcelImport

Die ExcelImport-Function erlaubt den Import von CSV-Dateien mit Tänzerdaten.

Dateiformat:

Nachname;Vorname;X;Club;Barcode;Level;...

X=Geschlecht, M oder G für Mann, sonst Frau

Als Trennzeichen sind Semikolon oder Tabulator oder (neu in v2.6a) Komma erlaubt.

Der Barcode ist optional; wenn er gesetzt ist, muss er in der Datenbank bereits existieren (Neu in v2.5d: Aber beachte dazu die Option ''Unbekannte Codes''.)

(Neu in v2.2b) Wenn der Barcode gesetzt ist, dürfen Name, Vorname und Geschlecht leer sein (Neu in v2.5d: Aber beachte dazu die Option ''Unbekannte Codes''.)
(Neu in v2.2b) Für existierende Tänzer darf der Clubname leer sein.

Achtung: Die Datei sollte den Zeichensatz ISO-8859-1 verwenden, andernfalls können merkwürdige Effekte auftreten. Falls beim Import verdächtige Zeichen erkannt werden, wird der Import möglicherweise mit Fehler abgebrochen.

Funktionsweise:
Abhängig vom Arbeitsmodus wird zunächst entweder das "spezial", das "aktiv"- oder (neu in v2.5c) das "Class"-Kennzeichen aller Tänzer in der Datenbank gelöscht.

Während des Imports werden die Tänzer in der Datenbank nachgeschlagen. Wenn ein Barcode angegeben wurde, muss dieser in der Datenbank vorhanden sein und nur er wird für den Import beachtet (der angegebene Tänzername wird ignoriert), andernfalls werden Vor- und Nachname gegen die Datenbank geprüft und ggf. ein neuer Datensatz angelegt.

Falls ein Tänzer bereits in der Datenbank existiert, wird für ihn das "spezial"-/"aktiv"- oder "Class"-Kennzeichen gesetzt und in diesem Fall das Geschlechtskennzeichen ignoriert.

Fehlende Tänzer werden (mit gesetztem "spezial"-/"aktiv"- oder "Class"-Kennzeichen) neu angelegt und der Datensatz mit den angegebenen Daten gefüllt. Für das Geschlecht "M" wird die Tanzposition "Beau" angenommen und "Belle" für das Geschlecht "F".

Falls der Wert für "Level" auf irgendetwas vom Programm lesbares gesetzt wurde (z. B. A2), werden die entsprechenden Tanzprogramme bei diesem Tänzer gesetzt.
Achtung: Es werden nur zusätzliche Programme gesetzt, bereits vorhandene werden nicht gelöscht.

Der Clubname wird bei allen importierten Tänzern aktualisiert (auch bei existierenden). Falls der neue Clubname sich vom alten unterscheidet, wird eine Warnung ausgegeben.
(Neu in v2.2b) Wenn bei existierenden Tänzern der Clubname in der Excelliste fehlt, bleibt der Clubname des Tänzers unverändert.

Das Feld Barcodes ab wird berücksichtigt, wenn neue Tänzer angelegt werden (oder wenn Tänzer, die in der Importdatei vorkommen, zwar schon in der Datenbank existieren, dort aber noch keinen Barcode haben). Das Feld wird vorbelegt mit [letzter benutzter Barcode deines Nummernkreises] + 1. Bitte beachte, dass das nur richtig funktioniert wenn du a) deinen Barcode-Nummerkreis in der config.php richtig eingetragen hast und du b) deine Barcodes in aufsteigender Reihenfolge vergibst. Bevor das Programm einen Barcode vergibt, testet es, ob der Barcode schon vergeben ist und verwendet dann ggf. stattdessen den nächsten.

(Neu in v2.5d) Die Option Unbekannte Codes, sofern sie auf "Tänzer anlegen" gesetzt wird, verändert das Verhalten wie folgt: Wenn in diesem Fall in der importierten Datei ein Barcode enthalten ist, der noch nicht existiert, wird der entsprechende Tänzer angelegt, vorausgesetzt die übrigen Felder sind korrekt gefüllt. Aber bitte beachte, dass diese nur funktioniert, wenn der Barcode in deinem eigenen Nummernkreis liegt, wie er in deiner Konfiguration definiert ist.

Mögliche Fehlermeldungen: (Liste unvollständig)

• Fehler: Mitglied von xxx für Typ==spezial nicht gefunden!?
  (wobei xxx der Name des eigenen Clubs ist, wie in der config.php definiert)
  Das Programm nimmt an, dass es alle Tänzer dieses Clubs kennen sollte. Daher ist es ein Fehler, dass dieser Tänzer währende des "spezial"-Imports nicht in der Datenbank vorhanden ist. Dies soll dazu dienen, Tippfehler in der Importliste zu erkennen. Bitte importiere erst alle Clubmitglieder mit einem "aktiv"-Excelimport.

• Fehler: Doppelter Import für Barcode xxxxxx
  Deine Tänzerliste ist inkonsistent. Entweder hast du einen Barcode doppelt aufgelistet, oder du hast einen Barcode angegeben aber zusätzlich auch den alternativen Barcode für diesen Tänzer. Bitte prüfe deine Liste.

• Fehler: Importierter Barcode xxxxxx nicht gefunden!?
  Wenn ein Barcode angegeben ist, muss er auch in der Datenbank existieren. Sollen beim Import neue Tänzer angelegt werden, muss das Barcode-Feld leer bleiben.

• Fehler: Vor- und/oder Nachname leer
  Für neu angelegte Tänzer darf werder der Vor- noch der Nachname leer sein.

• Fehler: Geschlecht fehlt!
  Für neu angelegte Tänzer darf das Geschlechtskennzeichen nicht leer sein.

• Fehler: Konnte Trennzeichen nicht bestimmen
  Es müssen einheitlich in jeder Zeile der Datei (insbesondere auch der ersten) mindestens sechs Felder stehen, die durch Semikolon, Tabulator oder Komma getrennt sind.

• Warnung: Club war 'xxxx', Club jetzt 'yyyy'
  Der Clubname für diesen Tänzer wurde geändert.

• aktualisiert + neuer Code: xxxxxx
  Der Tänzer wurde in der Datenbank gefunden aber hatte noch keinen Barcode. Ihm wurde der neue Barcode xxxxxx zugewiesen und sein aktiv- bzw. spezial-Flag gesetzt.

• Status aktualisiert: xxxxxx
  Kein Fehler: Der Tänzer wurde unter dem Barcode xxxxxx in der Datenbank gefunden und sein aktiv- bzw. spezial-Flag gesetzt.

• eingefügt mit Code xxxxxx
  Kein Fehler: Der Tänzer existierte noch nicht und wurde unter dem Barcode xxxxxx neu angelegt.

Zurück zu Programmfunktionen

Zurück zum Inhaltsverzeichnis