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 pesan yang diteruskan kepadanya. Kemudian, Anda membuat otomatisasi AppSheet dan memintanya untuk 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 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 tambahkan fungsi sederhana, logThis, yang mencatat pesan yang diteruskan kepadanya.

  1. Buka halaman beranda Apps Script, lalu klik + New Project.
  2. Ubah judul project menjadi Hello World. Dialog Ganti Nama Project dengan nama baru.
  3. Perbarui skrip di editor seperti ini:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Klik Simpan project.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan menghapus project.

3. Membuat aplikasi AppSheet

Selanjutnya, Anda akan 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 Kemeja, lalu klik Buat salinan untuk mendownload dan membuka salinan di Google Spreadsheet. Anda dapat mengganti nama spreadsheet jika ingin (misalnya,"Pesanan Kemeja").
  2. Login ke AppSheet.
  3. Di halaman Aplikasi saya, klik + Buat aplikasi baru. Dialog Buat aplikasi baru akan ditampilkan.
  4. Klik Mulai dengan data Anda sendiri. Dialog Pembuatan Aplikasi Baru.
  5. Anda juga dapat mengedit nama aplikasi dan memilih kategori.
  6. Klik Pilih data Anda.

Memilih 'Pilih data Anda' dalam dialog pembuatan aplikasi baru.

  1. Klik google untuk mengakses Google Drive Anda.
  2. Buka dan pilih spreadsheet Shirt Orders yang Anda salin sebelumnya.

AppSheet akan menyiapkan aplikasi Anda. Jendela pratinjau awal untuk aplikasi yang dihasilkan.

  1. Klik Sesuaikan aplikasi Anda untuk membuka aplikasi di editor AppSheet.

4. Membuat otomatisasi

Selanjutnya, Anda membuat otomatisasi AppSheet dan membuatnya memanggil skrip.

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

5037cdd726e326e9.png

  1. Klik langkah Kirim notifikasi untuk mengeditnya.
  2. Ganti namanya menjadi Call a script.

Langkah-langkah otomatisasi untuk memanggil Skrip.

  1. Di bagian Setelan, ubah jenis tugas menjadi Panggil skrip.

Memilih jenis tugas 'Panggil skrip' di setelan Otomatisasi.

  1. Di kolom Apps Script Project, klik Browse (ikon File).
  2. Buka dan pilih project Apps Script Hello World di Drive Anda.
  3. Klik Select dan, jika diminta untuk memberikan otorisasi, klik Authorize, lalu ikuti petunjuknya.

Project Apps Script ditambahkan dan kolom Function Name diisi dengan daftar fungsi yang tersedia.

  1. Pilih logThis(msg) dari daftar Function Name. Memilih fungsi Apps Script 'logThis()' di menu drop-down.

Kolom Function Arguments akan ditampilkan.

  1. Untuk argumen msg, masukkan ekspresi berikut menggunakan Asisten Ekspresi: ‘Hello from AppSheet'

Menambahkan argumen ke panggilan fungsi Apps Script.

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

68471f4646fc8fbe.png

  1. Tambahkan pesanan baju baru, lalu klik Simpan.
  2. Klik Sync untuk menyinkronkan perubahan Anda.

Mengklik ikon sinkronisasi di kanan atas Panel Pratinjau untuk menyinkronkan dengan sumber data.

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 Eksekusi di panel navigasi untuk mengonfirmasi bahwa fungsi logThis berhasil diselesaikan. Klik Muat ulang jika log belum muncul.

Melihat log eksekusi di lingkungan editor Apps Script untuk memeriksa eksekusi fungsi dari panggilan AppSheet.

6. Langkah tambahan opsional

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

Mulai menggunakan 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 memberikan otorisasi pada aplikasi dalam project.

Bereksperimen dengan beberapa contoh

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

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