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

  1. Buka halaman beranda Apps Script lalu klik + Project Baru.
  2. Ubah judul project menjadi Hello World. Ganti nama dialog Project dengan nama baru.
  3. Perbarui skrip di editor seperti ini:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. 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 Baju, lalu klik Buat salinan untuk mendownload dan membuka salinan di Google Spreadsheet. Anda dapat mengganti nama spreadsheet secara opsional, jika diinginkan (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 dapat mengedit nama aplikasi, lalu memilih kategori.
  6. Klik Pilih data Anda.

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

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

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

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

4. Membuat otomatisasi

Selanjutnya, Anda membuat otomatisasi Appsheet dan meminta skrip tersebut dipanggil.

  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 nama menjadi Call a script.

Langkah-langkah otomatisasi untuk memanggil Skrip.

  1. Di bagian Setelan, ubah jenis tugas menjadi Call a script.

Memilih jenis tugas 'Telepon skrip' di setelan Otomatisasi.

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

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

  1. Pilih logThis(msg) dari daftar Function Name. Memilih fungsi Apps Script 'logThis()' di dropdown.

Kolom Argumen Fungsi akan ditampilkan.

  1. Untuk argumen msg, masukkan ekspresi berikut menggunakan Expression Assistant: '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 kaus baru, lalu klik Simpan.
  2. Klik Sinkronkan untuk menyinkronkan perubahan.

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

5. Konfirmasi eksekusi Apps Script

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

  1. Kembali ke halaman beranda Apps Script dan lihat project Hello World.
  2. Klik Eksekusi 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 Skrip Apps terlebih dahulu.
  2. Klik ikon salin.
  3. Simpan project baru dan klik Run untuk mengizinkan aplikasi dalam project.

Bereksperimen dengan beberapa contoh

  • createCalendarEvent() - Buat acara Kalender baru.
  • createDoc() - Otomatis membuat Dokumen baru.
  • createSheet() - Buat sheet baru.
  • createSlideDeck() - Buat dek slide baru menggunakan gambar dan teks.

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