Skip to content

Sammelvergaben

Sammelvergaben ermöglichen dir, Auszeichnungen per CSV-Upload an Hunderte oder Tausende Empfänger:innen gleichzeitig auszustellen. Der Prozess hat vier Schritte mit eingebauter Fortschrittsverfolgung, Pause/Fortsetzen und Fehlerbehandlung.

Überblick

Der Sammelvergabe-Prozess folgt vier Schritten:

  1. Konfigurieren — Auszeichnung und Optionen auswählen
  2. Hochladen — CSV-Datei vorbereiten und hochladen
  3. Verarbeiten — Fortschritt verfolgen, während die Vergaben erstellt werden
  4. Ergebnisse — Resultate prüfen und Berichte herunterladen

Schritt 1: Konfigurieren

Sammelvergaben — Schritt 1, Konfigurieren

  1. Öffne die Seite Vergaben in der Seitenleiste.
  2. Klicke auf Sammelvergabe.
  3. Wähle die Auszeichnung, die du vergeben möchtest, mit dem Auszeichnungs-Picker aus.
  4. Konfiguriere optional:
    • Ausgestellt am — das Datum, das für alle Vergaben verwendet wird (Standard: heute)
    • Läuft ab — optionales Ablaufdatum für alle Vergaben
    • E-Mail senden — ob nach Erstellung automatisch jedem Empfänger eine E-Mail geschickt wird
  5. Klicke auf Weiter.

Schritt 2: CSV hochladen

Sammelvergaben — Schritt 2, Upload

CSV-Format

Die CSV-Datei muss zwei Spalten enthalten: name und email. Die erste Zeile ist der Header.

csv
name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Vorlage herunterladen

Klicke auf Vorlage herunterladen, um eine leere CSV-Datei mit den korrekten Headern zu erhalten. Fülle sie mit deinen Empfänger:innen aus und lade sie hoch.

Upload

  1. Klicke auf CSV hochladen oder ziehe deine Datei per Drag & Drop.
  2. Die Datei wird vor Beginn der Verarbeitung validiert.

Validierungsregeln

Jede Zeile wird validiert:

  • Name muss mindestens 5 Zeichen haben
  • E-Mail muss eine gültige E-Mail-Adresse sein
  • Doppelte E-Mails innerhalb der Datei werden markiert
  • Leere Zeilen werden übersprungen

Werden Validierungsfehler gefunden, werden sie mit Zeilennummern angezeigt. Behebe die Probleme in deiner CSV und lade sie erneut hoch.

  1. Klicke auf Weiter, um die Verarbeitung zu starten.

Schritt 3: Verarbeitung

Sobald die Verarbeitung startet, siehst du einen Fortschrittsbalken und Live-Status:

  • Fortschrittsbalken — zeigt den Prozentsatz der verarbeiteten Zeilen
  • Aktuelle Zeile — welche Zeile gerade verarbeitet wird
  • Erfolgszahl — wie viele Vergaben erstellt wurden
  • Fehlerzahl — wie viele Zeilen fehlgeschlagen sind

Pausieren und Fortsetzen

  • Klicke auf Pause, um die Verarbeitung vorübergehend zu stoppen. Während der Pause werden keine neuen Vergaben erstellt.
  • Klicke auf Fortsetzen, um dort weiterzumachen, wo du aufgehört hast.

Abbrechen

  • Klicke auf Abbrechen, um die Verarbeitung vollständig zu beenden. Bereits erstellte Vergaben bleiben erhalten.

Fehlerbehandlung

Wenn eine Zeile fehlschlägt (z. B. ungültige Daten, Monatskontingent aufgebraucht):

  • Der Fehler wird mit Details protokolliert
  • Die Verarbeitung fährt automatisch mit der nächsten Zeile fort
  • Fehlgeschlagene Zeilen werden für den Ergebnisschritt gesammelt

Wiederherstellung nach Seitenaktualisierung

Schließt du den Browser während der Verarbeitung versehentlich oder lädst die Seite neu, wird die Sammelvergabe-Session bei deiner Rückkehr wiederhergestellt. Der Fortschritt wird an der Stelle fortgesetzt, an der er unterbrochen wurde.

Schritt 4: Ergebnisse

Nach Abschluss (oder Abbruch) der Verarbeitung zeigt der Ergebnisbildschirm:

  • Insgesamt verarbeitet — Anzahl der versuchten Zeilen
  • Erfolgreich — Anzahl der erstellten Vergaben
  • Fehlgeschlagen — Anzahl der fehlgeschlagenen Zeilen

Berichte herunterladen

  • Erfolgs-CSV herunterladen — CSV aller erfolgreich erstellten Vergaben mit Empfängernamen, E-Mails und Verifizierungs-URLs
  • Fehler-CSV herunterladen — CSV aller fehlgeschlagenen Zeilen mit Fehlerdetails

Fehler erneut versuchen

Wenn einige Zeilen fehlschlagen, kannst du die Fehler-CSV herunterladen, die Probleme beheben und sie als neue Sammelvergabe hochladen, um diese Empfänger:innen erneut zu verarbeiten.

badges.ninja Documentation