Pengembangan lokal

Meskipun Anda dapat menyelesaikan semua tugas terkait konektor menggunakan lingkungan Apps Script online, beberapa di antaranya dapat menjadi berulang dan rentan error dari waktu ke waktu.

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

Persyaratan

Menggunakan dscc-gen

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

Konektor yang ada

dscc-gen juga dapat digunakan dengan project yang ada. Pertama, salin scriptId, 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 tentang konektor. Jika Anda belum memiliki deployment yang disebut "Produksi", deployment akan dibuat. Tidak ada kode Anda 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 Anda. Pengguna pertama kali akan diminta untuk mengautentikasi 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 dilakukan.

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 Perhatikan perubahan lokal, lalu kirim ke Apps Script.
npm run prettier Format kode Anda menggunakan standar komunitas.
npm run try_latest Buka deployment dengan kode terbaru Anda di Looker Studio.
npm run try_production Buka deployment Produksi Anda di Looker Studio.
npm run update_production Perbarui deployment produksi Anda untuk menggunakan kode terbaru Anda.

Bagaimana cara menggunakannya?

Penggunaan dscc-gen sering kali terlihat seperti ini:

  1. Identifikasi fitur yang ingin Anda tambahkan ke konektor.
  2. Jalankan npm run watch agar perubahan lokal akan diterapkan ke Apps Script.
  3. Buat perubahan kode menggunakan editor JavaScript favorit.
  4. Jalankan npm run tryLatest dan periksa apakah fitur baru Anda berfungsi seperti yang diharapkan.
  5. Jalankan npm run updateProduction untuk mengupdate deployment produksi agar mendapatkan fitur baru Anda.
  6. Jalankan npm run tryProduction dan periksa kembali apakah fitur baru ini berfungsi.

Mendapatkan ID skrip

Untuk mendapatkan scriptId, buka project yang sudah 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