一括クレデンシャル

一括クレデンシャルを使うと、CSV ファイルをアップロードして、数百〜数千人の受領者に一度にバッジを発行できます。プロセスは 4 つのステップで構成され、進捗の追跡、一時停止/再開、エラー処理が組み込まれています。

概要

一括クレデンシャルのプロセスは次の 4 つのステップで進みます。

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 valid recipients, 2 invalid (will be skipped)")。有効な行が 1 行以上あれば続行でき、先に修正して再アップロードする必要はありません。

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

ステップ 3: 処理

処理が始まると、進捗バーとリアルタイムのカウンターが表示されます。

• 進捗バー — 処理済みの行の割合
• 作成済み — 作成されたクレデンシャルの数
• 失敗 — 失敗した行の数
• 残り — まだキューに残っている行の数

バッチの実行中、バーの下に 作成済み、失敗、保留中 の各テーブルがリアルタイムで表示されます。

一時停止と再開

• 一時停止 をクリックすると、処理を一時的に止めます。一時停止中は新しいクレデンシャルは作成されません。
• 再開 をクリックすると、中断した箇所から続行します。

キャンセル

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

エラー処理

行固有の理由(例: バックエンドが拒否した無効な値)で行が失敗した場合:

• その行にエラーが記録されます
• 処理は自動的に次の行へ進みます
• 失敗した行は結果ステップのために集約され、エラーテキストが画面上の失敗テーブルに表示されます

レート制限された行は、短いバックオフの後に自動で再試行されます。クレジットまたはクォータのエラーは別扱いです。先へ進む代わりに、ファイルの残りを使い切らないようバッチが一時停止します。赤い "Insufficient credits" の通知が表示されるので、クレジットを追加またはアップグレードしてから 再開 をクリックし、停止した箇所から続行してください。

ページ更新後の復旧

処理中に誤ってブラウザを閉じたりページを更新したりしても、戻ったときに一括クレデンシャルのセッションが復旧されます。進捗は停止した箇所から再開されます。

ステップ 4: 結果

処理が完了(またはキャンセル)すると、結果画面に 4 つのサマリーカードが表示されます。

• 合計 — バッチ内の受領者数
• 作成済み — 作成されたクレデンシャルの数
• 失敗 — 失敗した行の数
• スキップ — 処理されなかった受領者(例: キャンセル後の残りの行)

カードの下には、新しいクレデンシャルを表示用リンク付きで一覧する 作成済み テーブルと、失敗とそのエラーテキストを一覧する 失敗 テーブルがあります。

レポートのダウンロード

• 結果 CSV をダウンロード — バッチ内のすべての行。列は row, name, email, status, award_url です(作成済みの行にはクレデンシャルの URL が入ります)。
• 失敗 CSV をダウンロード — 失敗した行のみ。列は name, email, error です。

失敗の再試行

一部の行が失敗した場合は、失敗を再試行 をクリックします。失敗した受領者のみを対象に新しいパスが開始されるため、CSV を再アップロードする必要はありません。バッチが一時停止した後にクレジットを追加するなど、一時的な問題を解消した後に便利です。