Spreadsheet Library - mini database (GAS)

Berikut ini pustaka Telegram versi ke-2 untuk Google Apps Script (GAS). Dokumentasi ini sangat bermanfaat untuk developer yang menggunakan Library GAS Versi 2.

Pengantar

Ketika cooding menggunakan GAS, maka Spreadsheet menjadi sesuatu yang sangat penting untuk dijadikan objek dan selalu dilibatkan di dalamnya.

Karena spreadsheet adalah bentuk aplikasi yang merupakan pengolahan data yang sangat powerfull. Selain itu juga sangat familiar dikalangan pengguna teknologi informasi.

Adalah,seolah merupakan satu kewajiban, bagi pengguna teknologi informasi untuk mengenal sheet dan memanfaatkannya.

Oleh karena itu, kebutuhan membuat library yang mudah dipergunakan, sederhana, dan fleksibel sangat diperlukan. Untuk itulah library ini dibuat, semoga dapat bermanfaat buat para penggiat coder tanah iar.

Thanks

Terimakasih buat @GB_Sources_Santoso telah memberikan dasar dan ide atas library ini.

Pengenal

Berikut Google Script Library -nya :

• ID Legacy : MElMS4ozme33Zwbcq7h7mRqZTb1melOAr
• New Editor: 1NLQhvkXR9BHzlLELujjwFuEwY9rKaSPGZdE9Fqlfuccza0T4Fe3n5kXk

Sesuaikan dengan Editor nya, dan selalu pilih yang versi dengan angka paling besar.

Dokumentasi

Inisiasi

var db = new miniSheetDB.init(sheetID, namaSheet='Sheet1', regex = true);

Contoh:

var db = new miniSheetDB.init('1B8JSBXqV0sIFZsuwDHQ8wOADFIAxgB7WDpJRh1JUei8');

Keterangan

• sheetID ID Sheet yang di dapat dari Google Spreadsheet
• namaSheet nama sheet, defaultnya adalah Sheet1
• regex apakah diaktifkan mode pengecekan dengan metode regex? defaultnya false.

Jika regex false, huruf besar kecil akan dibedakan.

Kata aku berbeda dengan AKU, Aku, aKu, dst.

Parameter / Method

Paramater untuk mengonfig mini sheet DB nya. termasuk juga daftar method nya.

• ssID untuk menset / mengubah ssID nya.
• namaSheet (Sheet1) untuk menset / mengubah nama sheet nya.
• sheet kunci utama spreadsheet id.
• regex (false) untuk mengaktif/nonaktifkan regex nya. Contoh: db.regex = true
• baris (1) alamat baris dimulai, di set ke getRange.
• kolom (1) alamat kolom dimulai, di set ke getRange.
• nKolom(2) jumlah kolom yang akan diproses (ditampilkan), di set ke getRange.

• nBaris (false) jumlah baris yang akan diproses (ditampilan), di set ke getRange.

• getValue(address) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValue('A1');

• getValue(baris, kolom) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValue(1,1);

• getValues(address) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValues('A1');
• getValues(baris, kolom) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValues(1,1);
• getValues(baris, kolom, nBaris) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValues(1,1,2);

• getValues(baris, kolom, nBaris, nKolom) mendapatkan nilai dari alamat shel. Contoh: var hasil = db.getValues(1,1,1,2);

• setValue(address, nilai) mengisi nilai ke alamat shel yang dituju. Contoh: db.setValue('A2', 'Hasan')

• setValue(baris, kolom, nilai) mengisi nilai ke alamat shel yang dituju. Contoh: db.setValue(2,1, 'Hasan')

• setValues(address, nilai) mengisi nilai ganda ke alamat shel yang dituju. Contoh: db.setValues('A2', [['Hasan']])
• setValues(baris, kolom, nilai) mengisi nilai ke alamat shel yang dituju. Contoh: db.setValue(2,1, [['Hasan']])
• setValues(baris, kolom, nBaris, nilai) mengisi nilai ke alamat shel yang dituju. Contoh: db.setValues(2, 1, 2,[ ['Hasanudin'],['Syafaat'] ])

• setValues(baris, kolom, nBaris, nKolom, nilai) mengisi nilai ke alamat shel yang dituju. Contoh: db.setValues(2, 1, 2, 2, [ ['bang', 'Hasan'],['Husain', 'Syafaat'] ])

• has(kunci) mengecek kunci ada atau tidak. Hasil true/false. Contoh: db.has(kunci)
• get(kunci) mendapatkan data sesuai kunci. Contoh: db.get(kunci)
• getAll() mendapatkan semua data.

Spreadsheet

Pola defaultnya adalah: kolom A: id, dan kolom B: data

Kolom A, berisi kunci-kunci atau id nya.

Jika regex diaktifkan (true), id bisa diisi nilai regex. Misalnya:

h+[ae]+i+ untuk menangkap kunci: hai, hei, haaai, heeei, dst.

Contoh bisa dilihat di sini.

Contoh Code

Simple:

var db = new miniSheetDB.init('1B8JSBXqV0sIFZsuwDHQ8wOADFIAxgB7WDpJRh1JUei8');
db.regex = true;

function testGetALL() {
    var hasil = db.getAll();
    Logger.log(hasil);
}

function testGetKunci() {
    var hasil = db.get('nama');
    Logger.log(hasil);
}

Source

Dapat di cek pada github:

https://github.com/banghasan/minisheetdb

Video

Ikuti materi video di youtube:

• PlayList TIPS TRIK
• PlayList GAS-2
• PlayList GAS-1

Penutup

Jika ada pertanyaan, saran atau masukkan silakan didiskusikan. Jika ingin live dan biasanya tanggapan juga lebih cepat, sangat disarankan bergabung pada group Telegram @botIndonesia.