Skip to content

Масови сертификати ​

Масовите сертификати ви позволяват да издадете значки на стотици или хиляди получатели наведнъж чрез качване на CSV файл. Процесът има четири стъпки с вградено проследяване на напредъка, пауза/възобновяване и обработка на грешки.

Общ преглед ​

Процесът на масово издаване на сертификати протича в четири стъпки:

  1. Конфигуриране — изберете значката и опциите
  2. Качване — подгответе и качете своя CSV файл
  3. Обработка — следете напредъка, докато сертификатите се създават
  4. Резултати — прегледайте резултатите и изтеглете отчетите

Стъпка 1: Конфигуриране ​

Масови награди — стъпка 1, конфигуриране

  1. Отворете страницата Масови сертификати от страничното меню (тя има собствен маршрут, отделен от страницата Сертификати).
  2. Изберете значката, която искате да издадете, с помощта на селектора за значки.
  3. По желание конфигурирайте:
    • Издадено на — датата, която да се използва за всички сертификати (по подразбиране днес)
    • Изтича — незадължителна дата на изтичане за всички сертификати
    • Изпращане на имейл — дали да се изпраща автоматично имейл на всеки получател след създаването на неговия сертификат
  4. Щракнете върху Напред.

Стъпка 2: Качване на CSV ​

Масови награди — стъпка 2, качване

CSV формат ​

CSV файлът трябва да има колона name и колона email, както и заглавен ред. Имената на заглавията не зависят от регистъра, а recipient_name / recipient_email се приемат като псевдоними на name / email.

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

Изтегляне на шаблон ​

Щракнете върху Изтегляне на шаблон, за да получите празен CSV файл с правилните заглавия. Попълнете го с вашите получатели и го качете.

Качване ​

  1. Щракнете върху Качване на CSV или плъзнете файла и го пуснете.
  2. Файлът се валидира, преди да започне обработката.

Правила за валидиране ​

Всеки ред се валидира веднага след анализирането на файла:

  • Името трябва да е поне 5 знака
  • Имейлът трябва да е валиден имейл адрес
  • Празните редове се пропускат

Таблицата за преглед показва всеки ред със зелена отметка или с червена причина. Невалидните редове не са пречка — те просто се пропускат, а броячът показва колко валидни получатели ще бъдат обработени (напр. „18 валидни получатели, 2 невалидни (ще бъдат пропуснати)“). Можете да продължите, стига поне един ред да е валиден; не е нужно първо да поправяте и качвате файла отново.

  1. Щракнете върху Напред, за да започне обработката.

Стъпка 3: Обработка ​

След като обработката започне, виждате лента за напредъка и броячи на живо:

  • Лента за напредъка — процентът на обработените редове
  • Създадени — колко сертификата са създадени
  • Неуспешни — колко реда са неуспешни
  • Оставащи — колко реда все още са на опашка

Таблиците на живо Създадени, Неуспешни и Чакащи се попълват под лентата, докато пакетът се обработва.

Пауза и възобновяване ​

  • Щракнете върху Пауза, за да спрете временно обработката. Докато е на пауза, не се създават нови сертификати.
  • Щракнете върху Възобновяване, за да продължите от мястото, на което сте спрели.

Отказ ​

  • Щракнете върху Отказ, за да спрете обработката напълно. Вече създадените сертификати се запазват.

Обработка на грешки ​

Когато ред е неуспешен по причина, свързана с конкретния ред (напр. невалидна стойност, която бекендът отхвърля):

  • Грешката се записва към този ред
  • Обработката автоматично продължава със следващия ред
  • Неуспешните редове се събират за стъпката с резултатите, а текстът на грешката им се показва в таблицата с неуспешни на екрана

Редовете, засегнати от ограничение на честотата, се повтарят автоматично с кратко изчакване. Грешка с кредити или квота е различна — вместо да прескочи напред, пакетът се поставя на пауза, за да не изчерпите остатъка от файла. Появява се червено съобщение „Недостатъчно кредити“; заредете кредити или надстройте плана си, след което щракнете върху Възобновяване, за да продължите от мястото на спирането.

Възстановяване след опресняване на страницата ​

Ако по невнимание затворите браузъра или опресните страницата по време на обработката, сесията за масови сертификати се възстановява, когато се върнете. Напредъкът продължава от мястото, на което е спрял.

Стъпка 4: Резултати ​

След като обработката приключи (или бъде отказана), екранът с резултати показва четири обобщаващи карти:

  • Общо — брой получатели в пакета
  • Създадени — брой създадени сертификати
  • Неуспешни — брой неуспешни редове
  • Пропуснати — необработени получатели (напр. оставащите редове след отказ)

Под картите таблицата Създадени изброява всеки нов сертификат с връзка за преглед, а таблицата Неуспешни изброява неуспехите с текста на грешката им.

Изтегляне на отчети ​

  • Изтегляне на CSV с резултати — всеки ред от пакета, с колони row, name, email, status, award_url (URL адресът на сертификата е попълнен за създадените редове).
  • Изтегляне на CSV с неуспешните — само неуспешните редове, с колони name, email, error.

Повторен опит за неуспешните ​

Ако някои редове са неуспешни, щракнете върху Повторен опит за неуспешните. Това започва нов преглед само на неуспешните получатели — не е нужно да качвате отново CSV. Удобно е след отстраняване на временен проблем, например зареждане на кредити след пакет, поставен на пауза.

badges.ninja Documentation