Skip to content

Масові нагороди

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

Огляд

Процес масової видачі проходить у чотири кроки:

  1. Налаштування — оберіть значок і параметри
  2. Завантаження — підготуйте та завантажте CSV-файл
  3. Обробка — відстежуйте прогрес у міру створення нагород
  4. Результати — перегляньте підсумки та завантажте звіти

Крок 1. Налаштування

Масові нагороди — крок 1, налаштування

  1. Відкрийте сторінку Awards у бічному меню.
  2. Натисніть Bulk Award.
  3. Оберіть значок через селектор.
  4. За бажанням налаштуйте:
    • Issued On — дата для всіх нагород (за замовчуванням сьогодні)
    • Expires — опційна дата закінчення для всіх нагород
    • Send Email — чи надсилати автоматично кожному одержувачу лист після створення нагороди
  5. Натисніть Next.

Крок 2. Завантаження CSV

Масові нагороди — крок 2, завантаження

Формат CSV

CSV-файл має містити два стовпці: name і email. Перший рядок — заголовок.

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

Завантажити шаблон

Натисніть Download Template, щоб отримати порожній CSV із правильними заголовками. Заповніть його одержувачами та завантажте.

Завантаження

  1. Натисніть Upload CSV або перетягніть файл.
  2. Файл перевіряється до початку обробки.

Правила валідації

Кожен рядок перевіряється:

  • Name має містити щонайменше 5 символів
  • Email має бути коректною адресою
  • Дублікати email-ів усередині файлу позначаються
  • Порожні рядки пропускаються

Якщо знайдено помилки валідації, вони відображаються з номерами рядків. Виправте проблеми в CSV і завантажте знову.

  1. Натисніть Next, щоб почати обробку.

Крок 3. Обробка

Після запуску обробки видно смугу прогресу та поточний статус:

  • Смуга прогресу — відсоток оброблених рядків
  • Поточний рядок — який рядок обробляється
  • Лічильник успіхів — скільки нагород створено
  • Лічильник помилок — скільки рядків не пройшло

Пауза та відновлення

  • Натисніть Pause, щоб тимчасово зупинити обробку. На паузі нові нагороди не створюються.
  • Натисніть Resume, щоб продовжити з місця зупинки.

Скасування

  • Натисніть Cancel, щоб повністю припинити обробку. Уже створені нагороди зберігаються.

Обробка помилок

Коли рядок не проходить (наприклад, неправильні дані або досягнута місячна квота):

  • Помилка логується з подробицями
  • Обробка автоматично переходить до наступного рядка
  • Невдалі рядки збираються для кроку результатів

Відновлення після перезавантаження сторінки

Якщо ви випадково закрили браузер або оновили сторінку під час обробки, сесія масової видачі відновлюється при поверненні. Прогрес продовжується з місця зупинки.

Крок 4. Результати

Після завершення (або скасування) обробки на екрані результатів відображається:

  • Total processed — кількість оброблених рядків
  • Successful — кількість створених нагород
  • Failed — кількість невдалих рядків

Завантажити звіти

  • Download Success CSV — CSV усіх успішно створених нагород з іменами, e-mail та URL-ами підтвердження одержувачів
  • Download Failure CSV — CSV усіх невдалих рядків з подробицями про помилки

Повтор невдалих

Якщо частина рядків не пройшла, можна завантажити CSV невдач, виправити проблеми та завантажити як новий масовий запуск, щоб повторити ці рядки.

badges.ninja Documentation