Berikut adalah modul panduan langkah demi langkah untuk membangun web sekolah berbasis Google Apps Script (GAS) dengan Google Sheets sebagai basis datanya.
Modul: Pembangunan Web Sekolah Berbasis Google Apps Script & Google Sheets
Deskripsi Modul:
Modul ini dirancang untuk pemula yang ingin membangun sistem informasi web sekolah secara gratis menggunakan ekosistem Google.
Tahap 1: Persiapan Database (Google Sheets)
Langkah pertama adalah menyiapkan struktur data sekolah.
Buka Google Sheets.
Buat dokumen baru dan beri nama Database Web Sekolah.
Ubah nama Sheet1 menjadi Pengumuman. Buat header pada baris pertama:
Kolom A (A1):
IDKolom B (B1):
JudulKolom C (C1):
TanggalKolom D (D1):
Isi
Contoh Data (Baris 2): 1 | Penerimaan Siswa Baru | 2026-08-01 | Pendaftaran siswa baru telah dibuka.
Buat sheet baru dengan menekan tombol + di pojok kiri bawah, beri nama Guru. Buat header:
Kolom A (A1):
NIPKolom B (B1):
NamaKolom C (C1):
Mata Pelajaran
Contoh Data (Baris 2): 19850101 | Budi Santoso, S.Pd. | Matematika
Tahap 2: Menulis Kode Apps Script (Backend & Frontend)
Di Google Sheets yang telah dibuat, klik menu Ekstensi > Apps Script.
Ubah nama proyek menjadi Web Sekolah App.
Hapus semua kode yang ada di file Code.gs, lalu masukkan kode berikut:
// Menampilkan halaman web utama (HTML)
function doGet() {
return HtmlService.createTemplateFromFile('Index')
.evaluate()
.setTitle('Web Resmi Sekolah')
.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
}
// Mengambil data dari Sheet tertentu
function getDataSheet(namaSheet) {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(namaSheet);
var data = sheet.getDataRange().getValues();
var header = data[0];
var result = [];
// Mengubah baris array menjadi array of objects
for (var i = 1; i < data.length; i++) {
var row = data[i];
var obj = {};
for (var j = 0; j < header.length; j++) {
obj[header[j]] = row[j];
}
result.push(obj);
}
return result;
}
Klik tanda + di sebelah kiri Apps Script > pilih HTML.
Beri nama file
Index(tanpa ekstensi .html).Isi dengan kode HTML + CSS Framework (Bootstrap) berikut:
Tahap 3: Peluncuran / Deployment Web
Di pojok kanan atas Apps Script Editor, klik Terapkan (Deploy) > Deploy Baru (New Deployment).
Klik ikon roda gigi (Select type) > pilih Aplikasi Web (Web app).
Deskripsi:
Versi 1 - Web SekolahJalankan sebagai (Execute as):
Saya (Me)Yang memiliki akses (Who has access):
Siapa saja (Anyone)(Agar web dapat diakses umum tanpa harus login).
Klik Terapkan (Deploy).
Berikan izin akses (Authorize Access) jika diminta oleh sistem Google.
Salin URL Aplikasi Web yang diberikan. Buka URL tersebut di browser untuk melihat hasilnya.
Pembahasan & Penjelasan Konsep Teknis
1. Arsitektur Aplikasi (Client-Server Model)
Backend (
Code.gs): Bertindak sebagai server. FungsidoGet()otomatis dipanggil saat seseorang membuka URL web. FungsigetDataSheet()bertugas membaca data dari spreadsheet lalu mengubah data mentah berbentuk baris/kolom menjadi format objek JSON agar mudah diproses di browser.Database (
Google Sheets): Menyimpan data secara persisten. Saat Anda menambah baris data baru di SheetPengumumanatauGuru, tampilan halaman web akan langsung terbarui secara otomatis saat dimuat ulang.Frontend (
Index.html): Berisi struktur tampilan web. Bootstrap digunakan melalui CDN untuk menyajikan antarmuka yang responsif (rapi di HP maupun komputer).
2. Jembatan Komunikasi (google.script.run)
Di dalam file HTML, perintah google.script.run.withSuccessHandler(callback).namaFungsiBackend() adalah kunci utama. Perintah ini mengeksekusi fungsi getDataSheet() di server Google secara asinkron (tanpa reload halaman), lalu mengirimkan hasilnya ke fungsi JavaScript renderPengumuman atau renderGuru di browser untuk ditampilkan.
No comments:
Post a Comment
Terima kasih telah mampir ke Blog yang amburadul ini