Skip to content

Joukkotodistukset ​

Joukkotodistusten avulla voit myöntää digitaalisia merkkejä sadoille tai tuhansille vastaanottajille kerralla lataamalla CSV-tiedoston. Prosessissa on neljä vaihetta, ja siinä on sisäänrakennettu edistymisen seuranta, tauko/jatkaminen ja virheenkäsittely.

Yleiskatsaus ​

Joukkotodistusprosessi etenee neljässä vaiheessa:

  1. Määritä — valitse merkki ja asetukset
  2. Lataa — valmistele ja lataa CSV-tiedostosi
  3. Käsittele — seuraa edistymistä todistusten luonnin aikana
  4. Tulokset — tarkastele tuloksia ja lataa raportit

Vaihe 1: Määritä ​

Bulk Awards — step 1, configure

  1. Avaa sivupalkista sivu Bulk Credentials (oma reittinsä, erillinen Credentials-sivusta).
  2. Valitse myönnettävä merkki merkkivalitsimella.
  3. Määritä tarvittaessa:
    • Issued On — kaikille todistuksille käytettävä päivämäärä (oletuksena tänään)
    • Expires — valinnainen vanhenemispäivä kaikille todistuksille
    • Send Email — lähetetäänkö kullekin vastaanottajalle automaattisesti sähköposti hänen todistuksensa luonnin jälkeen
  4. Napsauta Next.

Vaihe 2: Lataa CSV ​

Bulk Awards — step 2, upload

CSV-muoto ​

CSV-tiedostossa on oltava sarake name ja sarake email sekä otsikkorivi. Otsikoissa ei ole merkitystä isoilla ja pienillä kirjaimilla, ja recipient_name / recipient_email hyväksytään aliaksina nimille name / email.

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

Lataa malli ​

Napsauta Download Template saadaksesi tyhjän CSV-tiedoston oikeilla otsikoilla. Täytä se vastaanottajillasi ja lataa se.

Lataus ​

  1. Napsauta Upload CSV tai vedä ja pudota tiedosto.
  2. Tiedosto validoidaan ennen käsittelyn alkua.

Validointisäännöt ​

Jokainen rivi validoidaan heti, kun tiedosto on jäsennetty:

  • Nimen on oltava vähintään 5 merkkiä
  • Sähköpostin on oltava kelvollinen sähköpostiosoite
  • Tyhjät rivit ohitetaan

Esikatselutaulukossa jokaisella rivillä on vihreä valintamerkki tai punainen syy. Virheelliset rivit eivät estä jatkamista — ne vain ohitetaan, ja laskuri näyttää, kuinka monta kelvollista vastaanottajaa käsitellään (esim. "18 valid recipients, 2 invalid (will be skipped)"). Voit jatkaa, kunhan vähintään yksi rivi on kelvollinen; sinun ei tarvitse ensin korjata ja ladata uudelleen.

  1. Aloita käsittely napsauttamalla Next.

Vaihe 3: Käsittely ​

Kun käsittely alkaa, näet edistymispalkin ja reaaliaikaiset laskurit:

  • Edistymispalkki — käsiteltyjen rivien prosenttiosuus
  • Created — kuinka monta todistusta on luotu
  • Failed — kuinka moni rivi on epäonnistunut
  • Remaining — kuinka moni rivi on vielä jonossa

Reaaliaikaiset taulukot Created, Failed ja Pending täyttyvät palkin alla erän edetessä.

Tauko ja jatkaminen ​

  • Napsauta Pause pysäyttääksesi käsittelyn tilapäisesti. Tauon aikana uusia todistuksia ei luoda.
  • Napsauta Resume jatkaaksesi siitä, mihin jäit.

Peruuttaminen ​

  • Napsauta Cancel pysäyttääksesi käsittelyn kokonaan. Jo luodut todistukset säilyvät.

Virheenkäsittely ​

Kun rivi epäonnistuu riville ominaisesta syystä (esim. taustajärjestelmän hylkäämä virheellinen arvo):

  • Virhe tallennetaan kyseiselle riville
  • Käsittely jatkuu automaattisesti seuraavaan riviin
  • Epäonnistuneet rivit kerätään tulosvaiheeseen, ja niiden virheteksti näytetään ruudulla epäonnistumistaulukossa

Nopeusrajoitetut rivit yritetään automaattisesti uudelleen lyhyellä viiveellä. Krediitti- tai kiintiövirhe on erilainen — eteenpäin siirtymisen sijaan erä keskeytetään, jotta et kuluta loppua tiedostoa turhaan. Näkyviin tulee punainen ilmoitus "Insufficient credits"; lisää krediittejä tai päivitä tilaus ja napsauta sitten Resume jatkaaksesi siitä, mihin erä pysähtyi.

Sivun päivityksestä palautuminen ​

Jos suljet selaimen vahingossa tai päivität sivun käsittelyn aikana, joukkotodistusistunto palautetaan, kun palaat. Edistyminen jatkuu siitä, mihin se jäi.

Vaihe 4: Tulokset ​

Kun käsittely on valmis (tai peruutettu), tulosnäkymä näyttää neljä yhteenvetokorttia:

  • Total — erän vastaanottajien määrä
  • Created — luotujen todistusten määrä
  • Failed — epäonnistuneiden rivien määrä
  • Skipped — käsittelemättä jääneet vastaanottajat (esim. peruutuksen jälkeen jäljellä olevat rivit)

Korttien alla Created-taulukko luettelee jokaisen uuden todistuksen ja linkin sen katseluun, ja Failed-taulukko luettelee epäonnistumiset virhetekstineen.

Raporttien lataus ​

  • Download Results CSV — erän jokainen rivi sarakkeilla row, name, email, status, award_url (todistuksen URL täytetään luoduille riveille).
  • Download Failures CSV — vain epäonnistuneet rivit sarakkeilla name, email, error.

Epäonnistumisten uudelleenyritys ​

Jos jotkin rivit epäonnistuivat, napsauta Retry Failures. Tämä aloittaa uuden läpikäynnin pelkästään epäonnistuneille vastaanottajille — CSV:tä ei tarvitse ladata uudelleen. Siitä on hyötyä, kun tilapäinen ongelma on korjattu, esimerkiksi krediittien lisäämisen jälkeen keskeytetyn erän yhteydessä.

badges.ninja Documentation