Panduan Pengguna

Impor Massal Siswa & Bank Soal via CSV

Format kolom CSV yang dibutuhkan, alur unggah-pratinjau-validasi, dan cara menangani baris yang gagal diimpor.

Versi dokumen: v1.0

Daripada menambahkan siswa atau soal satu per satu, Lesan mendukung impor massal lewat file CSV — baik untuk daftar siswa maupun bank soal.

Impor Siswa

Dari halaman Siswa, klik "Import Siswa". Alurnya 3 langkah: unggah file → pratinjau & validasi → selesai.

Kolom CSV yang dibutuhkan:

  • name (wajib)
  • email (wajib)
  • phone (opsional)

Gunakan tombol "Download Template" untuk mendapat contoh file CSV dengan header yang benar. Sebelum dikirim, sistem memvalidasi tiap baris di browser (nama/email kosong, format email salah, email duplikat di dalam file sendiri) dan menandainya sebagai valid/peringatan/error — hanya baris tanpa error yang akan diproses. Siswa baru diundang lewat email (tanpa password ditampilkan di layar) dan proses impornya berjalan di belakang, dengan status per-baris yang bisa dipantau sampai selesai.

Impor Bank Soal

Dari halaman Bank Soal, tombol "Import" membuka alur yang sama (unggah → pratinjau → hasil). Kolom CSV yang dibutuhkan:

  • content — teks soal
  • type — salah satu dari multiple_choice, essay, short_answer, file_upload
  • difficulty — easy, medium, atau hard
  • competencies — minimal satu kompetensi (wajib, untuk tagging)
  • options — pilihan jawaban (khusus soal pilihan ganda)
  • explanation, correct_answer, estimated_duration_minutes — opsional

Baris yang tidak valid akan dilaporkan kembali dengan alasan spesifiknya, supaya bisa diperbaiki dan diunggah ulang tanpa perlu mengulang baris yang sudah berhasil.

Tips

  • Siapkan file dari template yang disediakan, jangan menulis header sendiri — kesalahan nama kolom adalah sumber error paling umum.
  • Untuk bank soal besar, impor bertahap (misal per bab/topik) lebih mudah diperiksa daripada satu file raksasa sekaligus.