Pengembangan lokal

Meskipun Anda dapat menyelesaikan semua tugas terkait konektor menggunakan lingkungan Apps Script online, beberapa tugas tersebut dapat menjadi berulang dan rentan terhadap error seiring waktu.

dscc-gen adalah alat yang memiliki opini dan dimaksudkan untuk menangani tugas-tugas berulang ini sehingga Anda dapat berfokus pada penyelesaian masalah bisnis, bukan pada error yang dapat dihindari melalui otomatisasi.

Persyaratan

Menggunakan dscc-gen

dscc-gen dapat membuat project konektor komunitas baru atau digunakan dengan project yang sudah ada.

Konektor yang ada

dscc-gen juga dapat digunakan dengan project yang sudah ada. Pertama, salin scriptId Anda, lalu jalankan perintah berikut (ganti YOUR_SCRIPT_ID dengan scriptId Anda):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Anda akan diminta memberikan beberapa detail untuk konektor. Jika Anda belum memiliki deployment bernama "Production", deployment tersebut akan dibuat untuk Anda. Tidak ada kode yang ada yang akan diubah, tetapi Anda akan memiliki akses ke semua yang dapat dilakukan dscc-gen.

Konektor baru

Untuk membuat konektor komunitas baru dengan dscc-gen, jalankan perintah berikut:

npx @google/dscc-gen connector

Anda akan diminta memberikan beberapa detail untuk konektor baru. Pengguna baru akan diminta untuk melakukan autentikasi clasp. clasp adalah alat untuk membuat & mengubah project Apps Script dari command line.

Setelah menyelesaikan perintah, dscc-gen akan membuat project Apps Script baru dan mencetak semua yang dapat dilakukannya.

Apa yang dapat dilakukan dscc-gen?

Perintah Deskripsi
npm run open Buka project Anda di Apps Script.
npm run push Kirim perubahan lokal Anda ke Apps Script.
npm run watch Pantau perubahan lokal, dan kirimkan ke Apps Script.
npm run prettier Format kode Anda menggunakan standar komunitas.
npm run try_latest Buka deployment dengan kode terbaru Anda di Data Studio.
npm run try_production Buka deployment Produksi Anda di Data Studio.
npm run update_production Perbarui deployment produksi Anda untuk menggunakan kode terbaru.

Bagaimana cara menggunakannya?

Penggunaan dscc-gen sering kali seperti ini:

  1. Identifikasi fitur yang ingin Anda tambahkan ke konektor.
  2. Jalankan npm run watch, sehingga perubahan lokal akan di-push ke Apps Script.
  3. Lakukan perubahan kode menggunakan editor JavaScript JavaScript favorit Anda.
  4. Jalankan npm run tryLatest dan periksa apakah fitur baru Anda berfungsi seperti yang diharapkan.
  5. Jalankan npm run updateProduction untuk memperbarui deployment produksi agar memiliki fitur baru Anda.
  6. Jalankan npm run tryProduction dan periksa kembali apakah fitur baru berfungsi.

Mendapatkan ID skrip

Untuk mendapatkan scriptId, buka project yang ada, lalu salin bagian URL setelah /d/ dan sebelum /edit. Misalnya: URL berikut:

  • URL Asli: https://script.google.com/a/google.com/d/example-script-id/edit
  • ID Skrip: example-script-id