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
- npm 5.2.0 atau yang lebih baru
- Pemahaman tentang command line.
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:
- Identifikasi fitur yang ingin Anda tambahkan ke konektor.
- Jalankan
npm run watch
agar perubahan lokal akan diterapkan ke Apps Script. - Buat perubahan kode menggunakan editor JavaScript favorit.
- Jalankan
npm run tryLatest
dan periksa apakah fitur baru Anda berfungsi seperti yang diharapkan. - Jalankan
npm run updateProduction
untuk mengupdate deployment produksi agar mendapatkan fitur baru Anda. - 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