Skip to content

Bulk-referenties

Met bulk-referenties kun je badges in één keer uitgeven 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 bulk-referentieproces 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 referenties worden aangemaakt
  4. Resultaten — bekijk de resultaten en download rapporten

Stap 1: configureren

Massa-uitreikingen — stap 1, configureren

  1. Open de pagina Referenties in de zijbalk.
  2. Klik op Bulk-referenties.
  3. Kies de uit te geven badge via de badge-kiezer.
  4. Optioneel instellen:
    • Uitgereikt op — de datum voor alle referenties (standaard vandaag)
    • Verloopt — optionele verloopdatum voor alle referenties
    • E-mail versturen — of elke ontvanger automatisch een e-mail krijgt na het aanmaken van de referentie
  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 referenties zijn aangemaakt
  • Aantal fouten — hoeveel rijen zijn mislukt

Pauzeren en hervatten

  • Klik op Pauzeren om de verwerking tijdelijk te stoppen. Er worden geen nieuwe referenties 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 referenties 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 bulk-referentiesessie 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 referenties
  • Mislukt — aantal mislukte rijen

Rapporten downloaden

  • CSV met geslaagde referenties downloaden — een CSV met alle succesvol aangemaakte referenties 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 bulk-referentie om die ontvangers opnieuw te proberen.

badges.ninja Documentation