名簿のアップロードは以下の手順で行います。
名簿ファイルアップロード画面で「テンプレートダウンロード」ボタンをクリックし、Excel テンプレートをダウンロードします。
ダウンロードしたExcelテンプレートに生徒情報を入力します。
入力時の注意点:
名簿ファイルアップロード画面で、入力済みのExcelファイルを選択し「名簿登録」を実行します。
アップロード前に、テストが正しく選択されていることを確認してください。テストIDが取得できていない場合はエラーになります。
名簿のアップロードはバックグラウンドジョブ（RosterUploadJob）として非同期で処理されます。アップロード開始後、画面上で処理の進捗状況を確認できます。
アップロードが成功すると、名簿管理画面にクラスごとの生徒一覧が表示されます。
名簿アップロード時には、以下のマスタデータが自動的に生成されます。
これらは手動で事前に作成する必要はありません。
| エラー内容 | 原因 | 対処 |
|---|---|---|
| 名簿ファイル形式が不正です | .xlsx 以外のファイルを選択した | .xlsx 形式で保存し直してください |
| シートが見つかりません（ROSTER_SHEET_NOT_FOUND） | シート名が「生徒名簿」になっていない | シート名を「生徒名簿」に変更してください |
| 必須列が不足しています | テンプレートの必須列が削除されている | テンプレートを再ダウンロードして入力し直してください |
| 出席番号が重複しています | 同じ出席番号が複数行にある | 出席番号が重複していないか確認してください |
| 学年が一致しません | テスト設定の学年と名簿の学年が異なる | テスト設定の学年と合わせてください |
| テストIDが取得できません | テストが選択されていない | テストを選択してからアップロードしてください |
| ファイルサイズが制限を超えています | ファイルが大きすぎる | 不要なシートやデータを削除してサイズを小さくしてください |
名簿アップロード後も、以下の項目は編集できます。これらはミス対応のため編集可能となっています。
出席番号や組の修正は、生徒の紐づけに影響するため特に慎重に扱う必要があります。夏→冬の採点比較などで同一生徒を追跡する場合、出席番号や組がズレると比較が正しく行えなくなるためです。
実装上は、管理者のみ修正可、または修正不可とする扱いです。学校先生側で出席番号や組を変更したい場合は、学宝社にお問い合わせください。