Skip to content

Massebevis ​

Massebevis lar deg utstede merker til hundrevis eller tusenvis av mottakere samtidig ved å laste opp en CSV-fil. Prosessen har fire trinn med innebygd fremdriftssporing, pause/gjenopptakelse og feilhåndtering.

Oversikt ​

Prosessen for massebevis følger fire trinn:

  1. Konfigurer — velg merket og alternativer
  2. Last opp — forbered og last opp CSV-filen
  3. Behandle — følg fremdriften mens bevisene opprettes
  4. Resultater — gjennomgå utfallet og last ned rapporter

Trinn 1: Konfigurer ​

Massetildeling — trinn 1, konfigurer

  1. Åpne siden Massebevis fra sidefeltet (egen rute, atskilt fra Bevis-siden).
  2. Velg merket du vil utstede med merkevelgeren.
  3. Konfigurer eventuelt:
    • Utstedt — datoen som brukes for alle bevis (standard er i dag)
    • Utløper — valgfri utløpsdato for alle bevis
    • Send e-post — om hver mottaker automatisk skal få e-post etter at beviset er opprettet
  4. Klikk Neste.

Trinn 2: Last opp CSV ​

Massetildeling — trinn 2, opplasting

CSV-format ​

CSV-filen må ha en name-kolonne og en email-kolonne, med en overskriftsrad. Overskriftsnavn skiller ikke mellom store og små bokstaver, og recipient_name / recipient_email godtas som alias for name / email.

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

Last ned mal ​

Klikk Last ned mal for å få en tom CSV-fil med riktige overskrifter. Fyll den ut med mottakerne dine og last den opp.

Opplasting ​

  1. Klikk Last opp CSV eller dra og slipp filen.
  2. Filen valideres før behandlingen starter.

Valideringsregler ​

Hver rad valideres så snart filen er lest:

  • Navn må være på minst 5 tegn
  • E-post må være en gyldig e-postadresse
  • Tomme rader hoppes over

Forhåndsvisningstabellen viser alle rader med en grønn hake eller en rød årsak. Ugyldige rader er ikke til hinder — de blir bare hoppet over, og telleren viser hvor mange gyldige mottakere som blir behandlet (f.eks. «18 gyldige mottakere, 2 ugyldige (hoppes over)»). Du kan fortsette så lenge minst én rad er gyldig; du trenger ikke rette og laste opp på nytt først.

  1. Klikk Neste for å starte behandlingen.

Trinn 3: Behandling ​

Når behandlingen har startet, ser du en fremdriftslinje og tellere i sanntid:

  • Fremdriftslinje — prosentandelen av rader som er behandlet
  • Opprettet — hvor mange bevis som er opprettet
  • Mislyktes — hvor mange rader som har mislyktes
  • Gjenstår — hvor mange rader som fortsatt står i kø

Tabellene Opprettet, Mislyktes og Venter fylles ut under linjen mens batchen kjører.

Pause og gjenopptakelse ​

  • Klikk Pause for å stoppe behandlingen midlertidig. Ingen nye bevis opprettes mens den er satt på pause.
  • Klikk Gjenoppta for å fortsette der du slapp.

Avbryt ​

  • Klikk Avbryt for å stoppe behandlingen helt. Bevis som allerede er opprettet, beholdes.

Feilhåndtering ​

Når en rad mislykkes av en radspesifikk årsak (f.eks. en ugyldig verdi som backend avviser):

  • Feilen registreres på den raden
  • Behandlingen fortsetter automatisk til neste rad
  • Mislykkede rader samles til resultattrinnet, med feilteksten vist i feiltabellen på skjermen

Rader som blir hastighetsbegrenset, prøves automatisk på nytt med en kort ventetid. En kreditt- eller kvotefeil er annerledes — i stedet for å hoppe videre settes batchen på pause, slik at du ikke bruker opp resten av filen. En rød melding «Utilstrekkelig kreditt» vises; fyll på eller oppgrader, og klikk deretter Gjenoppta for å fortsette der den stoppet.

Gjenoppretting etter sideoppdatering ​

Hvis du ved et uhell lukker nettleseren eller oppdaterer siden under behandlingen, gjenopprettes massebevisøkten når du kommer tilbake. Fremdriften fortsetter der den stoppet.

Trinn 4: Resultater ​

Når behandlingen er fullført (eller avbrutt), viser resultatskjermen fire oppsummeringskort:

  • Totalt — antall mottakere i batchen
  • Opprettet — antall bevis som er opprettet
  • Mislyktes — antall rader som mislyktes
  • Hoppet over — mottakere som ikke ble behandlet (f.eks. gjenværende rader etter en avbrytelse)

Under kortene viser en Opprettet-tabell hvert nye bevis med en lenke for å se det, og en Mislyktes-tabell viser feilene med feilteksten.

Last ned rapporter ​

  • Last ned resultat-CSV — alle rader i batchen, med kolonnene row, name, email, status, award_url (bevis-URL-en er fylt ut for opprettede rader).
  • Last ned feil-CSV — kun de mislykkede radene, med kolonnene name, email, error.

Prøv feil på nytt ​

Hvis noen rader mislyktes, klikk Prøv feil på nytt. Da startes en ny runde bare for de mislykkede mottakerne — du trenger ikke laste opp CSV-en på nytt. Det er nyttig etter at du har rettet et forbigående problem, for eksempel fylt på kreditt etter at en batch ble satt på pause.

badges.ninja Documentation