Panduan Migrasi Data & Import Massal Excel di Platform Pesantren OS

Saat pertama kali melakukan migrasi dari pencatatan manual atau sistem konvensional, melakukan entri data satu per satu akan memakan waktu operasional yang besar. Platform Pesantren OS menyediakan fitur Import Data terpadu untuk mengeksekusi pemindahan data master wali murid, profil santri, dan saldo piutang tunggakan secara massal (bulk data ingestion) memanfaatkan berkas spreadsheet Excel. Fitur infrastruktur ini dapat diakses secara terpusat melalui tombol aksi Import Data yang terletak di sudut kanan atas panel menu Pengaturan.

💡 Mekanisme Ekstraksi Data (Export Logic): Apabila Anda ingin mengekstrak data dari basis data sistem menuju format Excel — baik untuk kebutuhan audit eksternal, rekapitulasi, maupun arsip luring — gunakan komponen tombol aksi Export Excel yang disematkan pada setiap tabel halaman data aktif, atau gunakan menu konsolidasi Ekspor Data Lengkap di panel Pengaturan. Dokumentasi teknis mengenai hal ini dapat dipelajari pada modul Data Santri & Wali Santri.

Urutan Penyelarasan Database

Arsitektur database platform menerapkan aturan integritas relasional, sehingga proses unggah berkas wajib mengikuti urutan linear berikut dan tidak boleh dibalik:

1. Data Master Wali Santri: Wajib diposting pada tahap pertama. Hal ini dikarenakan setiap profil santri membutuhkan relasi pengait berupa alamat surel (email) wali murid agar proses penautan terwujud.
2. Data Master Santri: Diproses pada tahap kedua segera setelah database mencatat ketersediaan akun wali murid, memastikan proses data binding antar entitas berjalan sukses.
3. Saldo Tunggakan Finansial: Diimpor pada tahapan akhir setelah profil akun santri terdaftar dan memiliki Nomor Induk Santri (NIS) yang aktif di sistem.

Prosedur Operasional Umum

Untuk setiap segmen kategori data, sistem menerapkan standarisasi alur kerja yang seragam sebagai berikut:

1. Tentukan jenis kategori data master yang akan dimigrasikan (pilihan: Wali, Santri, atau Saldo Tunggakan).
2. Klik aksi Unduh Templat Excel resmi yang disediakan oleh sistem. Templat ini telah dikonfigurasi dengan struktur header kolom yang presisi beserta dua baris data simulasi.
3. Masukkan data institusi Anda ke dalam file templat tersebut dengan wajib mematuhi ketentuan format contoh, kemudian simpan dokumen.
4. Klik Unggah untuk mengirimkan berkas. Sistem akan menginisiasi fungsi parsing data untuk menampilkan Pratinjau Data (Data Preview Layout) pada layar sebelum data dieksekusi masuk ke database produksi.
5. Lakukan audit visual pada lembar pratinjau, pastikan tidak ada indikator kolom yang merah, kemudian klik Jalankan Import untuk finalisasi.

Struktur header kolom dikonfigurasi menggunakan Bahasa Indonesia baku demi kemudahan operasional, dan algoritma mapping sistem dibekali kemampuan mengenali variasi penamaan kolom sejenis secara otomatis.

1. Manajemen Impor Data Wali Santri

Komponen kolom yang tersedia pada templat meliputi: Nama Wali (wajib/mandatory), Email Login, No HP/WA, Pekerjaan, Alamat, dan Password Portal. Setiap baris entri yang sukses diproses akan memicu sistem untuk menciptakan Akun Akses Portal dengan level peran Wali Santri sekaligus mengunci profil biodatanya.

• Parameter Email: Bersifat opsional. Anda dapat mengisikan alamat email riil milik wali murid atau alamat email dummy khusus dengan nama unik. Jika kolom ini dikosongkan, algoritma sistem secara otomatis akan menghasilkan string identitas login acak yang dapat ditinjau melalui Detail Profil Wali.
• Parameter Password: Bersifat opsional. Jika dikosongkan, sistem keamanan akan menerapkan kata sandi bawaan (default system password). Petunjuk teknis kombinasi kata sandi bawaan ditampilkan langsung pada halaman antarmuka Import Data aplikasi Anda.
• Validitas Kontak: Pastikan minimal kolom No HP/WhatsApp terisi dengan nomor yang aktif untuk memicu fungsi otomatisasi pengiriman log akun dan kata sandi langsung ke gawai wali murid via sistem pesan. Detail teknis implementasi ini dibahas pada panduan Setup WhatsApp → Kirim Kredensial Wali.

Wali murid dapat melakukan otentikasi masuk ke portal menggunakan alamat email atau nama pengguna (username) ringkas. Sistem menerapkan fungsi ekstraksi otomatis di mana string username ditarik dari karakter sebelum simbol @ pada email terdaftar (sebagai contoh: username budi diekstrak otomatis dari email budi@gmail.com). Kebijakan ini memudahkan wali murid untuk masuk ke sistem tanpa harus mengetikkan keseluruhan alamat surel. Setelah login pertama berhasil, wali murid sangat disarankan untuk segera melakukan pembaruan kata sandi secara mandiri demi keamanan.

2. Manajemen Impor Data Santri

Komponen kolom utama pada templat meliputi: NIS (wajib/mandatory), Nama Lengkap (wajib/mandatory), Jenis Kelamin (L/P), Tempat & Tanggal Lahir, Alamat, No HP, Asal Sekolah, Tanggal Masuk, Email Wali, dan Relasi Wali.

• Format Jenis Kelamin: Wajib diinput menggunakan kode karakter tunggal, yaitu L untuk Laki-laki atau P untuk Perempuan.
• Standardisasi Tanggal (Date Format Validation): Sistem mendukung dua struktur pembacaan tanggal, yaitu pola ISO standar YYYY-MM-DD (contoh: 2010-05-15) atau pola konvensional DD/MM/YYYY (contoh: 15/03/2011).
• Sinkronisasi Relasi Wali: Variabel pada kolom Email Wali wajib ditulis sama persis dengan data email wali murid yang telah diunggah pada tahapan pertama. Jika wali murid sebelumnya diimpor tanpa email riil (menggunakan username otomatis), lakukan penyelarasan string username tersebut di kolom ini agar relasi antartabel tidak terputus.
• Klasifikasi Relasi Wali: Wajib diisi menggunakan huruf kapital dengan pilihan opsi parameter: AYAH, IBU, atau WALI.

3. Manajemen Impor Saldo Tunggakan

Fungsi ini digunakan untuk melakukan migrasi data sisa piutang atau tagihan berjalan dari pembukuan lama lembaga Anda. Komponen kolom meliputi: NIS (wajib/mandatory), Jumlah (Rp) (wajib/mandatory), dan Catatan.

Setiap baris data yang lolos validasi akan dikonversi oleh sistem menjadi satu entri dokumen tagihan aktif dengan klasifikasi kategori “Tunggakan Sebelumnya” yang dibebankan secara spesifik pada nomor NIS santri terkait dengan nominal yang sesuai.

Kebijakan Penanganan Error Data (Data Exception & Rollback Handling)

Jika saat proses peninjauan pratinjau sistem mendeteksi adanya baris data yang mengalami kegagalan skrip (parsing error), sistem tidak akan membatalkan seluruh isi dokumen. Baris data yang valid akan tetap diproses, sedangkan baris yang bermasalah akan ditampilkan pada log kesalahan dengan indikator penyebab berikut:

• Kekosongan Field Mandat (NIS atau Nama Kosong): Baris data diblokir karena kolom wajib tidak memuat data. Solusi: Lengkapi kolom wajib pada berkas Excel dan lakukan unggah ulang.
• Kegagalan Relasi (Email Wali Tidak Ditemukan): Sistem menolak data santri karena string email wali tidak terdaftar di database master. Solusi: Pastikan data wali murid telah diimpor terlebih dahulu dan ejaan email tertulis secara presisi.
• Anomali Skrip Waktu (Tanggal Tidak Terbaca): Sistem tidak dapat menerjemahkan format penulisan tanggal. Solusi: Ubah format sel pada Excel menjadi salah satu dari dua pola standar yang didukung sistem.

Untuk menyelesaikan kendala di atas, Anda cukup melakukan perbaikan data spesifik pada baris yang bermasalah di berkas Excel Anda, kemudian lakukan proses unggah kembali. Sistem dilengkapi proteksi duplikasi data, sehingga baris data yang sebelumnya telah sukses masuk ke database tidak akan mengganda selama nilai identifier utama (seperti nomor NIS atau Email) bersifat konsisten dan sama.

---

Langkah Selanjutnya

• Pengaturan Sistem & Lokalisasi Nomenklatur — Panduan menyiapkan jenis kategori pos tagihan, konfigurasi hak akses pengguna, dan penyetelan dasar sebelum sistem beroperasi penuh.
• Otomatisasi Penerbitan Tagihan SPP — Langkah teknis mengonfigurasi pembuatan invoice tagihan bulanan rutin secara massal setelah database profil santri berhasil termigrasi secara utuh.