Pengembangan lokal

Meskipun Anda dapat menyelesaikan semua tugas terkait konektor menggunakan Aplikasi online di lingkungan skrip, beberapa di antaranya dapat menjadi berulang dan rentan terhadap kesalahan baik.

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

Persyaratan

Menggunakan dscc-gen

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

Konektor yang ada

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

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

Anda akan diminta untuk memberikan beberapa detail tentang konektor Anda. Jika Anda belum memiliki deployment bernama "Production", satu deployment akan dibuat untuk Anda. Tidak ada kode yang ada akan diubah, tetapi Anda akan memiliki akses ke apa saja 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 untuk memberikan beberapa detail untuk konektor baru. Pengguna baru akan diminta untuk mengautentikasi clasp. clasp adalah alat untuk membuat & memodifikasi 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 Terapkan perubahan lokal ke Apps Script.
npm run watch Perhatikan perubahan lokal, lalu terapkan ke Aplikasi Naskah.
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 Membuka deployment Produksi di Looker di Studio.
npm run update_production Update deployment produksi untuk menggunakan dari kode terbaru.

Bagaimana Cara Menggunakannya?

Penggunaan dscc-gen sering kali kurang lebih seperti ini:

  1. Tentukan fitur yang ingin Anda tambahkan ke konektor.
  2. Jalankan npm run watch, sehingga perubahan lokal akan dikirim ke Apps Script.
  3. Membuat perubahan kode menggunakan favorit Anda JavaScript JavaScript.
  4. Jalankan npm run tryLatest dan periksa apakah fitur baru Anda berfungsi sebagai yang diharapkan.
  5. Jalankan npm run updateProduction untuk memperbarui deployment produksi agar fitur baru Anda.
  6. Jalankan npm run tryProduction dan periksa kembali apakah fitur baru tersebut berfungsi.

Mendapatkan ID skrip

Untuk mendapatkan scriptId, buka project yang ada, lalu salin bagian tersebut 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