Skip to content

Massebeviser ​

Massebeviser lader dig udstede mærker til hundredvis eller tusindvis af modtagere på én gang ved at uploade en CSV-fil. Processen har fire trin med indbygget statussporing, pause/genoptag og fejlhåndtering.

Oversigt ​

Processen for massebeviser består af fire trin:

  1. Konfigurér — vælg mærket og indstillinger
  2. Upload — forbered og upload din CSV-fil
  3. Behandling — følg fremdriften, mens beviserne oprettes
  4. Resultater — gennemgå resultaterne, og download rapporter

Trin 1: Konfigurér ​

Massebeviser — trin 1, konfigurér

  1. Åbn siden Massebeviser i sidebjælken (den har sin egen rute, adskilt fra siden Beviser).
  2. Vælg det mærke, du vil udstede, med mærkevælgeren.
  3. Konfigurér eventuelt:
    • Udstedt den — datoen, der bruges til alle beviser (standard er i dag)
    • Udløber — valgfri udløbsdato for alle beviser
    • Send e-mail — om hver modtager automatisk skal have en e-mail, når vedkommendes bevis er oprettet
  4. Klik på Næste.

Trin 2: Upload CSV ​

Massebeviser — trin 2, upload

CSV-format ​

CSV-filen skal have en kolonne name og en kolonne email samt en overskriftsrække. Overskrifternes navne skelner ikke mellem store og små bogstaver, og recipient_name / recipient_email accepteres som aliasser for name / email.

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

Download skabelon ​

Klik på Download skabelon for at få en tom CSV-fil med de rigtige overskrifter. Udfyld den med dine modtagere, og upload den.

Upload ​

  1. Klik på Upload CSV, eller træk og slip din fil.
  2. Filen valideres, før behandlingen starter.

Valideringsregler ​

Hver række valideres, så snart filen er parset:

  • Navn skal være mindst 5 tegn
  • E-mail skal være en gyldig e-mailadresse
  • Tomme rækker springes over

Forhåndsvisningstabellen viser hver række med et grønt flueben eller en rød årsag. Ugyldige rækker er ikke en hindring — de bliver blot sprunget over, og tælleren viser, hvor mange gyldige modtagere der behandles (f.eks. "18 gyldige modtagere, 2 ugyldige (springes over)"). Du kan fortsætte, så længe mindst én række er gyldig; du behøver ikke først at rette og uploade igen.

  1. Klik på Næste for at starte behandlingen.

Trin 3: Behandling ​

Når behandlingen starter, ser du en statuslinje og live-tællere:

  • Statuslinje — procentdelen af behandlede rækker
  • Oprettet — hvor mange beviser der er oprettet
  • Mislykkedes — hvor mange rækker der er mislykkedes
  • Tilbage — hvor mange rækker der stadig er i kø

Live-tabellerne Oprettet, Mislykkedes og Afventer fyldes op under linjen, mens batchen kører.

Pause og genoptag ​

  • Klik på Pause for midlertidigt at stoppe behandlingen. Der oprettes ingen nye beviser, mens den er sat på pause.
  • Klik på Genoptag for at fortsætte, hvor du slap.

Annullér ​

  • Klik på Annullér for at stoppe behandlingen helt. Beviser, der allerede er oprettet, bevares.

Fejlhåndtering ​

Når en række mislykkes af en rækkespecifik årsag (f.eks. en ugyldig værdi, som backend afviser):

  • Fejlen registreres på den pågældende række
  • Behandlingen fortsætter automatisk med næste række
  • Mislykkede rækker samles til resultattrinnet, og deres fejltekst vises i tabellen over fejl på skærmen

Rækker, der er ramt af ratebegrænsning, forsøges automatisk igen med en kort forsinkelse. En fejl med kreditter eller kvote er anderledes — i stedet for at springe videre sættes batchen på pause, så du ikke bruger resten af filen. Der vises en rød besked om "Utilstrækkelige kreditter"; køb flere kreditter eller opgrader, og klik derefter på Genoptag for at fortsætte, hvor den stoppede.

Gendannelse efter opdatering af siden ​

Hvis du ved et uheld lukker browseren eller opdaterer siden under behandlingen, bliver sessionen for massebeviser gendannet, når du vender tilbage. Fremdriften genoptages, hvor den stoppede.

Trin 4: Resultater ​

Når behandlingen er færdig (eller annulleret), viser resultatskærmen fire oversigtskort:

  • I alt — antal modtagere i batchen
  • Oprettet — antal oprettede beviser
  • Mislykkedes — antal rækker, der mislykkedes
  • Sprunget over — modtagere, der ikke blev behandlet (f.eks. resterende rækker efter en annullering)

Under kortene viser en tabel Oprettet hvert nyt bevis med et link til at se det, og en tabel Mislykkedes viser fejlene med deres fejltekst.

Download rapporter ​

  • Download resultat-CSV — alle rækker i batchen med kolonnerne row, name, email, status, award_url (bevisets URL udfyldes for oprettede rækker).
  • Download fejl-CSV — kun de mislykkede rækker med kolonnerne name, email, error.

Forsøg fejl igen ​

Hvis nogle rækker mislykkedes, skal du klikke på Forsøg fejl igen. Det starter en ny gennemgang af kun de mislykkede modtagere — du behøver ikke uploade en CSV igen. Det er praktisk, når du har rettet et midlertidigt problem, f.eks. købt flere kreditter efter en batch, der blev sat på pause.

badges.ninja Documentation