Sviluppo locale

Sebbene sia possibile eseguire tutte le attività relative al connettore utilizzando l'ambiente Apps Script online, alcune possono diventare ripetitive e soggette a errori nel tempo.

dscc-gen è uno strumento "guidato" pensato per svolgere queste attività ripetitive, in modo che tu possa concentrarti sulla risoluzione dei problemi aziendali anziché sugli errori che possono essere evitati con l'automazione.

Requisiti

In uso: dscc-gen

dscc-gen può creare nuovi progetti per i connettori della community o essere utilizzati con progetti esistenti.

Connettori esistenti

dscc-gen può essere utilizzato anche con progetti esistenti. Innanzitutto, copia scriptId, quindi esegui questo comando (sostituendo YOUR_SCRIPT_ID con il tuo scriptId):

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

Ti verranno chieste alcuni dettagli relativi al connettore. Se non hai già un deployment chiamato "Produzione", ne verrà creato uno automaticamente. Il codice esistente non verrà modificato, ma avrai accesso a tutto ciò che può fare dscc-gen.

Nuovi connettori

Per creare un nuovo connettore della community con dscc-gen, esegui questo comando:

npx @google/dscc-gen connector

Ti verranno chieste alcuni dettagli per il nuovo connettore. Ai nuovi utenti verrà chiesto di autenticare clasp. clasp è uno strumento per creare e modificare progetti Apps Script dalla riga di comando.

Dopo aver completato i prompt, dscc-gen creerà un nuovo progetto Apps Script e stamperà tutto ciò che può fare.

Che cosa può fare l'app dscc-gen?

Comando Descrizione
npm run open Apri il progetto in Apps Script.
npm run push Esegui il push delle modifiche locali ad Apps Script.
npm run watch Controlla le modifiche locali ed eseguine il push in Apps Script.
npm run prettier Formatta il codice utilizzando gli standard della community.
npm run try_latest Apri il deployment con il codice più recente in Looker Studio.
npm run try_production Apri il deployment di produzione in Looker Studio.
npm run update_production Aggiorna il deployment in produzione per utilizzare il codice più recente.

Come si usa?

L'utilizzo di dscc-gen spesso si traduce in:

  1. Identifica una funzionalità da aggiungere al connettore.
  2. Esegui npm run watch per inviare le modifiche locali ad Apps Script.
  3. Apporta le modifiche al codice utilizzando il tuo editor JavaScript preferito.
  4. Esegui npm run tryLatest e verifica che la nuova funzionalità funzioni come previsto.
  5. Esegui npm run updateProduction per aggiornare il deployment di produzione in modo che abbia la nuova funzionalità.
  6. Esegui npm run tryProduction e verifica che la nuova funzionalità funzioni.

Ottieni l'ID script

Per ottenere scriptId, vai al progetto esistente, quindi copia la sezione dell'URL dopo il giorno /d/ e prima del giorno /edit. Ad esempio, il seguente URL:

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