Dokumentasi Menu

Dokumentasi

Cara Import Data Siswa

Import data siswa secara massal menggunakan template, pemetaan kelas-seksi, dan alur validasi yang ada di UI Smart School saat ini.

Cari dokumentasi

Cari berdasarkan workflow, nama modul, atau kata kunci operasional.

Pencarian dokumentasi siap digunakan.

Diperbarui: 14 Maret 2026

Panduan ini menjelaskan alur import siswa massal yang tersedia dari halaman Students di Migdafa Smart School.

Paling cocok untuk

Tim penerimaan, front office, dan operator yang perlu menambahkan banyak siswa sekaligus.

Membutuhkan

Akses ke Student Details, file CSV atau Excel yang sudah disiapkan, serta kelas dan seksi tujuan yang sudah pasti.

Hasil akhir

Setiap baris yang valid akan menjadi data siswa di kelas dan seksi yang dipilih.

Sebelum mulai

  • Pastikan kelas dan seksi tujuan sudah tersedia.
  • Siapkan spreadsheet dalam format .csv, .xlsx, atau .xls.
  • Gunakan template dari sistem, jangan membuat header sendiri dari ingatan.
  • Pisahkan file import per kombinasi kelas-seksi bila penempatannya berbeda.

Penting: kelas dan seksi dipilih di dalam dialog import dan berlaku untuk seluruh batch. Jika file Anda berisi siswa dari beberapa kelas atau seksi, pisahkan menjadi beberapa file sebelum upload.

Jalur navigasi

Student Information -> Student Details -> Import Students

Langkah 1: Buka halaman Students

Masuk ke menu Student Information, lalu pilih Student Details. Halaman roster ini adalah titik awal untuk mencari siswa, memfilter data, dan memulai import massal.

Halaman Student Roster dengan tombol Import Students pada bagian header workspace.
Halaman Students menampilkan roster, filter, dan aksi Import Students di bagian atas workspace.

Langkah 2: Buka dialog import dan unduh template

Klik Import Students. Dialog akan memandu proses import dalam tiga tahap:

  1. Mengunduh template CSV.
  2. Memilih kelas dan seksi tujuan.
  3. Mengupload file yang sudah diisi.

Selalu unduh template dari dialog sebelum menyiapkan file baru. Cara ini mengurangi risiko header tidak sesuai dan menjaga kolom tetap sinkron dengan parser import.

Dialog Import Students dengan area unduh template, pilihan kelas dan seksi, upload file, dan pengiriman kredensial.
Dialog import menggabungkan unduh template, pemetaan kelas-seksi, upload file, dan pengaturan opsional pengiriman kredensial.

Langkah 3: Isi template dengan rapi

Setelah template diunduh:

  • gunakan satu baris untuk satu siswa
  • jangan mengganti nama header template
  • hapus baris contoh sebelum menyimpan
  • rapikan format tanggal, nomor telepon, dan email
  • cek nomor penerimaan atau nomor induk sesuai aturan sekolah Anda

Jika sekolah Anda mengirimkan kredensial di tahap onboarding terpisah, fokuskan file import hanya pada data siswa yang valid.

Langkah 4: Pilih kelas dan seksi

Pilih Class lebih dulu, lalu pilih Section.

Yang perlu diperhatikan:

  • field Section tetap nonaktif sampai kelas dipilih
  • daftar seksi berubah sesuai kelas yang dipilih
  • tombol import tetap nonaktif sampai kelas, seksi, dan file semuanya sudah terisi

Pemetaan ini penting karena sistem akan menempatkan semua baris import ke lokasi akademik yang sama.

Langkah 5: Upload file

Seret file ke area upload atau gunakan Choose File.

Saat file diterima:

  • nama file akan tampil menggantikan placeholder upload
  • dialog menahan file tersebut sampai import dijalankan
  • tipe file yang tidak didukung akan menghasilkan error sebelum import dikirim

Format file yang diterima di UI saat ini:

  • CSV
  • XLSX
  • XLS

Langkah 6: Tentukan apakah kredensial portal akan dikirim

Checkbox Send login credentials to students aktif secara default di UI saat ini.

Biarkan aktif jika:

  • akun siswa harus langsung bisa dipakai setelah import
  • proses sekolah Anda memang mengirim kredensial otomatis

Nonaktifkan jika:

  • Anda ingin meninjau hasil import terlebih dahulu
  • kredensial akan dibagikan pada tahap onboarding berikutnya
  • batch masih perlu divalidasi oleh tim penerimaan

Langkah 7: Jalankan import dan baca hasilnya

Setelah kelas, seksi, dan file siap, klik Import Students.

Setelah proses selesai, dialog akan menampilkan ringkasan hasil:

  • jumlah baris yang berhasil diimport
  • jumlah baris yang gagal
  • pesan validasi per baris bila ada error

Jika setidaknya ada satu baris yang berhasil, roster dapat diperbarui dan siswa baru akan tersedia untuk workflow lanjutan seperti akademik, absensi, dan tagihan.

Verifikasi hasil

Gunakan checklist singkat ini setelah import:

  • pastikan jumlah roster berubah bila data baru berhasil masuk
  • cari satu atau dua siswa hasil import berdasarkan nomor penerimaan atau nama
  • verifikasi penempatan kelas dan seksi
  • baca baris yang gagal lalu perbaiki file sebelum import ulang

Hasil yang diharapkan: baris yang valid masuk ke roster siswa dan dapat ditemukan pada daftar Students sesuai kelas dan seksi yang dipilih di dialog import.

Troubleshooting

MasalahPenyebab yang mungkinTindakan
Tombol import tetap nonaktifKelas, seksi, atau file belum lengkapLengkapi ketiga input wajib di dialog
Daftar seksi kosongKelas belum dipilih atau kelas belum punya seksiPilih kelas terlebih dahulu lalu cek data seksi di Academics
File ditolak sebelum uploadEkstensi atau tipe file tidak didukungSimpan ulang file sebagai CSV, XLSX, atau XLS
Sebagian baris gagalData pada spreadsheet tidak lolos validasiGunakan daftar error per baris, perbaiki file, lalu import ulang
Siswa masuk ke lokasi yang salahBatch diimport dengan kelas atau seksi yang keliruSelalu cek pemetaan kelas-seksi sebelum setiap batch

Panduan terkait

Dokumen terkait