Chứng chỉ hàng loạt

Chứng chỉ hàng loạt cho phép bạn cấp huy hiệu cho hàng trăm hoặc hàng nghìn người nhận cùng lúc bằng cách tải lên một tệp CSV. Quy trình gồm bốn bước với tính năng theo dõi tiến độ tích hợp, tạm dừng/tiếp tục và xử lý lỗi.

Tổng quan

Quy trình cấp chứng chỉ hàng loạt gồm bốn bước:

1. Cấu hình — chọn huy hiệu và các tùy chọn
2. Tải lên — chuẩn bị và tải lên tệp CSV của bạn
3. Xử lý — theo dõi tiến độ khi các chứng chỉ được tạo
4. Kết quả — xem lại kết quả và tải xuống báo cáo

Bước 1: Cấu hình

1. Mở trang Chứng chỉ hàng loạt từ thanh bên (đây là một trang riêng, tách biệt với trang Chứng chỉ).
2. Chọn huy hiệu bạn muốn cấp bằng bộ chọn huy hiệu.
3. Tùy chọn cấu hình:
   • Ngày cấp — ngày áp dụng cho tất cả chứng chỉ (mặc định là hôm nay)
   • Hết hạn — ngày hết hạn tùy chọn cho tất cả chứng chỉ
   • Gửi email — có tự động gửi email cho từng người nhận sau khi chứng chỉ của họ được tạo hay không
4. Nhấp Tiếp theo.

Bước 2: Tải lên CSV

Định dạng CSV

Tệp CSV phải có cột name và cột email, kèm một dòng tiêu đề. Tên tiêu đề không phân biệt chữ hoa chữ thường, và recipient_name / recipient_email được chấp nhận làm bí danh của name / email.

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

Tải xuống mẫu

Nhấp Tải xuống mẫu để nhận một tệp CSV trống với các tiêu đề chính xác. Điền danh sách người nhận của bạn vào rồi tải lên.

Tải lên

1. Nhấp Tải lên CSV hoặc kéo và thả tệp của bạn.
2. Tệp được kiểm tra hợp lệ trước khi bắt đầu xử lý.

Quy tắc kiểm tra

Mỗi dòng được kiểm tra ngay khi tệp được phân tích:

• Tên phải có ít nhất 5 ký tự
• Email phải là địa chỉ email hợp lệ
• Các dòng trống sẽ bị bỏ qua

Bảng xem trước liệt kê mọi dòng kèm dấu tích xanh hoặc lý do màu đỏ. Các dòng không hợp lệ không gây cản trở — chúng chỉ đơn giản bị bỏ qua, và bộ đếm cho biết có bao nhiêu người nhận hợp lệ sẽ được xử lý (ví dụ: "18 người nhận hợp lệ, 2 không hợp lệ (sẽ bị bỏ qua)"). Bạn có thể tiếp tục miễn là có ít nhất một dòng hợp lệ; không cần phải sửa và tải lên lại trước.

3. Nhấp Tiếp theo để bắt đầu xử lý.

Bước 3: Xử lý

Khi quá trình xử lý bắt đầu, bạn sẽ thấy thanh tiến độ và các bộ đếm trực tiếp:

• Thanh tiến độ — phần trăm số dòng đã xử lý
• Đã tạo — số chứng chỉ đã được tạo
• Thất bại — số dòng bị lỗi
• Còn lại — số dòng vẫn đang chờ trong hàng đợi

Các bảng Đã tạo, Thất bại và Đang chờ trực tiếp được điền dần bên dưới thanh tiến độ khi lô được xử lý.

Tạm dừng và tiếp tục

• Nhấp Tạm dừng để dừng xử lý tạm thời. Không có chứng chỉ mới nào được tạo khi đang tạm dừng.
• Nhấp Tiếp tục để tiếp tục từ chỗ bạn đã dừng.

Hủy

• Nhấp Hủy để dừng hoàn toàn quá trình xử lý. Các chứng chỉ đã được tạo sẽ được giữ lại.

Xử lý lỗi

Khi một dòng bị lỗi vì lý do riêng của dòng đó (ví dụ: giá trị không hợp lệ mà backend từ chối):

• Lỗi được ghi lại cho dòng đó
• Quá trình xử lý tự động tiếp tục sang dòng kế tiếp
• Các dòng lỗi được thu thập cho bước kết quả, với nội dung lỗi hiển thị trong bảng lỗi trên màn hình

Các dòng bị giới hạn tốc độ sẽ được tự động thử lại sau một khoảng chờ ngắn. Lỗi về tín dụng hoặc hạn mức thì khác — thay vì bỏ qua, lô sẽ tạm dừng để bạn không tiêu hết phần còn lại của tệp. Một thông báo màu đỏ "Không đủ tín dụng" sẽ xuất hiện; hãy nạp thêm hoặc nâng cấp gói, rồi nhấp Tiếp tục để tiếp tục từ chỗ đã dừng.

Khôi phục khi làm mới trang

Nếu bạn vô tình đóng trình duyệt hoặc làm mới trang trong khi đang xử lý, phiên cấp chứng chỉ hàng loạt sẽ được khôi phục khi bạn quay lại. Tiến độ sẽ tiếp tục từ chỗ đã dừng.

Bước 4: Kết quả

Sau khi quá trình xử lý hoàn tất (hoặc bị hủy), màn hình kết quả hiển thị bốn thẻ tóm tắt:

• Tổng — số người nhận trong lô
• Đã tạo — số chứng chỉ đã tạo
• Thất bại — số dòng bị lỗi
• Bỏ qua — những người nhận chưa được xử lý (ví dụ: các dòng còn lại sau khi hủy)

Bên dưới các thẻ, bảng Đã tạo liệt kê từng chứng chỉ mới kèm liên kết để xem, còn bảng Thất bại liệt kê các lỗi kèm nội dung lỗi.

Tải xuống báo cáo

• Tải xuống CSV kết quả — mọi dòng trong lô, với các cột row, name, email, status, award_url (URL chứng chỉ được điền cho các dòng đã tạo).
• Tải xuống CSV lỗi — chỉ các dòng bị lỗi, với các cột name, email, error.

Thử lại các dòng lỗi

Nếu một số dòng bị lỗi, hãy nhấp Thử lại các dòng lỗi. Thao tác này bắt đầu một lượt xử lý mới chỉ dành cho những người nhận bị lỗi — không cần tải lại CSV. Rất tiện sau khi khắc phục sự cố tạm thời, chẳng hạn nạp thêm tín dụng sau khi một lô bị tạm dừng.