Skip to content

Tömeges tanúsítványok ​

A tömeges tanúsítványokkal CSV-fájl feltöltésével egyszerre több száz vagy ezer címzettnek állíthatsz ki jelvényeket. A folyamat négy lépésből áll, beépített előrehaladás-követéssel, szüneteltetéssel/folytatással és hibakezeléssel.

Áttekintés ​

A tömeges tanúsítványok folyamata négy lépésből áll:

  1. Beállítás — válaszd ki a jelvényt és az opciókat
  2. Feltöltés — készítsd elő és töltsd fel a CSV-fájlt
  3. Feldolgozás — kövesd az előrehaladást, ahogy a tanúsítványok létrejönnek
  4. Eredmények — nézd át a kimeneteleket és tölts le jelentéseket

1. lépés: Beállítás ​

Bulk Awards — step 1, configure

  1. Nyisd meg a Bulk Credentials oldalt az oldalsávból (saját útvonala van, külön a Credentials oldaltól).
  2. A jelvényválasztóval válaszd ki a kiállítani kívánt jelvényt.
  3. Igény szerint állítsd be:
    • Issued On — az összes tanúsítványnál használt dátum (alapértelmezés szerint a mai nap)
    • Expires — opcionális lejárati dátum az összes tanúsítványhoz
    • Send Email — automatikusan kapjon-e e-mailt minden címzett a tanúsítványa létrehozása után
  4. Kattints a Next gombra.

2. lépés: CSV feltöltése ​

Bulk Awards — step 2, upload

CSV-formátum ​

A CSV-fájlnak tartalmaznia kell egy name és egy email oszlopot, fejlécsorral. A fejlécnevek kis- és nagybetűre nem érzékenyek, a recipient_name / recipient_email pedig a name / email aliasaként is elfogadott.

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

Sablon letöltése ​

A Download Template gombra kattintva üres CSV-fájlt kapsz a megfelelő fejlécekkel. Töltsd ki a címzettekkel, majd töltsd fel.

Feltöltés ​

  1. Kattints az Upload CSV gombra, vagy húzd rá a fájlt.
  2. A fájlt a feldolgozás megkezdése előtt ellenőrizzük.

Ellenőrzési szabályok ​

Minden sort azonnal ellenőrzünk, amint a fájl feldolgozásra került:

  • A Name legalább 5 karakter hosszú legyen
  • Az Email érvényes e-mail-cím legyen
  • Az üres sorokat kihagyjuk

Az előnézeti táblázat minden sort zöld pipával vagy piros indokkal listáz. Az érvénytelen sorok nem akadályt jelentenek — egyszerűen kihagyjuk őket, a számláló pedig mutatja, hány érvényes címzett lesz feldolgozva (pl. "18 valid recipients, 2 invalid (will be skipped)"). Addig folytathatod, amíg legalább egy sor érvényes; nem kell előbb kijavítani és újra feltölteni.

  1. A feldolgozás megkezdéséhez kattints a Next gombra.

3. lépés: Feldolgozás ​

A feldolgozás indulása után folyamatjelző sávot és élő számlálókat látsz:

  • Folyamatjelző sáv — a feldolgozott sorok százaléka
  • Created — hány tanúsítvány jött létre
  • Failed — hány sor hiúsult meg
  • Remaining — hány sor vár még a sorban

A sáv alatt élő Created, Failed és Pending táblázatok töltődnek fel a köteg futása közben.

Szüneteltetés és folytatás ​

  • A Pause gombbal átmenetileg leállíthatod a feldolgozást. Szüneteltetés alatt nem jönnek létre új tanúsítványok.
  • A Resume gombbal onnan folytathatod, ahol abbahagytad.

Megszakítás ​

  • A Cancel gombbal teljesen leállíthatod a feldolgozást. A már létrehozott tanúsítványok megmaradnak.

Hibakezelés ​

Ha egy sor sorspecifikus okból hiúsul meg (pl. a háttérrendszer által elutasított érvénytelen érték):

  • A hibát az adott sornál rögzítjük
  • A feldolgozás automatikusan a következő sorral folytatódik
  • A sikertelen sorokat összegyűjtjük az eredmények lépéséhez, a hibaszövegükkel együtt a képernyőn látható hibatáblázatban

A sebességkorlát miatt elutasított sorokat rövid várakozással automatikusan újrapróbáljuk. A kredit- vagy kvótahiba más eset — a köteg a továbblépés helyett szünetel, hogy ne égesd el a fájl hátralévő részét. Piros "Insufficient credits" értesítés jelenik meg; tölts fel kreditet vagy válts csomagot, majd a Resume gombbal folytasd onnan, ahol megállt.

Helyreállítás oldalfrissítés után ​

Ha feldolgozás közben véletlenül bezárod a böngészőt vagy frissíted az oldalt, a tömeges tanúsítványok munkamenete visszatéréskor helyreáll. Az előrehaladás ott folytatódik, ahol megállt.

4. lépés: Eredmények ​

A feldolgozás befejezése (vagy megszakítása) után az eredményképernyő négy összesítő kártyát mutat:

  • Total — a címzettek száma a kötegben
  • Created — a létrehozott tanúsítványok száma
  • Failed — a sikertelen sorok száma
  • Skipped — fel nem dolgozott címzettek (pl. a megszakítás után megmaradt sorok)

A kártyák alatt a Created táblázat minden új tanúsítványt megtekintési hivatkozással listáz, a Failed táblázat pedig a hibákat a hibaszövegükkel.

Jelentések letöltése ​

  • Download Results CSV — a köteg minden sora, a row, name, email, status, award_url oszlopokkal (a tanúsítvány URL-je a létrehozott soroknál van kitöltve).
  • Download Failures CSV — csak a sikertelen sorok, a name, email, error oszlopokkal.

Sikertelen sorok újrapróbálása ​

Ha néhány sor sikertelen volt, kattints a Retry Failures gombra. Ez új menetet indít csak a sikertelen címzettekre — nem kell újra feltölteni a CSV-t. Jól jön átmeneti hiba elhárítása után, például a kredit feltöltése egy szüneteltetett köteg után.

badges.ninja Documentation