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 ke project 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 apakah eksekusi skrip dari AppSheet berhasil.

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 ke fungsi tersebut.

  1. Buka halaman beranda Apps Script, lalu klik + New Project.
  2. Mengubah 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 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 Baju, lalu klik Buat salinan untuk mendownload dan membuka salinan di Google Spreadsheet. Anda dapat mengganti nama spreadsheet secara opsional, jika ingin (misalnya,"Pesanan Baju").
  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' di dialog pembuatan aplikasi baru.

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

AppSheet menyiapkan aplikasi Anda. Jendela pratinjau awal untuk aplikasi yang dibuat.

  1. 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 Kemeja dibuat atau diperbarui, kirim notifikasi.

5037cdd726e326e9.png

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

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 memberi otorisasi, klik Authorize dan ikuti petunjuknya.

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

  1. Pilih logThis(msg) dari daftar Nama Fungsi. Pilih fungsi Apps Script 'logThis()' di menu dropdown.

Kolom Function Arguments akan ditampilkan.

  1. Untuk argumen msg, masukkan ekspresi berikut menggunakan Asisten Ekspresi: 'Halo dari AppSheet'

Menambahkan argumen ke panggilan fungsi Apps Script.

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

68471f4646fc8fbe.png

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

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 Executions di menu 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.

Memulai Contoh Apps Script

  1. Untuk memulai, buat salinan Project Contoh Apps Script terlebih dahulu.
  2. Klik ikon salin.
  3. Simpan project baru dan 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() - 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.