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