Développement local

Bien que vous puissiez effectuer toutes les tâches liées aux connecteurs à l'aide de l'environnement Apps Script en ligne, certaines d'entre elles peuvent devenir répétitives et sujettes aux erreurs au fil du temps.

dscc-gen est un outil avisé conçu pour gérer ces tâches répétitives afin que vous puissiez vous concentrer sur la résolution de votre problème métier plutôt que sur les erreurs qui peuvent être évitées grâce à l'automatisation.

Conditions requises

Utiliser dscc-gen

dscc-gen peut créer des projets de connecteur de communauté ou être utilisé avec des projets existants.

Connecteurs existants

Vous pouvez également utiliser dscc-gen avec des projets existants. Commencez par copier votre scriptId, puis exécutez la commande suivante (en remplaçant YOUR_SCRIPT_ID par votre scriptId):

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

Vous serez invité à fournir quelques informations sur votre connecteur. Si vous n'avez pas encore de déploiement appelé "Production", un déploiement sera créé pour vous. Votre code existant ne sera pas modifié, mais vous aurez accès à tout ce que dscc-gen peut faire.

Nouveaux connecteurs

Pour créer un connecteur de communauté avec dscc-gen, exécutez la commande suivante:

npx @google/dscc-gen connector

Vous serez invité à fournir quelques informations sur votre nouveau connecteur. Les nouveaux utilisateurs seront invités à authentifier clasp. clasp est un outil permettant de créer et de modifier des projets Apps Script à partir de la ligne de commande.

Une fois les invites terminées, dscc-gen crée un projet Apps Script et affiche toutes les tâches qu'il peut effectuer.

Que peut faire dscc-gen ?

Commande Description
npm run open Ouvrez votre projet dans Apps Script.
npm run push Transférez vos modifications locales vers Apps Script.
npm run watch Surveillez les modifications locales et déployez-les dans Apps Script.
npm run prettier Mettez en forme votre code en suivant les normes de la communauté.
npm run try_latest Ouvrez le déploiement avec votre dernier code dans Looker Studio.
npm run try_production Ouvrez votre déploiement de production dans Looker Studio.
npm run update_production Mettez à jour votre déploiement de production pour utiliser votre dernier code.

Comment l'utiliser ?

L'utilisation de dscc-gen ressemble souvent à ceci:

  1. Identifiez la fonctionnalité que vous souhaitez ajouter à votre connecteur.
  2. Exécutez npm run watch afin que les modifications locales soient transférées vers Apps Script.
  3. Modifiez le code à l'aide de votre éditeur JavaScript favori.
  4. Exécutez npm run tryLatest et vérifiez que votre nouvelle fonctionnalité fonctionne comme prévu.
  5. Exécutez npm run updateProduction pour mettre à jour votre déploiement de production afin de disposer de votre nouvelle fonctionnalité.
  6. Exécutez npm run tryProduction et vérifiez que la nouvelle fonctionnalité fonctionne.

Obtenir l'ID de votre script

Pour obtenir votre scriptId, accédez à votre projet existant, puis copiez la section de l'URL après /d/ et avant /edit. Par exemple, l'URL suivante :

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