CSV-Import

Mit dem CSV-, Excel- oder JSON-Import kannst du viele Athleten auf einmal anmelden — ideal, wenn Vereine ihre Meldungen als Tabelle oder Datei schicken. Diese Seite beschreibt den Basis-Workflow des Import-Assistenten anhand einer CSV-Datei. Willst du stattdessen eine JSON-Datei hochladen oder Registrierungen direkt per Webservice (API-URL) abrufen, findest du die Unterschiede unter JSON- und Webservice-Import (Erweitert).

🟣 Nur Veranstalter

Voraussetzungen

• Dein Turnier muss im Status Anmeldung sein.
• Mindestens eine Klassenzuordnung muss angelegt sein — ohne Wettkampfklassen zeigt der Assistent die Warnung „Es sind keine Wettkampfklassen für dieses Turnier angelegt" und lässt dich nicht weiter.

Der 6-Schritt-Assistent

Der Import führt dich Schritt für Schritt durch den Vorgang:

Schritt 1: Konfiguration

• Lade eine CSV- oder JSON-Datei hoch (max. 10 MB).
• Alternativ kannst du eine API-URL eingeben, von der die Daten abgerufen werden.
• Unter der Upload-Fläche stehen zwei Download-Links bereit: CSV-Vorlage und JSON-Vorlage, jeweils mit zwei Beispiel-Datensätzen zum direkten Weiterbearbeiten.

Hinweis

Das Trennzeichen (Semikolon oder Komma) wird automatisch erkannt. Die Spaltennamen in deiner Datei können frei gewählt sein — du ordnest sie im nächsten Schritt zu.

🔧 Erweitert: Excel-Dateien (.xlsx / .xls)

Dieselbe Upload-Fläche akzeptiert neben CSV und JSON auch Excel-Dateien (.xlsx und .xls). Eingelesen wird dabei immer das erste Tabellenblatt der Arbeitsmappe, die erste Zeile gilt als Spaltenüberschrift. Ab dann läuft der Import identisch zu CSV weiter — Feld-Zuordnung, Werte-Zuordnung und Gewichtsklassen-Zuordnung funktionieren gleich.

Schritt 2: Feld-Zuordnung

Ordne die Spalten deiner Datei den Systemfeldern zu:

Systemfeld	Pflicht	Beschreibung	Beispiel
Vorname	Ja	Vorname des Athleten	Max
Nachname	Ja	Nachname des Athleten	Mustermann
Geburtsjahr	Ja	4-stellig	2012
Geschlecht	Ja	m, w, d oder mixed	m
Klasse	Ja	Gewichts-/Kategoriewert, wird in Schritt 4 der Wettkampfklasse zugeordnet	-60
Verein	Ja	Name des Vereins	TSV Musterstadt
Land (IOC)	Ja	3-stelliger IOC-Code	GER
Altersklasse	Nein	Nur nötig, wenn deine Datei mehrere Altersklassen mischt	U18
Gürtelfarbe	Nein	Farbe/Grad des Gürtels	orange
Bezahlt	Nein	Ob die Startgebühr bezahlt wurde	true
Gewogen	Nein	Ob der Athlet gewogen wurde	false
Externe ID	Nein	z. B. Verbands- oder Scanner-ID	12345
Istgewicht	Nein	Tatsächliches Gewicht in kg	59.4

Land (IOC) ist zwingend erforderlich

Land (IOC) ist für jede Zeile Pflicht — fehlt der Wert auch nur bei einem einzigen Datensatz, bricht der gesamte Import mit einer Fehlermeldung ab, nicht nur die betroffene Zeile. Hast du keine Länderspalte in deiner Datei, setze stattdessen eine Konstante (siehe unten), z. B. GER für ein rein deutsches Turnier.

Für Pflichtfelder ohne passende Spalte in deiner Datei nutzt du die Konstanten unterhalb der Zuordnungstabelle:

1. Klicke auf Konstante hinzufügen.
2. Wähle das Systemfeld (z. B. Land) und trage einen festen Wert ein, der für alle Datensätze gilt (z. B. GER).
3. Ein Feld gilt als zugeordnet, sobald entweder eine Spalte zugeordnet oder eine Konstante gesetzt ist — die Warnung mit den fehlenden Pflichtfeldern verschwindet erst dann.

Tipp

Für die Felder Bezahlt und Gewogen gelten true und 1 als „ja". Alle anderen Werte — also auch false, 0 oder leer — werden als „nein" gewertet.

🔧 Erweitert: Direkte ID-Verknüpfung statt Namens-Abgleich

Für Verein, Land, Verband und Postleitzahl gibt es neben den textbasierten Feldern (Vereinsname, Land, Verband, Postleitzahl) auch versteckte ID-Varianten (Vereins-ID, Land-ID, Verbands-ID, PLZ-ID). Kennt deine Quelldatei bereits die internen System-IDs — etwa bei einer Anbindung an ein Verbandssystem —, kannst du eine entsprechende Spalte zuordnen; sie hat dann Vorrang vor dem Namens-Abgleich. Für den normalen CSV-Import per Hand ist das in aller Regel nicht nötig.

Gültige Eingabewerte im Detail

Feld	Gültige Werte	Hinweis
Geschlecht	m, f, d, mixed	Beliebige Schreibweise in der Quelldatei — wird in Schritt 3 auf den Systemwert gemappt
Bezahlt	true, 1	Alle anderen Werte (inkl. false, 0) gelten als „nicht bezahlt"
Gewogen	true, 1	Alle anderen Werte (inkl. false, 0) gelten als „nicht gewogen"
Gürtelfarbe	9. Kyu, 8. Kyu, 7. Kyu, 6. Kyu, 5. Kyu, 4. Kyu, 3. Kyu, 2. Kyu, 1. Kyu, 1. Dan, 2. Dan, 3. Dan, 4. Dan	Exakt diese Schreibweise, inklusive Punkt und Leerzeichen
Geburtsjahr	4-stellige Jahreszahl, z. B. 2008	Erkennt das System ein vollständiges Datum (dd.mm.yyyy, yyyy-mm-dd oder mm/dd/yyyy) in der Spalte, wird automatisch der Parser „Datum → Jahr" vorgeschlagen und nur das Jahr übernommen. Bei anderen Datumsformaten wähle den Parser in Schritt 2 manuell aus oder wandle die Spalte vorher in eine reine Jahreszahl um
Land (IOC)	3-stelliger IOC-Code, z. B. GER, AUT, SUI	Groß-/Kleinschreibung spielt für die Vereinszuordnung keine Rolle. Beim Neuanlegen eines Vereins muss der Code aber exakt (in Großbuchstaben) mit dem hinterlegten Länder-Stammdatensatz übereinstimmen — sonst wird der Verein zwar trotzdem angelegt, aber ohne Länder-Verknüpfung
Externe ID	Beliebiger Text	Wird unverändert übernommen, z. B. eine Verbands-Meldenummer

Achtung: Geschlecht

Das Geschlechtsfeld erscheint in der Feld-Zuordnung als freies Textfeld. Du kannst hier einen beliebigen Spaltennamen aus deiner Datei eintragen. Die eigentlichen Werte in der Datei — also was in jeder Zeile steht — müssen aber in Schritt 3 auf einen der vier Systemwerte gemappt werden: m (männlich), f (weiblich), d (divers) oder mixed (gemischt). Das System erkennt gängige Schreibweisen (z. B. „männlich", „male", „weiblich", „female") automatisch und schlägt das Mapping vor — prüfe die Vorschläge aber immer nach.

Schritt 3: Wert-Zuordnung

Dieser Schritt erscheint nur, wenn du Geschlecht und/oder Altersklasse einer Spalte zugeordnet hast (nicht bei einer Konstante). Wenn deine Datei andere Bezeichnungen verwendet als das System, kannst du sie hier zuordnen. Zum Beispiel:

• Geschlecht: "m", "M", "maennlich" oder "male" auf männlich
• Geschlecht: "w", "W", "weiblich" oder "female" auf weiblich
• Altersklasse: ein Freitextfeld pro erkanntem Rohwert, z. B. "U18" oder "Jugend" — hier trägst du die im Turnier verwendete Bezeichnung ein

Bereits erkannte Zuordnungen sind mit dem Badge „Automatisch vorgeschlagen" markiert — prüfe sie trotzdem, bevor du weitergehst.

Schritt 4: Gewichtsklassen-Zuordnung

Ordne die Gewichtswerte aus deiner Datei den im Turnier konfigurierten Klassen zu. Das System unterstützt dabei intelligentes Matching:

• Exakt — der Wert stimmt genau überein (z. B. "-60" auf "-60")
• Numerisch — nur die Zahl wird verglichen (z. B. "60" auf "-60")
• Vorzeichenbasiert — Vorzeichen werden berücksichtigt, sofern der numerische Treffer eindeutig ist

Automatische Vorschläge immer prüfen

Ist ein Wert ohne Vorzeichen (z. B. "60") in Kombination mit mehreren gleich großen Klassen ("-60" und "+60") mehrdeutig, kann die automatische Zuordnung im Einzelfall danebenliegen. Kontrolliere daher jede vorbelegte Klasse in Schritt 4, bevor du zur Vorschau weitergehst.

🔧 Erweitert: Getrennte Tabellen je Geschlecht/Altersklasse

Hast du in Schritt 2 Geschlecht und/oder Altersklasse einer Spalte zugeordnet (statt einer Konstante), zeigt Schritt 4 nicht eine einzige Zuordnungstabelle, sondern eine Tabelle pro erkannter Kombination — z. B. je eine für „männlich / U15" und „weiblich / U15". Sind beide Felder über Konstanten gesetzt, siehst du dagegen nur eine einzige, einfache Tabelle. Die vier möglichen Darstellungsvarianten sind im Detail unter JSON-Webservice-Import erklärt — die Automatik gilt unabhängig davon, ob deine Daten aus CSV, Excel, JSON oder einem Webservice stammen.

🥋 Judo Safari: Klassen-Zuordnung wird durch das Alter überschrieben

Hat dein Turnier bereits Judo-Safari-Klassen angelegt, greift beim Import (inklusive Test-Import/Simulation in Schritt 5) ein Automatismus, der Schritt 4 in der Praxis überflüssig macht: Für jeden Datensatz berechnet das System aus dem Geburtsjahr das aktuelle Alter und weist automatisch die passende Safari-Altersklasse zu — bis 8, 9–11 oder 12–14. Die in Schritt 4 gewählte Zuordnung wird für diese Datensätze dabei überschrieben (die reine Datensatz-Vorschau ganz oben in Schritt 5 kann davor noch die in Schritt 4 gewählte Klasse zeigen). Athleten außerhalb dieser drei Altersspannen behalten die in Schritt 4 zugeordnete Klasse. Mehr zu Judo Safari unter Turnierarten: Judo Safari.

Schritt 5: Vorschau

Du siehst eine Vorschau der ersten 20 Datensätze (über „Alle Datensätze anzeigen" einblendbar) mit:

• Validierungsstatus pro Zeile (gültig oder fehlerhaft) inklusive der zugeordneten Wettkampfklasse
• Fehlerbeschreibungen, falls Pflichtfelder fehlen oder ungültig sind
• Duplikat-Warnungen, falls ein Athlet bereits gemeldet ist

Sobald du diesen Schritt erreichst, führt das System automatisch einen Test-Import (Simulation) durch — eine echte Import-Prüfung inklusive Duplikat-Erkennung, die am Ende zurückgerollt wird, ohne dass etwas gespeichert wird. Über den Button Test-Import (Simulation) kannst du diese Prüfung jederzeit erneut auslösen, z. B. nachdem du eine Zuordnung in einem vorherigen Schritt angepasst hast.

Wie Duplikate erkannt werden

Ein Datensatz gilt als Duplikat, wenn Vorname, Nachname, Geburtsjahr und Wettkampfklasse übereinstimmen (Groß-/Kleinschreibung wird ignoriert) — entweder mit einer bereits in der Championship vorhandenen Meldung (Badge „Bereits registriert") oder mit einem anderen Datensatz innerhalb derselben Datei (Badge „Duplikat in Datei"). Meldet sich derselbe Athlet für zwei unterschiedliche Klassen an, gilt das nicht als Duplikat. Bei mehreren gleichen Einträgen ist standardmäßig nur der zweite (und jeder weitere) Treffer zum Überspringen vorausgewählt — du kannst jede Checkbox einzeln umschalten, bevor du importierst.

Schritt 6: Ausführen

Starte den Import mit Jetzt importieren. Das anschließende Protokoll zeigt drei Kacheln — Erstellt, Duplikate, Fehler — sowie bei Fehlern ein detailliertes Fehlerprotokoll. Über die Buttons Zu Registrierungen oder Neuer Import geht es danach weiter.

Beispiel-CSV

Vorname;Nachname;Verein;Land;Gewicht;Altersklasse;Geschlecht;Jahrgang
Max;Mustermann;TSV Musterstadt;GER;-60;U18;m;2008
Anna;Schmidt;JC Bremen;GER;-48;U15;w;2012
Tom;Müller;JV Hamburg;GER;-66;U18;m;2009

Häufige Probleme

Umlaute werden falsch angezeigt

Stelle sicher, dass die Datei in UTF-8 gespeichert ist. In Excel: Speichern unter und dann CSV UTF-8 als Format wählen — oder lade die Tabelle direkt als .xlsx hoch, dann entfällt das Kodierungsproblem komplett.

Import bricht mit Fehler zum Land-Code ab

Fehlt in mindestens einer Zeile der IOC-Code, lehnt das System den gesamten Import ab. Prüfe, ob wirklich jede Zeile einen Wert in der Land-Spalte hat, oder setze ersatzweise eine Konstante für das Feld Land, falls alle Athleten aus demselben Land kommen.

Verein wird nicht erkannt / doppelt angelegt

Ein Verein gilt nur dann als „gefunden", wenn Vereinsname (exakt, ohne Groß-/Kleinschreibung) und Land-Code übereinstimmen — bei deutschen Vereinen (Land = GER) zusätzlich das Verbandskürzel. Weicht auch nur eines der Felder ab (z. B. "TSV Musterstadt" vs. "TSV Musterstadt e.V."), legt das System automatisch einen neuen Verein an, statt den bestehenden zu verwenden. Vereinheitliche Vereinsnamen und Land-Codes in deiner Importdatei, um Dubletten zu vermeiden.

Gewichtsklasse nicht gefunden

Die Bezeichnung muss mit einer im Turnier konfigurierten Klasse übereinstimmen (exakt, numerisch oder vorzeichenbasiert). Nutze die Gewichtsklassen-Zuordnung in Schritt 4, um Abweichungen zu korrigieren.

Import schlägt mit „Registrierungslimit" fehl

Jede Lizenz erlaubt nur eine maximale Anzahl Meldungen (Free: 30, Club: 100, Event: 250, Premium: 1000). Würde der Import dieses Limit überschreiten, wird der gesamte Import abgelehnt. Reduziere die Datei oder wechsle die Lizenz — Details unter Lizenzen.

Tipp

Teste den Import zuerst mit einer kleinen Datei (5–10 Athleten), bevor du eine große Liste importierst.

Weitere Informationen

• Registrierungen per JSON-Datei oder direkt per Webservice (API-URL) importieren: JSON- und Webservice-Import (Erweitert)
• Zurück zur Phase 2: Anmeldung
• Klassen einrichten in Phase 1: Einrichtung
• Wie Meisterschaft, Vereinsmeisterschaft und Judo Safari sich unterscheiden: Turnierarten