CSV：よくあるエラー
CSV インポートが失敗する一般的な理由、製品のヒントと解決策。
integrationcsv
対象: 機関管理者 / 教務 · 適用: SaaS / プライベートデプロイ
目標: 検証またはバッチのエラーから素早くファイルを直す。
エラー対照表
| 現象 / 提示 | 想定原因 | 対処 |
|---|---|---|
| メールが既に存在 | 同一機関の重複、または過去インポートの残留 | メールを変更。既存アカウントの更新意図か確認 |
| メール形式が無効 | 空白、全角記号、@ 欠落 | 形式を整えて再インポート |
| クラスコード無効／クラスが見つからない | クラス未作成、または大小文字／空白のずれ | 先にクラスを入れる。コードを揃える |
| 役割不一致 | テンプレートが許さない値 | テンプレートの列挙どおりに直す |
| 必須が空 | 未記入または列ずれ | ヘッダー改変や結合セルを確認 |
| 文字化け | UTF-8 ではない | UTF-8 CSV で保存し直して再アップロード |
| パスワード方針に合わない | 短すぎ／禁止文字 | 初期パスワード列を方針どおりに |
| メンバー関係失敗 | 人はいるがクラスコード誤り、または人未インポート | 「クラス → 人 → メンバー」の順でやり直し |
| 権限不足 | 現在の管理者ロールが読み取り専用 | owner／admin アカウントで操作 |
UI 文言は少し違うことがある。バッチ詳細の行エラーを優先。
切り分け順
- 行番号 を見て、失敗行だけ直す。
- ヘッダーを変えていないか確認。
- インポートタイプとファイル内容が一致しているか（学生ファイルを教師タイプにしない）。
- 小サンプル通過後に全量。
なお失敗するときに伝えること
- インポートバッチ番号
- インポートタイプ
- 個人情報をマスクした 1〜2 行のサンプル（電話は削除。氏名は任意）
- エラー全文
初めてのインポート または テンプレートとフィールド へ戻る。