Tingkat coding: Pemula
Durasi: 5 menit
Jenis project: Fungsi kustom
Tujuan
- Pahami fungsi solusi tersebut.
- Pahami fungsi layanan Apps Script dalam solusi tersebut.
- Siapkan skrip.
- Jalankan skrip.
Tentang solusi ini
Jika Anda memiliki data terstruktur serupa di beberapa sheet dalam spreadsheet, seperti metrik dukungan pelanggan untuk anggota tim, Anda dapat menggunakan fungsi kustom ini untuk membuat ringkasan setiap sheet. Solusi ini berfokus pada tiket dukungan pelanggan, tetapi Anda dapat menyesuaikannya dengan kebutuhan.
Cara kerjanya
Fungsi kustom, yang disebut getSheetsData()
, merangkum data dari setiap sheet di spreadsheet berdasarkan kolom Status sheet. Skrip ini mengabaikan sheet yang tidak boleh disertakan dalam agregasi, seperti sheet ReadMe dan Summary.
Layanan Apps Script
Solusi ini menggunakan layanan berikut:
- Layanan spreadsheet–Mendapatkan sheet yang perlu diringkas dan menghitung jumlah item yang cocok dengan string yang ditentukan. Kemudian, skrip akan menambahkan informasi yang dihitung ke rentang yang sesuai dengan tempat fungsi kustom dipanggil di spreadsheet.
Prasyarat
Untuk menggunakan sampel ini, Anda memerlukan prasyarat berikut:
- Akun Google (akun Google Workspace mungkin memerlukan persetujuan administrator).
- Browser web dengan akses ke internet.
Menyiapkan skrip
Klik tombol di bawah untuk membuat salinan spreadsheet Merangkum data spreadsheet
fungsi kustom data. Project Apps Script untuk
solusi ini dilampirkan ke spreadsheet.
Buat salinan
Jalankan skrip:
- Di spreadsheet yang Anda salin, buka sheet Ringkasan.
- Klik sel
A4
. FungsigetSheetsData()
ada dalam sel ini. - Buka salah satu sheet pemilik dan perbarui atau tambahkan data ke sheet tersebut. Beberapa
tindakan yang dapat Anda coba meliputi hal berikut:
- Tambahkan baris baru dengan contoh informasi tiket.
- Di kolom Status, ubah status tiket yang ada.
- Ubah posisi kolom Status. Misalnya, di sheet Owner1, pindahkan kolom Status dari kolom C ke kolom D.
- Buka sheet Ringkasan dan tinjau tabel ringkasan yang telah diperbarui yang dibuat
getSheetsData()
dari selA4
. Anda mungkin harus mencentang kotak di baris 10 untuk memperbarui hasil yang di-cache dari fungsi kustom. Google menyimpan fungsi kustom ke dalam cache untuk mengoptimalkan performa.- Jika Anda menambahkan atau memperbarui baris, skrip akan memperbarui jumlah tiket dan status.
- Jika Anda memindahkan posisi kolom Status, skrip tetap berfungsi sebagaimana mestinya dengan indeks kolom baru.
Meninjau kode
Untuk meninjau kode Apps Script untuk solusi ini, klik Lihat kode sumber di bawah:
Melihat kode sumber
Code.gs
Modifikasi
Anda dapat mengedit fungsi kustom sesuai kebutuhan. Di bawah ini adalah tambahan opsional untuk memperbarui hasil fungsi kustom secara manual.
Muat ulang hasil yang di-cache
Tidak seperti fungsi bawaan, Google menyimpan fungsi kustom ke dalam cache untuk mengoptimalkan performa. Ini berarti bahwa jika Anda mengubah sesuatu dalam fungsi kustom Anda, seperti nilai yang sedang dihitung, pembaruan tersebut mungkin tidak langsung memaksakan pembaruan. Untuk memuat ulang hasil fungsi secara manual, lakukan langkah-langkah berikut:
- Tambahkan kotak centang ke sel kosong dengan mengklik Sisipkan > Kotak Centang.
- Tambahkan sel yang memiliki kotak centang sebagai parameter fungsi kustom, misalnya,
getSheetsData(B11)
. - Centang atau hapus centang pada kotak untuk memuat ulang hasil fungsi kustom.
Kontributor
Contoh ini dikelola oleh Google dengan bantuan Pakar Google Developers.