Bulk-referenties

Met bulk-referenties geef je badges in één keer uit aan honderden of duizenden ontvangers door een CSV-bestand te uploaden. Het proces heeft vier stappen met ingebouwde voortgangsbewaking, pauzeren/hervatten en foutafhandeling.

Overzicht

Het bulkproces volgt 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 de referenties worden aangemaakt
4. Resultaten — bekijk de uitkomst en download rapporten

Stap 1: Configureren

1. Open de pagina Bulk-referenties in de zijbalk (een eigen route, los van de pagina Referenties).
2. Kies de badge die je wilt uitgeven met de badgekiezer.
3. Configureer optioneel:
   • Uitgegeven op — de datum voor alle referenties (standaard vandaag)
   • Verloopt — optionele vervaldatum voor alle referenties
   • E-mail verzenden — of elke ontvanger automatisch een e-mail krijgt nadat zijn of haar referentie is aangemaakt
4. Klik op Volgende.

Stap 2: CSV uploaden

CSV-indeling

Het CSV-bestand moet een kolom name en een kolom email hebben, met een koprij. Kopnamen zijn niet hoofdlettergevoelig, en recipient_name / recipient_email worden geaccepteerd als alias voor name / email.

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

Sjabloon downloaden

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

Uploaden

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

Validatieregels

Elke rij wordt gevalideerd zodra het bestand is ingelezen:

• Naam moet uit minimaal 5 tekens bestaan
• E-mail moet een geldig e-mailadres zijn
• Lege rijen worden overgeslagen

De voorbeeldtabel toont elke rij met een groen vinkje of een rode reden. Ongeldige rijen vormen geen blokkade — ze worden gewoon overgeslagen, en de teller toont hoeveel geldige ontvangers worden verwerkt (bijv. "18 geldige ontvangers, 2 ongeldig (worden overgeslagen)"). Je kunt doorgaan zolang minstens één rij geldig is; je hoeft niet eerst te corrigeren en opnieuw te uploaden.

3. Klik op Volgende om de verwerking te starten.

Stap 3: Verwerking

Zodra de verwerking start, zie je een voortgangsbalk en live tellers:

• Voortgangsbalk — het percentage verwerkte rijen
• Aangemaakt — hoeveel referenties zijn aangemaakt
• Mislukt — hoeveel rijen zijn mislukt
• Resterend — hoeveel rijen nog in de wachtrij staan

Live tabellen Aangemaakt, Mislukt en In behandeling vullen zich onder de balk terwijl de batch draait.

Pauzeren en hervatten

• Klik op Pauzeren om de verwerking tijdelijk te stoppen. Tijdens de pauze worden geen nieuwe referenties aangemaakt.
• Klik op Hervatten om verder te gaan waar je gebleven was.

Annuleren

• Klik op Annuleren om de verwerking helemaal te stoppen. Referenties die al zijn aangemaakt blijven behouden.

Foutafhandeling

Wanneer een rij mislukt om een rijspecifieke reden (bijv. een ongeldige waarde die de backend weigert):

• Wordt de fout bij die rij vastgelegd
• Gaat de verwerking automatisch door met de volgende rij
• Worden mislukte rijen verzameld voor de resultatenstap, met hun foutmelding in de foutentabel op het scherm

Rijen waarvoor een limiet geldt, worden automatisch opnieuw geprobeerd met een korte wachttijd. Een krediet- of quotumfout is anders — in plaats van door te gaan wordt de batch gepauzeerd, zodat je de rest van het bestand niet verbruikt. Er verschijnt een rode melding "Onvoldoende krediet"; waardeer op of upgrade, en klik daarna op Hervatten om verder te gaan waar het stopte.

Herstel na verversen van de pagina

Als je per ongeluk de browser sluit of de pagina ververst tijdens de verwerking, wordt de bulksessie hersteld wanneer je terugkomt. De voortgang gaat verder waar die stopte.

Stap 4: Resultaten

Nadat de verwerking is voltooid (of geannuleerd), toont het resultatenscherm vier overzichtskaarten:

• Totaal — aantal ontvangers in de batch
• Aangemaakt — aantal aangemaakte referenties
• Mislukt — aantal rijen dat is mislukt
• Overgeslagen — ontvangers die niet zijn verwerkt (bijv. resterende rijen na annuleren)

Onder de kaarten toont een tabel Aangemaakt elke nieuwe referentie met een link om die te bekijken, en een tabel Mislukt toont de fouten met hun foutmelding.

Rapporten downloaden

• Resultaten-CSV downloaden — elke rij in de batch, met de kolommen row, name, email, status, award_url (de referentie-URL is ingevuld voor aangemaakte rijen).
• Fouten-CSV downloaden — alleen de mislukte rijen, met de kolommen name, email, error.

Mislukte opnieuw proberen

Als sommige rijen zijn mislukt, klik dan op Mislukte opnieuw proberen. Dit start een nieuwe ronde voor alleen de mislukte ontvangers — je hoeft de CSV niet opnieuw te uploaden. Handig nadat je een tijdelijk probleem hebt verholpen, zoals het opwaarderen van krediet na een gepauzeerde batch.