批次頒發

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

概覽

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

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

步驟 1:設定

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

步驟 2:上傳 CSV

CSV 格式

CSV 檔必須包含一個 name 欄位與一個 email 欄位,並附一列標頭。標頭名稱不分大小寫,且 recipient_name / recipient_email 可作為 name / email 的別名。

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

下載範本

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

上傳

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

驗證規則

每一列在檔案解析後隨即進行驗證:

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

預覽表格會逐列以綠色勾號或紅色原因列出。無效列不會造成阻礙 — 它們只會被 略過,計數器會顯示將處理多少位有效接收者(例如「18 位有效接收者,2 位無效(將被略過)」)。只要至少有一列有效即可繼續;無需先修正並重新上傳。

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

步驟 3:處理

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

• 進度條 — 已處理列數的百分比
• 已建立 — 已建立的頒發數
• 失敗 — 失敗的列數
• 剩餘 — 仍在佇列中的列數

批次執行時,即時的 已建立、失敗 與 待處理 表格會在進度條下方逐步填入。

暫停與恢復

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

取消

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

錯誤處理

當某列因該列特定原因失敗時(例如後端拒絕的無效值):

• 該錯誤會記錄於該列
• 處理會自動繼續至下一列
• 失敗列會被收集至結果步驟,其錯誤文字會顯示於畫面上的失敗表格中

遭速率限制的列會以短暫退避自動重試。額度或配額錯誤則不同 — 批次不會略過繼續,而是會 暫停,以免耗盡檔案中其餘的部分。畫面會出現紅色的「額度不足」提示;請儲值或升級,再點按 恢復 從停止處繼續。

頁面重新整理復原

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

步驟 4:結果

處理完成(或取消)後,結果畫面會顯示四張摘要卡片:

• 總計 — 批次中的接收者數
• 已建立 — 已建立的頒發數
• 失敗 — 失敗的列數
• 已略過 — 未處理的接收者(例如取消後剩餘的列)

卡片下方有一個 已建立 表格,逐一列出每筆新頒發並附檢視連結;另有一個 失敗 表格,列出失敗項及其錯誤文字。

下載報表

• 下載結果 CSV — 批次中的每一列,含欄位 row, name, email, status, award_url(已建立的列會填入頒發 URL)。
• 下載失敗 CSV — 僅失敗的列,含欄位 name, email, error。

重試失敗項

若有部分列失敗,點按 重試失敗項。這會針對失敗的接收者重新執行一輪 — 無需重新上傳 CSV。在修正暫時性問題後(例如批次暫停後儲值額度)特別方便。