Skip to content

Skupne vjerodajnice ​

Skupne vjerodajnice omogućuju izdavanje bedževa stotinama ili tisućama primatelja odjednom učitavanjem CSV datoteke. Postupak ima četiri koraka s ugrađenim praćenjem napretka, pauziranjem/nastavljanjem i obradom pogrešaka.

Pregled ​

Postupak skupnih vjerodajnica slijedi četiri koraka:

  1. Konfiguracija — odaberite bedž i opcije
  2. Učitavanje — pripremite i učitajte svoju CSV datoteku
  3. Obrada — pratite napredak dok se vjerodajnice stvaraju
  4. Rezultati — pregledajte ishode i preuzmite izvješća

Korak 1: Konfiguracija ​

Bulk Awards — step 1, configure

  1. Otvorite stranicu Bulk Credentials u bočnoj traci (ima vlastitu rutu, odvojenu od stranice Credentials).
  2. Odaberite bedž koji želite izdati pomoću birača bedževa.
  3. Po želji podesite:
    • Issued On — datum koji će se koristiti za sve vjerodajnice (zadano je današnji datum)
    • Expires — neobavezni datum isteka za sve vjerodajnice
    • Send Email — hoće li se svakom primatelju automatski poslati e-pošta nakon što se njegova vjerodajnica stvori
  4. Kliknite Next.

Korak 2: Učitavanje CSV-a ​

Bulk Awards — step 2, upload

CSV format ​

CSV datoteka mora imati stupac name i stupac email, uz redak zaglavlja. Nazivi zaglavlja ne razlikuju velika i mala slova, a recipient_name / recipient_email prihvaćaju se kao zamjenski nazivi za name / email.

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

Preuzimanje predloška ​

Kliknite Download Template da biste dobili praznu CSV datoteku s ispravnim zaglavljima. Ispunite je podacima o primateljima i učitajte.

Učitavanje ​

  1. Kliknite Upload CSV ili povucite i ispustite datoteku.
  2. Datoteka se provjerava prije početka obrade.

Pravila provjere ​

Svaki se redak provjerava čim se datoteka parsira:

  • Name mora imati najmanje 5 znakova
  • Email mora biti valjana adresa e-pošte
  • Prazni se reci preskaču

Tablica pregleda prikazuje svaki redak sa zelenom kvačicom ili crvenim razlogom. Nevaljani reci nisu prepreka — jednostavno se preskaču, a brojač prikazuje koliko će valjanih primatelja biti obrađeno (npr. "18 valid recipients, 2 invalid (will be skipped)"). Možete nastaviti čim je barem jedan redak valjan; nije potrebno prvo ispravljati i ponovno učitavati.

  1. Kliknite Next da biste započeli obradu.

Korak 3: Obrada ​

Kad obrada započne, vidite traku napretka i brojače uživo:

  • Traka napretka — postotak obrađenih redaka
  • Created — koliko je vjerodajnica stvoreno
  • Failed — koliko je redaka neuspjelo
  • Remaining — koliko je redaka još u redu čekanja

Tablice Created, Failed i Pending uživo se pune ispod trake dok se skupina obrađuje.

Pauziranje i nastavak ​

  • Kliknite Pause za privremeno zaustavljanje obrade. Dok je pauzirano, ne stvaraju se nove vjerodajnice.
  • Kliknite Resume za nastavak od mjesta na kojem ste stali.

Otkazivanje ​

  • Kliknite Cancel za potpuno zaustavljanje obrade. Već stvorene vjerodajnice se zadržavaju.

Obrada pogrešaka ​

Kad redak ne uspije zbog razloga specifičnog za taj redak (npr. nevaljana vrijednost koju pozadinski sustav odbije):

  • Pogreška se bilježi uz taj redak
  • Obrada automatski nastavlja sa sljedećim retkom
  • Neuspjeli reci prikupljaju se za korak rezultata, a tekst pogreške prikazuje se u tablici neuspjeha na zaslonu

Reci ograničeni ograničenjem učestalosti automatski se ponovno pokušavaju uz kratko odgađanje. Pogreška kredita ili kvote drugačija je — umjesto da se nastavi dalje, skupina se pauzira kako ne biste potrošili ostatak datoteke. Pojavljuje se crvena obavijest "Insufficient credits"; nadoplatite kredite ili nadogradite plan, zatim kliknite Resume za nastavak od mjesta na kojem je stalo.

Oporavak nakon osvježavanja stranice ​

Ako tijekom obrade slučajno zatvorite preglednik ili osvježite stranicu, sesija skupnih vjerodajnica oporavlja se kad se vratite. Napredak se nastavlja od mjesta na kojem je stao.

Korak 4: Rezultati ​

Nakon što se obrada završi (ili otkaže), zaslon rezultata prikazuje četiri sažete kartice:

  • Total — broj primatelja u skupini
  • Created — broj stvorenih vjerodajnica
  • Failed — broj neuspjelih redaka
  • Skipped — primatelji koji nisu obrađeni (npr. preostali reci nakon otkazivanja)

Ispod kartica tablica Created navodi svaku novu vjerodajnicu s poveznicom za pregled, a tablica Failed navodi neuspjehe s tekstom pogreške.

Preuzimanje izvješća ​

  • Download Results CSV — svaki redak u skupini, sa stupcima row, name, email, status, award_url (URL vjerodajnice ispunjen je za stvorene retke).
  • Download Failures CSV — samo neuspjeli reci, sa stupcima name, email, error.

Ponovni pokušaj neuspjelih ​

Ako su neki reci neuspjeli, kliknite Retry Failures. Time se pokreće novi prolaz samo preko neuspjelih primatelja — nije potrebno ponovno učitavati CSV. Praktično je nakon rješavanja privremenog problema, poput nadoplate kredita nakon pauzirane skupine.

badges.ninja Documentation