Menghubungkan AppSheet dengan Apps Script

1. Pengantar

Dalam codelab ini, Anda akan membuat project Apps Script bernama "Hello World" lalu menambahkan fungsi sederhana, logThis, yang mencatat log pesan yang diteruskan ke log tersebut. Kemudian, Anda membuat otomatisasi Appsheet dan memintanya memanggil skrip. Setelah skrip dipanggil, Anda akan kembali ke editor Apps Script dan mengonfirmasi eksekusinya.

Yang akan Anda pelajari

• Cara membuat project Apps Script dengan fungsi sederhana.
• Cara membuat aplikasi AppSheet sederhana berdasarkan Spreadsheet Google yang sudah ada.
• Cara membuat Otomatisasi AppSheet yang memanggil fungsi skrip.
• Cara memeriksa keberhasilan eksekusi skrip dari AppSheet.

Yang Anda butuhkan

• Akses ke lingkungan pengembangan AppSheet (appsheet.com).
• Akses ke lingkungan pengembangan Apps Script (script.google.com).

2. Membuat project Apps Script

Pertama, buat project Apps Script bernama "Hello World" lalu menambahkan fungsi sederhana, logThis, yang mencatat log pesan yang diteruskan ke log tersebut.

1. Buka halaman beranda Apps Script, lalu klik + Project Baru.
2. Ubah judul project menjadi Hello World.
3. Perbarui skrip di editor seperti ini:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. Klik Save project.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan menghapus project.

3. Membuat aplikasi AppSheet

Selanjutnya, Anda dengan cepat membuat aplikasi AppSheet baru berdasarkan contoh Spreadsheet Google yang disalin, lalu memperbaruinya untuk memanggil project Apps Script yang Anda buat sebelumnya.

1. Buka spreadsheet Contoh Pesanan Kaus lalu klik Buat salinan untuk mendownload dan membuka salinan di Google Spreadsheet. Anda juga dapat mengganti nama {i>spreadsheet<i}, jika mau (misalnya, "Pesanan Kaos").
2. Login ke AppSheet.
3. Di halaman Aplikasi saya, klik + Buat aplikasi baru. Dialog Create a new app akan ditampilkan.
4. Klik Mulai dengan data Anda sendiri.
5. Anda juga dapat mengedit nama aplikasi dan memilih kategori.
6. Klik Pilih data Anda.

7. Klik google untuk mengakses Google Drive Anda.
8. Buka dan pilih spreadsheet Pesanan Baju yang Anda salin sebelumnya.

AppSheet menyiapkan aplikasi Anda.

9. Klik Customize your app untuk membuka aplikasi di editor AppSheet.

4. Membuat otomatisasi

Selanjutnya, Anda membuat otomatisasi Appsheet dan memintanya memanggil skrip.

1. Pilih Otomatisasi > Bot.
2. Klik + Bot Baru.
3. Pilih item pertama dalam daftar saran: Saat data Pesanan Kaus dibuat atau diperbarui, kirimkan notifikasi.

4. Klik langkah Kirim notifikasi untuk mengeditnya.
5. Ganti namanya menjadi Call a script.

6. Di bagian Setelan, ubah jenis tugas ke Memanggil skrip.

7. Di kolom Apps Script Project, klik Browse (ikon File).
8. Buka dan pilih project Apps Script Hello World di Drive Anda.
9. Klik Select dan, jika diminta untuk memberi otorisasi, klik Authorize dan ikuti petunjuknya.

Project Apps Script ditambahkan dan kolom Nama Fungsi diisi dengan daftar fungsi yang tersedia.

10. Pilih logThis(msg) dari daftar Nama Fungsi.

Kolom Function Arguments akan ditampilkan.

11. Untuk argumen msg, masukkan ekspresi berikut menggunakan Expression Assistant: ‘Hello from AppSheet'

12. Klik Simpan untuk menyimpan aplikasi.
13. Di Panel Pratinjau, klik ikon seluler atau tablet untuk menampilkan emulator aplikasi.

14. Tambahkan pesanan kemeja baru, lalu klik Simpan.
15. Klik Sinkronkan untuk menyinkronkan perubahan.

5. Mengonfirmasi eksekusi Apps Script

Setelah skrip dipanggil, kembali ke editor Apps Script dan konfirmasi eksekusinya.

1. Kembali ke halaman beranda Apps Script dan lihat project Hello World.
2. Klik Executions di menu navigasi untuk mengonfirmasi bahwa fungsi logThis berhasil diselesaikan. Klik Refresh jika log tidak muncul.

6. Langkah tambahan opsional

Sebagai langkah tambahan dalam workshop ini, tinjau project Contoh Apps Script dan jalankan beberapa contoh dari AppSheet.

Memulai Contoh Apps Script

1. Untuk memulai, buat salinan Project Contoh Apps Script terlebih dahulu.
2. Klik ikon salin.
3. Simpan project baru, lalu klik Run untuk mengizinkan aplikasi dalam project.

Bereksperimen dengan beberapa contoh

• createCalendarEvent() - Membuat acara Kalender baru.
• createDoc() - Membuat Dokumen baru secara otomatis.
• createSheet() - Membuat sheet baru.
• createSlideDeck() - Membuat slide presentasi baru menggunakan gambar dan teks.

Untuk mengetahui informasi selengkapnya tentang fitur penting ini, lihat Call Apps Script dari otomatisasi, yang menyediakan ringkasan mendetail, video unggulan, tutorial, dan project Apps Script yang dapat disalin yang berisi banyak contoh kerja AppSheet-Apps Script.