Bulk Credentials

Hinahayaan ka ng bulk credentials na mag-isyu ng badge sa daan-daan o libo-libong tatanggap nang sabay-sabay sa pamamagitan ng pag-upload ng CSV file. May apat na hakbang ang proseso na may built-in na progress tracking, pause/resume, at error handling.

Overview

Ang proseso ng bulk credential ay may apat na hakbang:

1. Configure — piliin ang badge at mga opsyon
2. Upload — ihanda at i-upload ang inyong CSV file
3. Process — subaybayan ang progress habang ginagawa ang mga kredensyal
4. Results — suriin ang mga kinalabasan at i-download ang mga report

Hakbang 1: Configure

1. Buksan ang Bulk Credentials page mula sa sidebar (may sarili itong route, hiwalay sa Credentials page).
2. Piliin ang badge na gusto ninyong i-isyu gamit ang badge picker.
3. Opsyonal na i-configure ang:
   • Issued On — ang petsang gagamitin para sa lahat ng kredensyal (default ay ngayong araw)
   • Expires — opsyonal na expiration date para sa lahat ng kredensyal
   • Send Email — kung awtomatikong i-eemail ang bawat tatanggap pagkatapos magawa ang kanilang kredensyal
4. I-click ang Next.

Hakbang 2: Upload CSV

CSV Format

Dapat may name column at email column ang CSV file, na may header row. Hindi case-sensitive ang mga header name, at tinatanggap ang recipient_name / recipient_email bilang alias ng name / email.

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 mga header. Punan ito ng inyong mga tatanggap at i-upload.

Upload

1. I-click ang Upload CSV o i-drag and drop ang inyong file.
2. Dumadaan sa validation ang file bago magsimula ang processing.

Mga Panuntunan sa Validation

Dumadaan sa validation ang bawat row sa sandaling na-parse ang file:

• Ang Name ay dapat hindi bababa sa 5 character
• Ang Email ay dapat valid na email address
• Nilalaktawan ang mga walang laman na row

Inililista ng preview table ang bawat row na may berdeng check o pulang dahilan. Hindi hadlang ang mga invalid na row — nilalaktawan lang ang mga ito, at ipinapakita ng counter kung ilang valid na tatanggap ang ipoproseso (hal. "18 valid recipients, 2 invalid (will be skipped)"). Maaari kayong magpatuloy basta may kahit isang valid na row; hindi na kailangang ayusin at i-upload muli.

3. I-click ang Next para simulan ang processing.

Hakbang 3: Processing

Kapag nagsimula na ang processing, makikita ninyo ang progress bar at mga live counter:

• Progress bar — ang porsyento ng mga row na naproseso na
• Created — kung ilang kredensyal na ang nagawa
• Failed — kung ilang row ang pumalya
• Remaining — kung ilang row ang nasa pila pa

Pumupuno sa ilalim ng bar ang mga live na Created, Failed, at Pending table habang tumatakbo ang batch.

Pause at Resume

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

Cancel

• I-click ang Cancel para tuluyang ihinto ang processing. Mananatili ang mga kredensyal na nagawa na.

Error Handling

Kapag pumalya ang isang row dahil sa dahilang partikular sa row (hal. invalid na value na tinanggihan ng backend):

• Itinatala ang error sa row na iyon
• Awtomatikong nagpapatuloy ang processing sa susunod na row
• Kinokolekta ang mga pumalyang row para sa results step, kasama ang error text na ipinapakita sa on-screen failures table

Awtomatikong nire-retry ang mga rate-limited na row nang may maikling back-off. Iba ang credits o quota error — sa halip na lumaktaw, nagpa-pause ang batch para hindi maubos ang credits sa natitirang bahagi ng file. Lalabas ang pulang "Insufficient credits" notice; mag-top up o mag-upgrade, saka i-click ang Resume para magpatuloy mula sa kung saan ito huminto.

Page Refresh Recovery

Kung hindi sinasadyang naisara ninyo ang browser o na-refresh ang page habang nagpoproseso, mare-recover ang bulk credential session pagbalik ninyo. Magpapatuloy ang progress mula sa kung saan ito huminto.

Hakbang 4: Results

Pagkatapos makumpleto ang processing (o makansela), ipinapakita ng results screen ang apat na summary card:

• Total — bilang ng mga tatanggap sa batch
• Created — bilang ng mga kredensyal na nagawa
• Failed — bilang ng mga row na pumalya
• Skipped — mga tatanggap na hindi naproseso (hal. mga natirang row pagkatapos ng cancel)

Sa ilalim ng mga card, inililista ng Created table ang bawat bagong kredensyal na may link para tingnan ito, at inililista ng Failed table ang mga pagkabigo kasama ang error text ng mga ito.

I-download ang mga Report

• Download Results CSV — bawat row sa batch, na may mga column na row, name, email, status, award_url (pinupunan ang credential URL para sa mga row na nagawa).
• Download Failures CSV — ang mga pumalyang row lang, na may mga column na name, email, error.

Retry Failures

Kung may mga row na pumalya, i-click ang Retry Failures. Magsisimula ito ng bagong pass para sa mga pumalyang tatanggap lang — hindi na kailangang mag-upload muli ng CSV. Madaling gamitin pagkatapos ayusin ang pansamantalang problema, gaya ng pag-top up ng credits matapos ma-pause ang batch.