名簿のアップロードは以下の手順で行います。
名簿ファイルアップロード画面で「テンプレートダウンロード」ボタンをクリックし、Excel テンプレートをダウンロードします。
ダウンロードしたExcelテンプレートに生徒情報を入力します。
入力時の注意点:
名簿ファイルアップロード画面で、入力済みのExcelファイルを選択し「名簿登録」を実行します。
アップロード前に、テストが正しく選択されていることを確認してください。テストIDが取得できていない場合はエラーになります。
名簿のアップロードはバックグラウンドジョブ（RosterUploadJob）として非同期で処理されます。アップロード開始後、画面上で処理の進捗状況を確認できます。
アップロードが成功すると、名簿管理画面にクラスごとの生徒一覧が表示されます。
名簿アップロード時には、以下のマスタデータが自動的に生成されます。
これらは手動で事前に作成する必要はありません。
| エラー内容 | 原因 | 対処 |
|---|---|---|
| 名簿ファイル形式が不正です | .xlsx 以外のファイルを選択した | .xlsx 形式で保存し直してください |
| シートが見つかりません | シート名が「生徒名簿」になっていない | シート名を「生徒名簿」に変更してください |
| 必須列が不足しています | テンプレートの必須列が削除されている | テンプレートを再ダウンロードして入力し直してください |
| 出席番号が重複しています | 同じ出席番号が複数行にある | 出席番号が重複していないか確認してください |
| 学年が一致しません | テスト設定の学年と名簿の学年が異なる | テスト設定の学年と合わせてください |
| テストIDが取得できません | テストが選択されていない | テストを選択してからアップロードしてください |
| ファイルサイズが制限を超えています | ファイルが大きすぎる | 不要なシートやデータを削除してサイズを小さくしてください |
名簿アップロード後も、以下の項目は編集できます。これらはミス対応のため編集可能となっています。
出席番号や組の修正は、生徒の紐づけに影響するため特に慎重に扱う必要があります。夏→冬の採点比較などで同一生徒を追跡する場合、出席番号や組がズレると比較が正しく行えなくなるためです。
実装上は、管理者のみ修正可、または修正不可とする扱いです。学校先生側で出席番号や組を変更したい場合は、学宝社にお問い合わせください。
名簿の登録時に表示されるメッセージごとの対処です。行単位で検証されるため、該当する行を修正してから再度アップロードしてください。
学年の列に、許容されない値が入っています。
指定できるのは 1・2・3・7・8・9 のいずれかです。全角数字、空白、「中1」のような文字列は使えません。半角の数値のみを入力してください。
サポートに連絡する場合は、エラーコード INVALID_GRADE_VALUE をお伝えください。
出席番号の列に、1〜50の範囲外の値または数値以外が入っています。
0や51以上の番号は登録できません。全角数字や空欄になっていないかもあわせて確認してください。
サポートに連絡する場合は、エラーコード INVALID_ATTENDANCE_NUMBER をお伝えください。
名簿の行で指定した「学年＋クラス名」に一致するクラスが、システムに登録されていません。
クラス名の表記ゆれ（1組 / １組 / A組 など）がないか確認してください。新しいクラスの場合は、先に学校・クラスの登録が必要です。ご不明な場合は学宝社にお問い合わせください。
サポートに連絡する場合は、エラーコード CLASS_NOT_FOUND をお伝えください。
Excelファイル自体を読み取れませんでした。
サポートに連絡する場合は、エラーコード EXCEL_READ_FAILED をお伝えください。