Skip to content

Bulk Awards

Ang bulk awards ay nagpapahintulot sa inyo na mag-isyu ng badge sa daan-daan o libu-libong tatanggap nang sabay-sabay sa pamamagitan ng pag-upload ng CSV file. May apat na hakbang ang proseso na may kasamang built-in progress tracking, pause/resume, at error handling.

Pangkalahatang-ideya

Sumusunod ang bulk award process sa apat na hakbang:

  1. Configure — piliin ang badge at mga opsyon
  2. Upload — ihanda at i-upload ang inyong CSV file
  3. Process — bantayan ang progress habang ginagawa ang mga award
  4. Results — suriin ang mga resulta at i-download ang mga ulat

Hakbang 1: Configure

Bulk Awards — hakbang 1, configure

  1. Buksan ang pahina ng Awards mula sa sidebar.
  2. I-click ang Bulk Award.
  3. Piliin ang badge na gusto ninyong ibigay gamit ang badge picker.
  4. Opsyonal na i-configure:
    • Issued On — ang petsa na gagamitin para sa lahat ng award (default ngayong araw)
    • Expires — opsyonal na petsa ng pag-expire para sa lahat ng award
    • Send Email — kung awtomatiko bang mag-email sa bawat tatanggap pagkatapos magawa ang kanilang award
  5. I-click ang Susunod.

Hakbang 2: Upload CSV

Bulk Awards — hakbang 2, upload

Format ng CSV

Ang CSV file ay dapat may dalawang column: name at email. Ang unang row ay dapat header.

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

I-download ang Template

I-click ang Download Template para makakuha ng blangkong CSV file na may tamang headers. Punan ito ng inyong mga tatanggap at i-upload ito.

Upload

  1. I-click ang Upload CSV o i-drag at i-drop ang inyong file.
  2. Ang file ay vina-validate bago magsimula ang pagproseso.

Mga Validation Rule

Bawat row ay vina-validate:

  • Ang Pangalan ay dapat hindi bababa sa 5 character
  • Ang Email ay dapat balidong email address
  • Ang mga duplicate email sa loob ng file ay namamarkahan
  • Ang mga walang lamang row ay nilalaktawan

Kung may nakitang validation errors, ipinapakita ang mga ito na may row numbers. Ayusin ang mga isyu sa inyong CSV at mag-upload muli.

  1. I-click ang Susunod para magsimulang magproseso.

Hakbang 3: Pagproseso

Kapag nagsimula ang pagproseso, makakakita kayo ng progress bar at live status:

  • Progress bar — nagpapakita ng porsyento ng mga row na naproseso
  • Kasalukuyang row — kung anong row ang kasalukuyang prinoproseso
  • Success count — kung ilang award ang nagawa
  • Error count — kung ilang row ang nabigo

Pause at Resume

  • I-click ang Pause para pansamantalang ihinto ang pagproseso. Walang bagong award na ginagawa habang naka-pause.
  • I-click ang Resume para magpatuloy mula sa kung saan kayo huminto.

Cancel

  • I-click ang Cancel para ihinto ang pagproseso nang ganap. Ang mga award na nagawa na ay pinapanatili.

Pag-handle ng Error

Kapag nabigo ang isang row (hal. invalid na data, naabot ang buwanang quota ng award):

  • Ang error ay nilo-log na may detalye
  • Patuloy na nagpoproseso sa susunod na row nang awtomatiko
  • Ang mga nabigong row ay tinitipon para sa hakbang ng mga resulta

Page Refresh Recovery

Kung hindi sinasadyang isinara ninyo ang browser o ni-refresh ang pahina habang nagpoproseso, ang bulk award session ay nare-recover kapag kayo ay bumalik. Magpapatuloy ang progress mula sa kung saan ito huminto.

Hakbang 4: Mga Resulta

Pagkatapos makumpleto ang pagproseso (o nakansela), ipinapakita ng results screen ang:

  • Kabuuang naproseso — bilang ng mga row na sinubukan
  • Matagumpay — bilang ng mga award na nagawa
  • Nabigo — bilang ng mga row na nabigo

I-download ang mga Ulat

  • I-download ang Success CSV — isang CSV ng lahat ng matagumpay na nagawang award na may mga pangalan ng tatanggap, email, at verification URL
  • I-download ang Failure CSV — isang CSV ng lahat ng nabigong row na may detalye ng error

Subukan Muli ang mga Failure

Kung may ilang row na nabigo, maaari ninyong i-download ang failure CSV, ayusin ang mga isyu, at i-upload itong muli bilang bagong bulk award para subukang muli ang mga tatanggap na iyon.

badges.ninja Documentation