受験者のCSV一括登録で失敗した行を直す
パレットCBTの受験者CSV一括登録で「エラー」「要確認」「未処理」になった行の直し方です。プレビューの分類(新規・登録済み・重複・エラー)、失敗行CSVの「理由」列、よくある理由と対処をまとめました。
受験者のCSV一括登録は、取り込む前にプレビューで行ごとの結果を確認でき、 取り込み後に登録できなかった行は**「理由」列つきのCSV**として取り出せます。 このCSVを直してもう一度アップロードすれば、失敗した分だけをやり直せます。
CSV一括登録の入口は 受験者を追加する をご覧ください。
ファイルの決まり
| 項目 | 内容 |
|---|---|
| 列 | email(必須)。name(氏名)・name_kana(フリガナ)・birth_date(生年月日)・gender(性別)・phone(電話番号)・group_codes(グループ)は任意。見出しは「メールアドレス」「氏名」「フリガナ」「生年月日」「性別」「電話番号」「グループ」の日本語でも読み込めます |
| 文字コード | UTF-8、またはShift_JIS(Excelで保存したCSV)。どちらでも読み込めます |
| 上限 | 一度に300件まで。超える場合はファイルを分けます |
書式に迷ったら、「CSV一括登録」の 「テンプレートDL」 からひな形をダウンロードしてください。
group_codes(「グループ」)列にグループコードか名前を「;」区切りで入れると、行ごとに所属グループを決められます。
空欄の行は、取り込みのときに画面で選んだ 「所属グループ」 に登録されます。
プレビューの分類
ファイルを選ぶと、取り込む前に行ごとの結果が4つに分類されます。
| 分類 | 意味 | 取り込み |
|---|---|---|
| 新規 | まだ登録の無いメールアドレス | 取り込みます |
| 登録済み | すでに受験者として登録されている | 既定では取り込みません(エラーではありません)。プレビューの 「登録済みの受験者を更新する」 にチェックを入れると、CSVの氏名・フリガナ・生年月日・性別・電話番号で上書きします(空欄は変えません) |
| 重複 | 同じファイル内で先に同じメールアドレスがある | 先の行だけ取り込みます |
| エラー | 直さないと取り込めない行。理由が行に表示されます | 取り込みません |
プレビューでは行ごとに、行番号・メールアドレス・氏名・フリガナ・「生年月日・性別・電話」・結果が表示されます。 CSVにグループ列があるときは「グループ」列も並び、空欄の行には「(画面の選択)」と表示されます。 「所属グループ」 で登録先のグループを選び、「N件を取り込み」 を押すと、新規の行だけが登録されて招待メールが送られます。 グループ列に指定のある行はその値が優先されるため、「所属グループ」 の選択が要るのはグループ列が空欄の行があるときだけです(そのときはラベルに「(必須)」または「(グループ列が空欄の行に必要)」と表示されます)。 「登録済みの受験者を更新する」 にチェックを入れると、ボタンが 「N件を取り込み・N件を更新」 になり、登録済みの行もCSVの値で更新されます。 所属は、グループ列に値のある行はその値に置き換わり、グループ列が空欄の行は選んだグループへの所属が加わります(いまの所属は残ります)。 招待中で招待が届いていない人には、このとき招待メールが送られます。
失敗した行を取り出して直す
取り込み後の 「取込結果」 に、登録・失敗の件数と、あれば 「要確認」・「未処理」 の件数、行ごとの理由が表示されます。
- 「失敗行CSVをダウンロード」 を押します。元の列に 「理由」 列が加わったCSVが保存されます(失敗が無く未処理だけのときは 「未処理行CSVをダウンロード」 です)。
- 「理由」を見て、該当する値を直します。
- 直したCSVをもう一度 「CSV一括登録」 からアップロードします。「理由」列は読み飛ばされるので、そのままでも構いません。
「要確認」は、登録はできたが招待メールの送信やグループ所属の反映ができなかった行です(下表)。失敗行CSVには入りません。 理由に書かれた操作で対応するか、同じCSVをもう一度アップロードし、プレビューで「登録済みの受験者を更新する」にチェックを入れて取り込み直すと、招待と所属をやり直せます。 招待が届いていなかった人には招待が送り直され、「招待が届いていなかったN名に招待を送り直しました」と表示されます。
時間の上限で処理しなかった行(未処理)
一度の取り込みで処理できる時間には上限があります。上限に達すると残りの行は処理されず、「取込結果」に 「未処理 N 件」 と表示されます。 ここまでに登録された行はそのまま登録されています。
- 失敗行CSV(または未処理行CSV)には未処理の行も入っています。そのまま再アップロードすると、続きから処理できます。
- 更新の途中で止まった登録済みの行は、再アップロードのプレビューで「登録済み」になります。「登録済みの受験者を更新する」 にチェックを入れて取り込んでください。
よくある理由と対処
| 理由 | 対処 |
|---|---|
| メールアドレスが空です | メールアドレスを入れます |
| メールアドレスの形式が正しくありません | 全角文字・空白・記号の抜けがないか確認します |
| 氏名・フリガナは100文字以内で入力してください | 長すぎる値を短くします |
| ヘッダー行に email 列が必要です | 1行目に email 列(または「メールアドレス」)を入れます。ほかの列は任意です |
| 一度に取り込めるのは300件までです | ファイルを分けて取り込みます |
| 既に登録されています | プレビューの後に別の管理者が登録した場合などです。対応は不要です |
| 登録済みですが招待メールは未送信です(…) | 受験者一覧の行メニューから 「招待を再送」 を行うか、同じCSVを「登録済みの受験者を更新する」にチェックを入れて取り込み直します |
| 登録して招待メールを送りましたが、グループ所属を反映できませんでした(…) | 受験者の詳細の 「所属を変更」 で所属を設定するか、同じCSVを「登録済みの受験者を更新する」にチェックを入れて取り込み直します |
| 登録済みですが、グループ所属の反映と招待メールの送信ができませんでした(…) | 同じCSVを「登録済みの受験者を更新する」にチェックを入れて取り込み直すと、所属と招待をやり直せます |
| 登録に失敗しました(…) | 失敗行CSVを再アップロードします。プレビューで「登録済み」と表示された場合は登録されていたので、「登録済みの受験者を更新する」にチェックを入れて取り込むと招待が送られます |
| 時間の上限のため未処理。… | 未処理の行です。失敗行CSV(または未処理行CSV)をそのまま再アップロードします |
| 時間の上限のため処理していません(登録済みの受験者です。…) | 更新の途中で止まった行です。再アップロードし、「登録済みの受験者を更新する」にチェックを入れて取り込みます |
関連する記事
最終更新: 2026-09-25
