Massutfärdande av meriter

Med massutfärdande av meriter kan du utfärda märken till hundratals eller tusentals mottagare på en gång genom att ladda upp en CSV-fil. Processen har fyra steg med inbyggd förloppsspårning, paus/återupptagning och felhantering.

Översikt

Processen för massutfärdande följer fyra steg:

1. Konfigurera — välj märke och alternativ
2. Ladda upp — förbered och ladda upp din CSV-fil
3. Bearbeta — följ förloppet medan meriterna skapas
4. Resultat — granska utfallet och ladda ned rapporter

Steg 1: Konfigurera

1. Öppna sidan Massmeriter i sidofältet (den har en egen sökväg, skild från sidan Meriter).
2. Välj det märke du vill utfärda med märkesväljaren.
3. Konfigurera vid behov:
   • Utfärdad den — datumet som används för alla meriter (standard är idag)
   • Upphör — valfritt utgångsdatum för alla meriter
   • Skicka e-post — om varje mottagare automatiskt ska få ett e-postmeddelande när deras merit har skapats
4. Klicka på Nästa.

Steg 2: Ladda upp CSV

CSV-format

CSV-filen måste ha en name-kolumn och en email-kolumn, med en rubrikrad. Rubrikerna är skiftlägesokänsliga, och recipient_name / recipient_email accepteras som alias för name / email.

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

Ladda ned mall

Klicka på Ladda ned mall för att få en tom CSV-fil med rätt rubriker. Fyll i den med dina mottagare och ladda upp den.

Uppladdning

1. Klicka på Ladda upp CSV eller dra och släpp filen.
2. Filen valideras innan bearbetningen börjar.

Valideringsregler

Varje rad valideras så fort filen har lästs in:

• Namn måste vara minst 5 tecken
• E-post måste vara en giltig e-postadress
• Tomma rader hoppas över

Förhandsgranskningstabellen listar varje rad med en grön bock eller en röd orsak. Ogiltiga rader är inget hinder — de hoppas helt enkelt över, och räknaren visar hur många giltiga mottagare som kommer att bearbetas (t.ex. ”18 giltiga mottagare, 2 ogiltiga (hoppas över)”). Du kan gå vidare så länge minst en rad är giltig; du behöver inte rätta och ladda upp igen först.

3. Klicka på Nästa för att starta bearbetningen.

Steg 3: Bearbetning

När bearbetningen startar ser du en förloppsindikator och levande räknare:

• Förloppsindikator — andelen bearbetade rader i procent
• Skapade — hur många meriter som har skapats
• Misslyckade — hur många rader som har misslyckats
• Återstående — hur många rader som fortfarande står i kö

Levande tabeller för Skapade, Misslyckade och Väntande fylls på under indikatorn medan batchen körs.

Pausa och återuppta

• Klicka på Pausa för att tillfälligt stoppa bearbetningen. Inga nya meriter skapas medan den är pausad.
• Klicka på Återuppta för att fortsätta där du slutade.

Avbryt

• Klicka på Avbryt för att stoppa bearbetningen helt. Meriter som redan har skapats behålls.

Felhantering

När en rad misslyckas av ett radspecifikt skäl (t.ex. ett ogiltigt värde som backend avvisar):

• Felet registreras för den raden
• Bearbetningen fortsätter automatiskt med nästa rad
• Misslyckade rader samlas in till resultatsteget, med felmeddelandet visat i feltabellen på skärmen

Hastighetsbegränsade rader försöks automatiskt igen med en kort fördröjning. Ett fel som rör krediter eller kvot är annorlunda — i stället för att hoppa vidare pausas batchen så att du inte förbrukar resten av filen. Ett rött meddelande ”Insufficient credits” visas; fyll på eller uppgradera och klicka sedan på Återuppta för att fortsätta där det stannade.

Återställning efter siduppdatering

Om du av misstag stänger webbläsaren eller uppdaterar sidan under bearbetningen återställs sessionen för massutfärdandet när du kommer tillbaka. Förloppet fortsätter där det stannade.

Steg 4: Resultat

När bearbetningen är klar (eller avbruten) visar resultatskärmen fyra sammanfattningskort:

• Totalt — antal mottagare i batchen
• Skapade — antal meriter som skapats
• Misslyckade — antal rader som misslyckats
• Överhoppade — mottagare som inte bearbetats (t.ex. återstående rader efter ett avbrott)

Under korten listar en tabell Skapade varje ny merit med en länk för att visa den, och en tabell Misslyckade listar felen med deras felmeddelanden.

Ladda ned rapporter

• Ladda ned resultat-CSV — varje rad i batchen, med kolumnerna row, name, email, status, award_url (meritens URL fylls i för skapade rader).
• Ladda ned felaktiga rader som CSV — endast de misslyckade raderna, med kolumnerna name, email, error.

Försök igen med misslyckade

Om några rader misslyckades klickar du på Försök igen med misslyckade. Då startas en ny körning över just de misslyckade mottagarna — du behöver inte ladda upp någon CSV igen. Det är praktiskt efter att ha åtgärdat ett tillfälligt problem, till exempel att fylla på krediter efter en pausad batch.