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 qui vise à résoudre ces tâches répétitives afin que vous puissiez vous concentrer sur la résolution de votre problème métier au lieu des erreurs qui peuvent être évitées grâce à l'automatisation.

Conditions requises

Utiliser dscc-gen

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

Connecteurs existants

dscc-gen peut également être utilisé 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 sera créé pour vous. Aucun de vos codes existants ne sera 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 à s'authentifier clasp. clasp est un outil permettant de créer et de modifier des projets Apps Script à partir de la ligne de commande.

Après avoir suivi les instructions, dscc-gen crée un projet Apps Script et affiche tout ce qu'il peut faire.

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 transférez-les vers Apps Script.
npm run prettier Mettez en forme votre code en respectant les normes de la communauté.
npm run try_latest Ouvrez le déploiement avec votre dernier code dans Data Studio.
npm run try_production Ouvrez votre déploiement de production dans Data Studio.
npm run update_production Mettez à jour votre déploiement en production pour utiliser votre dernier code.

Comment l'utiliser ?

Voici un exemple d'utilisation fréquente de dscc-gen :

  1. Identifiez une fonctionnalité que vous souhaitez ajouter à votre connecteur.
  2. Exécutez npm run watch pour que les modifications locales soient transférées vers Apps Script.
  3. Modifiez votre code à l'aide de votre éditeur JavaScript préféré.
  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 et y intégrer 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 partie de l'URL située 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