一括授与

一括授与では、CSV ファイルをアップロードして数百〜数千人の受領者に一度にバッジを発行できます。プロセスは 4 ステップで、進捗追跡・一時停止/再開・エラー処理が組み込まれています。

概要

一括授与プロセスは 4 ステップです。

1. 設定 — バッジとオプションを選択
2. アップロード — CSV ファイルを準備してアップロード
3. 処理 — 授与が作成されるのに合わせて進捗を監視
4. 結果 — 結果を確認してレポートをダウンロード

ステップ 1: 設定

1. サイドバーから 授与 ページを開きます。
2. 一括授与 をクリックします。
3. バッジピッカーで授与するバッジを選びます。
4. 任意で設定します。
   • 発行日 — すべての授与に使う日付(既定は今日)
   • 有効期限 — すべての授与の任意の有効期限
   • メール送信 — 授与作成後に各受領者へ自動でメールを送るかどうか
5. 次へ をクリックします。

ステップ 2: CSV アップロード

CSV フォーマット

CSV ファイルには 2 つの列が必要です: name と email。先頭行はヘッダーです。

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

テンプレートのダウンロード

テンプレートをダウンロード をクリックすると、正しいヘッダー付きの空の CSV ファイルを取得できます。受領者を入力してアップロードしてください。

アップロード

1. CSV をアップロード をクリック、またはファイルをドラッグ&ドロップします。
2. 処理開始前にファイルが検証されます。

検証ルール

各行は次のように検証されます。

• 名前 は 5 文字以上
• メール は有効なメールアドレス
• ファイル内で重複するメールは警告
• 空行はスキップ

検証エラーが見つかると、行番号付きで表示されます。CSV を修正して再アップロードしてください。

3. 次へ をクリックして処理を開始します。

ステップ 3: 処理

処理が開始すると、進捗バーとライブステータスが表示されます。

• 進捗バー — 処理済みの行のパーセンテージ
• 現在の行 — 現在処理中の行
• 成功件数 — 作成された授与数
• エラー件数 — 失敗した行数

一時停止と再開

• 一時停止 をクリックすると処理を一時停止します。停止中は新しい授与は作成されません。
• 再開 をクリックすると中断したところから続けられます。

キャンセル

• キャンセル をクリックすると処理を完全に停止します。すでに作成された授与は保持されます。

エラー処理

行が失敗すると(例: 無効なデータ、月次授与枠に到達):

• エラーが詳細とともに記録されます
• 処理は自動的に次の行へ進みます
• 失敗した行は結果ステップ用に収集されます

ページ再読み込みからの復元

処理中に誤ってブラウザを閉じたりページを再読み込みしたりしても、戻ってきたときに一括授与セッションが復元されます。進捗は停止した位置から再開します。

ステップ 4: 結果

処理が完了(またはキャンセル)されると、結果画面に次が表示されます。

• 処理済み合計 — 試行された行数
• 成功 — 作成された授与の数
• 失敗 — 失敗した行の数

レポートのダウンロード

• 成功 CSV をダウンロード — 正常に作成されたすべての授与の CSV(受領者名、メール、検証 URL を含む)
• 失敗 CSV をダウンロード — 失敗したすべての行とエラー詳細の CSV

失敗のリトライ

失敗した行がある場合、失敗 CSV をダウンロードして問題を修正し、新しい一括授与として再アップロードすれば、対象の受領者を再試行できます。