Ts. Ashraf Naim
Tutorials

Automasi Kerja Sekolah dengan Google Apps Script: 3 Skrip untuk Bermula

Tiga skrip Google Apps Script yang ringkas untuk guru: cap masa automatik, ringkasan kehadiran mingguan dan e-mel pengesahan borang, lengkap dengan had kuota sebenar dan cara memasang pencetus.

Ts. Ashraf bin Naim
25 Februari 2025
5 min bacaan
1307 views

Automasi Kerja Sekolah dengan Google Apps Script: 3 Skrip untuk Bermula

Setiap guru ada tugas yang berulang: menyalin tarikh ke hamparan, menghantar peringatan, merumus kehadiran. Google Apps Script boleh melakukan sebahagiannya secara automatik di dalam Google Sheets dan Google Forms yang sudah anda gunakan. Artikel ini memberi tiga skrip pendek yang boleh disalin, cara memasangnya, dan had sebenar yang perlu anda ketahui sebelum bergantung padanya.

Apa itu Apps Script, dan apa batasnya

Apps Script ialah bahasa skrip berasaskan JavaScript yang dijalankan di pelayan Google dan boleh mengawal Sheets, Docs, Forms dan Gmail. Ia percuma, tetapi ada had harian yang jelas. Angka di bawah diambil daripada halaman kuota rasmi Google:

HadAkaun Gmail biasaGoogle Workspace (termasuk akaun sekolah)
Penerima e-mel sehari1001,500
Masa larian satu skrip6 minit6 minit
Jumlah masa pencetus sehari90 minit6 jam
Bilangan pencetus setiap pengguna bagi satu skrip2020

Untuk kerja kelas biasa, had ini mencukupi. Satu perkara lain: pentadbir Workspace sekolah boleh menyekat Apps Script atau penghantaran e-mel pada akaun sekolah, jadi jika skrip tidak boleh dijalankan, tanya pentadbir dahulu.

Sebelum bermula

  1. Buka Google Sheets, kemudian pilih Extensions dan Apps Script.
  2. Padam kod contoh dalam editor, tampal skrip, dan tekan Save.
  3. Kali pertama sesuatu fungsi dijalankan, Google meminta kebenaran. Untuk skrip yang anda tulis sendiri, anda akan melihat amaran bahawa aplikasi belum disahkan. Itu normal untuk skrip peribadi. Teruskan hanya untuk skrip yang anda fahami.
  4. Uji pada salinan helaian dengan data rekaan, bukan pada data sebenar murid.

Skrip 1: Cap masa automatik

Apabila anda memasukkan atau mengubah markah dalam lajur B, tarikh dan masa ditulis dalam lajur C pada baris yang sama. Ini berguna untuk menunjukkan bila sesuatu markah dikemas kini. Skrip ini menggunakan pencetus ringkas (onEdit) yang tidak perlu dipasang. Namakan helaian anda Markah.

// Cap masa automatik: bila sel dalam lajur B disunting,
// tarikh dan masa ditulis dalam lajur C pada baris yang sama.
function onEdit(e) {
  var sheet = e.range.getSheet();
  if (sheet.getName() !== 'Markah') return; // hanya helaian bernama "Markah"

  var barisPertama = Math.max(e.range.getRow(), 2); // langkau baris tajuk
  var barisAkhir = e.range.getRow() + e.range.getNumRows() - 1;
  var lajurAwal = e.range.getColumn();
  var lajurAkhir = lajurAwal + e.range.getNumColumns() - 1;
  if (2 < lajurAwal || 2 > lajurAkhir) return; // suntingan tidak melibatkan lajur B

  for (var baris = barisPertama; baris <= barisAkhir; baris++) {
    sheet.getRange(baris, 3).setValue(new Date());
  }
}

Dua batasan daripada dokumentasi pencetus: pencetus ringkas hanya berjalan apabila seseorang menyunting sel, bukan apabila skrip lain menukar sel (setValue tidak mencetus onEdit), dan ia tidak boleh menghantar e-mel. Untuk e-mel, anda perlukan pencetus yang dipasang, seperti dua skrip seterusnya.

Skrip 2: Ringkasan kehadiran mingguan

Skrip ini membaca helaian bernama Kehadiran (lajur A: kod murid, B: bilangan hari hadir, C: jumlah hari) dan menghantar kepada anda sendiri senarai murid di bawah 80%. Gunakan kod murid seperti M01 hingga M35, bukan nama penuh.

// Ringkasan kehadiran mingguan, dihantar kepada anda sendiri.
// Helaian "Kehadiran": A = kod murid, B = hari hadir, C = jumlah hari.
function hantarRingkasanKehadiran() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Kehadiran');
  var data = sheet.getDataRange().getValues(); // baris 1 = tajuk
  var rendah = [];

  for (var i = 1; i < data.length; i++) {
    var kod = data[i][0];
    var hadir = Number(data[i][1]);
    var jumlah = Number(data[i][2]);
    if (!kod || !jumlah) continue; // langkau baris kosong
    var peratus = Math.round((hadir / jumlah) * 100);
    if (peratus < 80) rendah.push(kod + ': ' + peratus + '%');
  }

  var badan = rendah.length
    ? 'Murid dengan kehadiran di bawah 80%:\n' + rendah.join('\n')
    : 'Semua murid berada pada 80% ke atas.';
  var penerima = Session.getEffectiveUser().getEmail();
  MailApp.sendEmail(penerima, 'Ringkasan kehadiran mingguan', badan);
}

// Jalankan SEKALI sahaja untuk memasang pencetus setiap hari Jumaat, sekitar 4 petang.
function pasangPencetusMingguan() {
  ScriptApp.newTrigger('hantarRingkasanKehadiran')
    .timeBased()
    .onWeekDay(ScriptApp.WeekDay.FRIDAY)
    .atHour(16)
    .create();
}

Untuk menjadikannya automatik, jalankan fungsi pasangPencetusMingguan sekali sahaja. Pencetus yang dipasang akan menjalankan hantarRingkasanKehadiran setiap hari Jumaat, pada masa antara 4 dan 5 petang. Pastikan fail appsscript.json projek anda mempunyai "timeZone": "Asia/Kuala_Lumpur" supaya waktu itu mengikut waktu Malaysia (lihat dokumentasi manifes).

Skrip 3: E-mel pengesahan apabila borang dihantar

Sambungkan Google Form anda kepada Sheets (tab Responses, kemudian Link to Sheets). Setiap kali borang dihantar, skrip ini menghantar e-mel pengesahan kepada alamat yang diisi. Borang mesti mempunyai dua soalan bertajuk tepat Nama murid dan E-mel penjaga. Jika tajuk soalan berbeza, tukar kunci dalam skrip supaya sepadan.

// Hantar e-mel pengesahan apabila Google Form dihantar.
// Nama kunci mesti SAMA dengan tajuk soalan dalam borang.
function hantarPengesahan(e) {
  var nama = e.namedValues['Nama murid'] && e.namedValues['Nama murid'][0];
  var emel = e.namedValues['E-mel penjaga'] && e.namedValues['E-mel penjaga'][0];
  if (!nama || !emel) return; // soalan tiada atau kosong

  MailApp.sendEmail(
    emel,
    'Borang kebenaran diterima',
    'Borang bagi ' + nama + ' telah diterima. Terima kasih.'
  );
}

// Jalankan SEKALI sahaja untuk memasang pencetus borang pada helaian ini.
function pasangPencetusBorang() {
  ScriptApp.newTrigger('hantarPengesahan')
    .forSpreadsheet(SpreadsheetApp.getActiveSpreadsheet())
    .onFormSubmit()
    .create();
}

Pasang pencetus dengan menjalankan pasangPencetusBorang sekali. Kunci namedValues ialah tajuk soalan, dan setiap kunci memegang senarai jawapan (sebab itu kod menggunakan [0]). Butiran acara ini ada dalam dokumentasi acara pencetus.

Dua peringatan. Pertama, kutip e-mel penjaga hanya jika sekolah anda membenarkannya dan penjaga tahu tujuannya; ikut dasar privasi sekolah dan PPD. Kedua, had 100 e-mel sehari pada akaun biasa bermakna borang yang diisi oleh lebih ramai orang akan berhenti menghantar e-mel selepas had itu.

Masalah yang biasa berlaku

  • E-mel dihantar dua kali. Anda menjalankan fungsi pasang pencetus lebih daripada sekali. Buka ikon jam (Triggers) di sebelah kiri editor dan padam yang berganda.
  • Cap masa tidak muncul. Semak nama helaian (huruf besar dan kecil dibezakan), dan pastikan anda menyunting lajur B dengan tangan.
  • Borang tidak menghantar e-mel. Tajuk soalan tidak sama dengan kunci dalam skrip, atau pencetus belum dipasang. Semak tab Executions untuk mesej ralat.
  • Ralat kuota e-mel. Had harian sudah dicapai. Ia ditetapkan semula keesokan harinya.

Mulakan dengan satu

Cuba skrip 1 dahulu pada salinan helaian anda kerana ia tidak memerlukan pemasangan pencetus. Apabila anda selesa, tambah skrip 2 dengan data kehadiran rekaan, dan hanya selepas itu gunakan data sebenar. Logik setiap skrip dalam artikel ini diuji dengan data rekaan sebelum diterbitkan, tetapi tetapan sekolah, kebenaran akaun dan struktur helaian anda berbeza, jadi ujian pada salinan sendiri tetap perlu.

Rujukan

  1. Apps Script: Quotas for Google Services
  2. Apps Script: Triggers
  3. Apps Script: Installable Triggers
  4. Apps Script: Event Objects
  5. Apps Script: MailApp
  6. Apps Script: ClockTriggerBuilder

Buku tentang Google Apps Script di Amazon (pautan afiliasi: saya mungkin menerima komisen kecil tanpa kos tambahan kepada anda).


Nota penyunting: Artikel ini disediakan dengan bantuan alat AI, kemudian disemak dan disunting oleh Ts. Ashraf bin Naim sebelum diterbitkan. Contoh dan saranan di dalamnya berdasarkan pengalaman sebenar dalam pentadbiran dan latihan pendidikan di Malaysia.

T

Tentang Ts. Ashraf bin Naim

Pendidik dan teknologis profesional yang melatih guru menggunakan AI dan alat digital dalam kerja harian mereka.

Artikel berkaitan