Skip to content

批次頒發

批次頒發讓你透過上傳 CSV 檔,一次頒發給數百至數千位接收者。整個流程分四個步驟,內建進度追蹤、暫停/恢復與錯誤處理。

概覽

批次頒發流程包含四個步驟:

  1. 設定 — 選擇徽章與選項
  2. 上傳 — 準備並上傳 CSV 檔
  3. 處理 — 在頒發建立過程中監看進度
  4. 結果 — 檢視結果並下載報表

步驟 1:設定

批次頒發 — 步驟 1,設定

  1. 從側邊欄開啟 頒發記錄 頁面。
  2. 點按 批次頒發
  3. 透過徽章選取器選擇要頒發的徽章。
  4. 可選擇性設定:
    • 頒發日期 — 用於所有頒發的日期(預設為今天)
    • 到期日 — 所有頒發的選填到期日
    • 寄送電子郵件 — 是否在每位接收者的頒發建立後自動寄送電子郵件
  5. 點按 下一步

步驟 2:上傳 CSV

批次頒發 — 步驟 2,上傳

CSV 格式

CSV 檔必須包含兩個欄位:nameemail。第一列應為標頭。

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

下載範本

點按 下載範本 以取得含正確標頭的空白 CSV 檔。填入接收者後上傳即可。

上傳

  1. 點按 上傳 CSV,或將檔案拖放進來。
  2. 系統會在開始處理前先驗證檔案。

驗證規則

每一列都會進行驗證:

  • 姓名 至少 5 個字元
  • 電子郵件 必須是有效的電子郵件格式
  • 檔案內的重複電子郵件會被標記
  • 空白列會被略過

若發現驗證錯誤,系統會顯示包含列號的錯誤訊息。請在 CSV 中修正後再次上傳。

  1. 點按 下一步 開始處理。

步驟 3:處理

處理開始後,你會看到進度條與即時狀態:

  • 進度條 — 顯示已處理列數的百分比
  • 目前列 — 正在處理哪一列
  • 成功數 — 已建立的頒發數
  • 錯誤數 — 失敗的列數

暫停與恢復

  • 點按 暫停 可暫時停止處理。暫停期間不會建立新的頒發。
  • 點按 恢復 從上次中斷處繼續。

取消

  • 點按 取消 以完全停止處理。已建立的頒發會保留。

錯誤處理

當某列失敗時(例如資料無效、已達每月頒發配額):

  • 錯誤會記錄詳情
  • 處理會自動繼續至下一列
  • 失敗列會被收集至結果步驟中

頁面重新整理復原

若你在處理期間不小心關閉瀏覽器或重新整理頁面,批次頒發工作階段會在你返回時恢復。進度會從停止處繼續。

步驟 4:結果

處理完成(或取消)後,結果畫面會顯示:

  • 總處理數 — 嘗試處理的列數
  • 成功 — 已建立的頒發數
  • 失敗 — 失敗的列數

下載報表

  • 下載成功 CSV — 所有成功建立頒發的 CSV,含接收者姓名、電子郵件與驗證 URL
  • 下載失敗 CSV — 所有失敗列的 CSV,含錯誤詳情

重試失敗項

若有部分列失敗,你可以下載失敗 CSV,修正問題後,將其作為新的批次頒發再次上傳以重試這些接收者。

badges.ninja Documentation