Skip to content

Masstunnistused ​

Masstunnistused võimaldavad sul CSV-faili üleslaadimisega väljastada digitaalseid märke sadadele või tuhandetele saajatele korraga. Protsess koosneb neljast sammust, millel on sisseehitatud edenemise jälgimine, peatamine/jätkamine ja veakäsitlus.

Ülevaade ​

Masstunnistuste protsess koosneb neljast sammust:

  1. Konfigureerimine — vali märk ja valikud
  2. Üleslaadimine — valmista ette ja laadi üles oma CSV-fail
  3. Töötlemine — jälgi edenemist, kui tunnistusi luuakse
  4. Tulemused — vaata tulemusi üle ja laadi alla aruanded

1. samm: konfigureerimine ​

Bulk Awards — step 1, configure

  1. Ava külgribalt leht Bulk Credentials (omaette marsruut, eraldi Credentials-lehest).
  2. Vali märgivalija abil märk, mida soovid väljastada.
  3. Soovi korral seadista:
    • Issued On — kuupäev, mida kasutatakse kõigi tunnistuste jaoks (vaikimisi täna)
    • Expires — kõigi tunnistuste valikuline aegumiskuupäev
    • Send Email — kas saata igale saajale pärast tema tunnistuse loomist automaatselt e-kiri
  4. Klõpsa Next.

2. samm: CSV üleslaadimine ​

Bulk Awards — step 2, upload

CSV vorming ​

CSV-failil peab olema veerg name ja veerg email ning päisrida. Päiste nimed ei erista suur- ja väiketähti ning recipient_name / recipient_email on aktsepteeritud aliastena nimedele name / email.

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

Malli allalaadimine ​

Klõpsa Download Template, et saada tühi CSV-fail õigete päistega. Täida see oma saajatega ja laadi üles.

Üleslaadimine ​

  1. Klõpsa Upload CSV või lohista fail sinna.
  2. Fail valideeritakse enne töötlemise algust.

Valideerimisreeglid ​

Iga rida valideeritakse kohe pärast faili parsimist:

  • Nimi peab olema vähemalt 5 tähemärki
  • E-post peab olema kehtiv e-posti aadress
  • Tühjad read jäetakse vahele

Eelvaatetabelis on iga rea juures roheline linnuke või punane põhjus. Kehtetud read ei takista jätkamist — need lihtsalt jäetakse vahele ning loendur näitab, mitu kehtivat saajat töödeldakse (nt „18 valid recipients, 2 invalid (will be skipped)"). Võid jätkata, kui vähemalt üks rida on kehtiv; pole vaja kõigepealt parandada ja uuesti üles laadida.

  1. Töötlemise alustamiseks klõpsa Next.

3. samm: töötlemine ​

Kui töötlemine algab, näed edenemisriba ja reaalajas loendureid:

  • Edenemisriba — töödeldud ridade protsent
  • Created — mitu tunnistust on loodud
  • Failed — mitu rida on ebaõnnestunud
  • Remaining — mitu rida on veel järjekorras

Riba all täituvad partii töötamise ajal reaalajas tabelid Created, Failed ja Pending.

Paus ja jätkamine ​

  • Klõpsa Pause, et töötlemine ajutiselt peatada. Pausi ajal uusi tunnistusi ei looda.
  • Klõpsa Resume, et jätkata sealt, kus pooleli jäid.

Tühistamine ​

  • Klõpsa Cancel, et töötlemine täielikult peatada. Juba loodud tunnistused jäävad alles.

Veakäsitlus ​

Kui rida ebaõnnestub reaspetsiifilisel põhjusel (nt taustasüsteemi poolt tagasi lükatud kehtetu väärtus):

  • Viga salvestatakse selle rea juurde
  • Töötlemine jätkub automaatselt järgmise reaga
  • Ebaõnnestunud read kogutakse tulemuste sammu jaoks ning nende veateade kuvatakse ekraanil ebaõnnestumiste tabelis

Kiiruspiirangu tõttu ebaõnnestunud ridu proovitakse automaatselt uuesti lühikese viivitusega. Krediidi- või kvoodiviga on teistsugune — edasi liikumise asemel partii peatatakse, et sa ei kulutaks ülejäänud faili ära. Ilmub punane teade „Insufficient credits"; lisa krediiti või uuenda plaani ning klõpsa seejärel Resume, et jätkata sealt, kus pooleli jäi.

Lehe värskendamisega taastamine ​

Kui sulged töötlemise ajal kogemata brauseri või värskendad lehte, taastatakse masstunnistuste seanss sinu naasmisel. Edenemine jätkub sealt, kus pooleli jäi.

4. samm: tulemused ​

Pärast töötlemise lõppu (või tühistamist) kuvab tulemuste ekraan nelja kokkuvõttekaarti:

  • Total — saajate arv partiis
  • Created — loodud tunnistuste arv
  • Failed — ebaõnnestunud ridade arv
  • Skipped — töötlemata jäänud saajad (nt ülejäänud read pärast tühistamist)

Kaartide all loetleb tabel Created iga uue tunnistuse koos vaatamislingiga ning tabel Failed ebaõnnestumised koos veateatega.

Aruannete allalaadimine ​

  • Download Results CSV — partii kõik read veergudega row, name, email, status, award_url (loodud ridade puhul on tunnistuse URL täidetud).
  • Download Failures CSV — ainult ebaõnnestunud read veergudega name, email, error.

Ebaõnnestumiste uuesti proovimine ​

Kui mõned read ebaõnnestusid, klõpsa Retry Failures. See alustab uut läbimist ainult ebaõnnestunud saajatega — CSV-d pole vaja uuesti üles laadida. See on abiks pärast ajutise probleemi lahendamist, näiteks krediidi lisamist peatatud partii järel.

badges.ninja Documentation