Kredensial Pukal

Kredensial pukal membolehkan anda mengeluarkan lencana kepada ratusan atau ribuan penerima sekaligus dengan memuat naik fail CSV. Prosesnya mempunyai empat langkah dengan penjejakan kemajuan terbina dalam, jeda/sambung semula dan pengendalian ralat.

Gambaran Keseluruhan

Proses kredensial pukal mengikut empat langkah:

1. Konfigurasi — pilih lencana dan pilihan
2. Muat naik — sediakan dan muat naik fail CSV anda
3. Proses — pantau kemajuan semasa kredensial dicipta
4. Keputusan — semak hasil dan muat turun laporan

Langkah 1: Konfigurasi

1. Buka halaman Kredensial Pukal dari bar sisi (laluannya sendiri, berasingan daripada halaman Kredensial).
2. Pilih lencana yang ingin anda keluarkan menggunakan pemilih lencana.
3. Secara pilihan, konfigurasikan:
   • Dikeluarkan Pada — tarikh yang digunakan untuk semua kredensial (lalai ialah hari ini)
   • Tamat Tempoh — tarikh tamat tempoh pilihan untuk semua kredensial
   • Hantar E-mel — sama ada untuk menghantar e-mel secara automatik kepada setiap penerima selepas kredensial mereka dicipta
4. Klik Seterusnya.

Langkah 2: Muat Naik CSV

Format CSV

Fail CSV mesti mempunyai lajur name dan lajur email, dengan baris pengepala. Nama pengepala tidak sensitif huruf besar/kecil, dan recipient_name / recipient_email diterima sebagai alias bagi name / email.

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

Muat Turun Templat

Klik Muat Turun Templat untuk mendapatkan fail CSV kosong dengan pengepala yang betul. Isikan dengan penerima anda dan muat naikkannya.

Muat Naik

1. Klik Muat Naik CSV atau seret dan lepas fail anda.
2. Fail disahkan sebelum pemprosesan bermula.

Peraturan Pengesahan

Setiap baris disahkan sebaik sahaja fail dihuraikan:

• Nama mesti sekurang-kurangnya 5 aksara
• E-mel mesti alamat e-mel yang sah
• Baris kosong dilangkau

Jadual pratonton menyenaraikan setiap baris dengan tanda semak hijau atau sebab berwarna merah. Baris tidak sah bukan penghalang — ia hanya dilangkau, dan pembilang menunjukkan berapa ramai penerima sah yang akan diproses (cth. "18 penerima sah, 2 tidak sah (akan dilangkau)"). Anda boleh meneruskan selagi sekurang-kurangnya satu baris sah; tidak perlu membetulkan dan memuat naik semula terlebih dahulu.

3. Klik Seterusnya untuk memulakan pemprosesan.

Langkah 3: Pemprosesan

Sebaik sahaja pemprosesan bermula, anda akan melihat bar kemajuan dan pembilang langsung:

• Bar kemajuan — peratusan baris yang telah diproses
• Dicipta — berapa banyak kredensial telah dicipta
• Gagal — berapa banyak baris gagal
• Berbaki — berapa banyak baris masih dalam baris gilir

Jadual Dicipta, Gagal dan Belum selesai secara langsung terisi di bawah bar semasa kelompok berjalan.

Jeda dan Sambung Semula

• Klik Jeda untuk menghentikan pemprosesan buat sementara. Tiada kredensial baharu dicipta semasa dijeda.
• Klik Sambung semula untuk meneruskan dari tempat anda berhenti.

Batal

• Klik Batal untuk menghentikan pemprosesan sepenuhnya. Kredensial yang telah dicipta dikekalkan.

Pengendalian Ralat

Apabila sesuatu baris gagal atas sebab khusus baris (cth. nilai tidak sah yang ditolak oleh bahagian belakang):

• Ralat direkodkan pada baris tersebut
• Pemprosesan diteruskan ke baris seterusnya secara automatik
• Baris yang gagal dikumpulkan untuk langkah keputusan, dengan teks ralatnya dipaparkan dalam jadual kegagalan di skrin

Baris yang dihadkan kadar dicuba semula secara automatik dengan jeda singkat. Ralat kredit atau kuota adalah berbeza — daripada terus melangkau, kelompok akan dijeda supaya anda tidak menghabiskan baki fail. Notis merah "Kredit tidak mencukupi" akan muncul; tambah nilai atau naik taraf, kemudian klik Sambung semula untuk meneruskan dari tempat ia berhenti.

Pemulihan Selepas Muat Semula Halaman

Jika anda tertutup pelayar secara tidak sengaja atau memuat semula halaman semasa pemprosesan, sesi kredensial pukal dipulihkan apabila anda kembali. Kemajuan disambung semula dari tempat ia berhenti.

Langkah 4: Keputusan

Selepas pemprosesan selesai (atau dibatalkan), skrin keputusan menunjukkan empat kad ringkasan:

• Jumlah — bilangan penerima dalam kelompok
• Dicipta — bilangan kredensial yang dicipta
• Gagal — bilangan baris yang gagal
• Dilangkau — penerima yang tidak diproses (cth. baki baris selepas pembatalan)

Di bawah kad, jadual Dicipta menyenaraikan setiap kredensial baharu dengan pautan untuk melihatnya, dan jadual Gagal menyenaraikan kegagalan beserta teks ralatnya.

Muat Turun Laporan

• Muat Turun CSV Keputusan — setiap baris dalam kelompok, dengan lajur row, name, email, status, award_url (URL kredensial diisi untuk baris yang dicipta).
• Muat Turun CSV Kegagalan — baris yang gagal sahaja, dengan lajur name, email, error.

Cuba Semula Kegagalan

Jika sesetengah baris gagal, klik Cuba Semula Kegagalan. Ini memulakan pusingan baharu untuk penerima yang gagal sahaja — tidak perlu memuat naik semula CSV. Ia berguna selepas membetulkan isu sementara seperti menambah kredit selepas kelompok dijeda.