Skip to content

Massa-uitreikingen

Met massa-uitreikingen kun je badges in één keer uitreiken aan honderden of duizenden ontvangers door een CSV-bestand te uploaden. Het proces bestaat uit vier stappen met ingebouwde voortgangsbewaking, pauze/hervatten en foutafhandeling.

Overzicht

Het massa-uitreikingsproces verloopt in vier stappen:

  1. Configureren — kies de badge en de opties
  2. Uploaden — bereid je CSV-bestand voor en upload het
  3. Verwerken — volg de voortgang terwijl uitreikingen worden aangemaakt
  4. Resultaten — bekijk de resultaten en download rapporten

Stap 1: configureren

Massa-uitreikingen — stap 1, configureren

  1. Open de pagina Uitreikingen in de zijbalk.
  2. Klik op Massa-uitreiking.
  3. Kies de uit te reiken badge via de badge-kiezer.
  4. Optioneel instellen:
    • Uitgereikt op — de datum voor alle uitreikingen (standaard vandaag)
    • Verloopt — optionele verloopdatum voor alle uitreikingen
    • E-mail versturen — of elke ontvanger automatisch een e-mail krijgt na het aanmaken van de uitreiking
  5. Klik op Volgende.

Stap 2: CSV uploaden

Massa-uitreikingen — stap 2, uploaden

CSV-formaat

Het CSV-bestand moet twee kolommen hebben: name en email. De eerste rij is de koptekst.

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

Sjabloon downloaden

Klik op Sjabloon downloaden om een leeg CSV-bestand met de juiste kopteksten te krijgen. Vul het in met je ontvangers en upload het.

Uploaden

  1. Klik op CSV uploaden of sleep het bestand erop.
  2. Het bestand wordt gevalideerd voordat de verwerking begint.

Validatieregels

Elke rij wordt gevalideerd:

  • Naam moet minstens 5 tekens lang zijn
  • E-mail moet een geldig e-mailadres zijn
  • Duplicate e-mailadressen binnen het bestand worden gemarkeerd
  • Lege rijen worden overgeslagen

Als er validatiefouten worden gevonden, worden deze met rijnummer weergegeven. Corrigeer de problemen in je CSV en upload opnieuw.

  1. Klik op Volgende om de verwerking te starten.

Stap 3: verwerking

Zodra de verwerking loopt, zie je een voortgangsbalk en livestatus:

  • Voortgangsbalk — toont het percentage verwerkte rijen
  • Huidige rij — welke rij momenteel wordt verwerkt
  • Aantal geslaagd — hoeveel uitreikingen zijn aangemaakt
  • Aantal fouten — hoeveel rijen zijn mislukt

Pauzeren en hervatten

  • Klik op Pauzeren om de verwerking tijdelijk te stoppen. Er worden geen nieuwe uitreikingen aangemaakt tijdens de pauze.
  • Klik op Hervatten om verder te gaan waar je was.

Annuleren

  • Klik op Annuleren om de verwerking volledig te stoppen. Al aangemaakte uitreikingen blijven behouden.

Foutafhandeling

Wanneer een rij mislukt (bijvoorbeeld door ongeldige gegevens of een bereikt maandelijks quotum):

  • De fout wordt met details gelogd
  • De verwerking gaat automatisch verder met de volgende rij
  • Mislukte rijen worden verzameld voor de stap Resultaten

Herstel na paginavernieuwing

Als je de browser per ongeluk sluit of de pagina vernieuwt tijdens de verwerking, wordt de massa-uitreikingssessie hersteld wanneer je terugkeert. De voortgang wordt hervat vanaf het punt waar die werd onderbroken.

Stap 4: resultaten

Na afronding (of annulering) van de verwerking toont het resultatenscherm:

  • Totaal verwerkt — aantal geprobeerde rijen
  • Geslaagd — aantal aangemaakte uitreikingen
  • Mislukt — aantal mislukte rijen

Rapporten downloaden

  • CSV met geslaagde uitreikingen downloaden — een CSV met alle succesvol aangemaakte uitreikingen inclusief namen, e-mailadressen en verificatie-URL's van ontvangers
  • CSV met mislukte rijen downloaden — een CSV met alle mislukte rijen en foutdetails

Mislukten opnieuw proberen

Als sommige rijen zijn mislukt, kun je de CSV met mislukte rijen downloaden, de problemen oplossen en het bestand opnieuw uploaden als nieuwe massa-uitreiking om die ontvangers opnieuw te proberen.

badges.ninja Documentation