Membuat Aplikasi Jurnal PKL SMK di Google Apps Script: Validasi Tanggal, Rekap Kehadiran Otomatis, dan Verifikasi Pembimbing
Buku jurnal PKL berbentuk kertas punya tiga masalah klasik: hilang, dirapel di hari terakhir, dan tanda tangan pembimbing dikejar-kejar saat penarikan. Memindahkannya ke aplikasi terlihat mudah, tetapi kalau validasinya asal, hasilnya sama saja: siswa mengisi 40 jurnal dalam satu malam.
Berikut lima teknik inti dari aplikasi jurnal PKL berbasis Google Apps Script yang membuat datanya tetap jujur.
1. Hari kerja sebagai sumber kebenaran, bukan jumlah jurnal
Jangan hitung kehadiran dari jumlah baris jurnal. Kalau siswa tidak mengisi, barisnya memang tidak ada, dan kehadirannya jadi terlihat sempurna. Buat dulu daftar tanggal hari kerja, baru cocokkan dengan jurnal yang ada:
function tanggalKerja_(cfg, sampai) {
var mulai = /^\d{4}-\d{2}-\d{2}$/.test(cfg.mulai || '') ? cfg.mulai : hariIni_();
var akhir = sampai || (hariIni_() < (cfg.selesai || '') ? hariIni_() : (cfg.selesai || hariIni_()));
var hk = hariKerja_(cfg), out = [], t = mulai, n = 0;
while (t <= akhir && n < 400) { if (hk.indexOf(dow_(t)) >= 0) out.push(t); t = tambahHari_(t, 1); n++; }
return out;
}
hari_kerja disimpan di sheet Pengaturan sebagai 1,2,3,4,5 (1 = Senin), jadi sekolah yang PKL-nya enam hari tinggal menambahkan angka 6. Rekapnya kemudian menghitung hari kosong secara eksplisit:
kerja.forEach(function (t) {
var j = milik[t];
if (!j) { r.kosong++; return; }
r.jurnal++;
if (j.hadir === 'Izin') r.izin++; else if (j.hadir === 'Sakit') r.sakit++; else r.hadir++;
});
r.persen = kerja.length ? Math.round(r.hadir / kerja.length * 100) : 0;
Dengan cara ini, siswa yang tidak pernah mengisi jurnal langsung terlihat: kehadirannya 0%, hari kosongnya menumpuk.
2. Batas mundur supaya jurnal tidak dirapel
Inilah validasi yang paling menentukan kualitas data. Urutan pemeriksaannya penting, dari yang paling jelas ke yang paling spesifik:
if (tgl > hari) throw new Error('Jurnal tidak bisa diisi untuk tanggal yang belum terjadi.');
if (cfg.mulai && tgl < cfg.mulai) throw new Error('Tanggal di luar periode PKL (mulai ' + cfg.mulai + ').');
if (cfg.selesai && tgl > cfg.selesai) throw new Error('Tanggal di luar periode PKL (selesai ' + cfg.selesai + ').');
var batas = Math.max(1, Number(cfg.batas_revisi_hari) || 7);
if (tgl < tambahHari_(hari, -batas)) throw new Error('Jurnal hanya bisa diisi maksimal ' + batas + ' hari ke belakang. Hubungi pembimbing sekolah.');
if (hariKerja_(cfg).indexOf(dow_(tgl)) < 0) throw new Error('Tanggal tersebut bukan hari kerja PKL.');
Tujuh hari adalah angka yang manusiawi: siswa yang sakit seminggu masih bisa menyusul, tetapi merapel sebulan penuh tidak mungkin lagi. Kalau memang perlu, pembimbing sekolah bisa menaikkan angkanya sementara di sheet Pengaturan.
3. Satu jurnal per tanggal, dan terkunci setelah diverifikasi
Alih-alih membuat baris baru setiap kali siswa menyimpan, cari dulu jurnal tanggal itu di dalam LockService:
var lama = bacaJurnal_().filter(function (j) { return j.nis === s.nis && j.tanggal === tgl; })[0];
if (lama) {
if (lama.status === 'Diverifikasi') throw new Error('Jurnal tanggal ini sudah diverifikasi pembimbing dan tidak bisa diubah.');
sh.getRange(lama.baris, 4, 1, 6).setValues([[hadir, masuk, pulang, kegiatan, kendala, 'Menunggu']]);
sh.getRange(lama.baris, 10, 1, 3).setValues([['', '', '']]); // catatan & verifikator dikosongkan
return { id: lama.id, tanggal: tgl, status: 'Menunggu', baru: false };
}
Perhatikan baris terakhir: ketika siswa memperbaiki jurnal yang diminta revisi, status kembali ke Menunggu dan catatan pembimbing dihapus. Tanpa ini, jurnal hasil perbaikan masih membawa catatan lama dan pembimbing bingung apakah sudah diperbaiki atau belum.
Validasi isi juga dibedakan per jenis kehadiran. Saat Hadir, jam masuk/pulang dan kegiatan wajib; saat Izin atau Sakit, jam dikosongkan dan kegiatannya diisi otomatis:
if (hadir === 'Hadir') {
if (!jamValid_(masuk) || !jamValid_(pulang)) throw new Error('Isi jam masuk dan jam pulang (format 08:00).');
if (pulang <= masuk) throw new Error('Jam pulang harus setelah jam masuk.');
if (kegiatan.length < 10) throw new Error('Tulis kegiatan hari itu minimal 10 karakter.');
} else {
masuk = ''; pulang = '';
if (kegiatan.length < 3) kegiatan = 'Tidak masuk: ' + hadir;
}
4. Pembimbing hanya melihat siswa bimbingannya
Satu pembimbing industri hanya boleh menyentuh siswa yang ditempatkan di DUDI-nya. Satu baris pemeriksaan dipakai ulang di semua fungsi pembimbing:
var s = bacaSiswa_().filter(function (x) { return x.nis === j.nis; })[0];
if (!s || (p.jenis === 'Industri' ? s.bi !== p.kode : s.bs !== p.kode)) throw new Error('Jurnal ini bukan bimbingan Anda.');
Untuk verifikasi massal, jangan percaya daftar id yang dikirim browser. Bangun dulu peta siswa yang memang miliknya, lalu lewati id yang bukan haknya alih-alih melempar error:
var punya = {};
bacaSiswa_().forEach(function (s) { if (p.jenis === 'Industri' ? s.bi === p.kode : s.bs === p.kode) punya[s.nis] = 1; });
bacaJurnal_().forEach(function (j) {
if (ids.indexOf(j.id) < 0 || !punya[j.nis] || j.status === 'Diverifikasi') return;
sh.getRange(j.baris, 9, 1, 4).setValues([['Diverifikasi', '', p.kode, kini_()]]);
n++;
});
Batasi juga jumlahnya (ids.slice(0, 50)) supaya satu eksekusi tidak melewati batas waktu Apps Script.
5. Kuota DUDI diperiksa di dalam kunci
Penempatan PKL rebutan tempat favorit. Pemeriksaan kuota harus berada di dalam LockService bersama penulisannya, dan harus mengabaikan siswa yang sedang diedit sendiri:
var terisi = semua.filter(function (s) { return s.status === 'Aktif' && s.dudi === dudi && s.nis !== nis; }).length;
if (status === 'Aktif' && terisi >= d.kuota) throw new Error('Kuota ' + d.nama + ' sudah penuh (' + d.kuota + ' siswa).');
Konsistensi lain yang mudah terlewat: pembimbing industri harus benar-benar terdaftar di DUDI tempat siswa ditempatkan.
if (pi.dudi !== dudi) throw new Error('Pembimbing industri tidak terdaftar di DUDI tersebut.');
Tanpa pemeriksaan ini, siswa bisa ditempatkan di perusahaan A tetapi jurnalnya masuk ke antrean pembimbing perusahaan B.
Bonus: rekap nilai yang angkanya konsisten
Rekap nilai PKL mencantumkan kehadiran. Pastikan angkanya memakai dasar yang sama dengan panel lain, yaitu hari kerja yang sudah berjalan sampai hari ini (atau sampai tanggal selesai, mana yang lebih dulu). Kalau dasarnya seluruh periode padahal PKL baru separuh jalan, kehadiran 100% akan tercetak sebagai 60% dan sekolah kehilangan kepercayaan pada sistemnya.
Ringkasan
- Hitung kehadiran dari daftar hari kerja, bukan dari jumlah jurnal yang ada.
- Tolak tanggal masa depan, di luar periode, bukan hari kerja, dan yang melewati batas mundur.
- Satu jurnal per tanggal; mengisi ulang berarti memperbaiki, dan status kembali Menunggu.
- Pembimbing hanya menyentuh siswa bimbingannya, termasuk pada verifikasi massal.
- Kuota DUDI dan kecocokan pembimbing-DUDI diperiksa di dalam
LockService.
Download source code lengkapnya
Source code lengkap, termasuk halaman siswa, panel pembimbing, panel pokja PKL, rekap nilai siap cetak, data contoh satu gelombang PKL, dan panduan instalasi, bisa diunduh gratis:
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.