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
- npm 5.2.0 ou version ultérieure
- Une certaine connaissance de la ligne de commande.
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:
- Identifiez la fonctionnalité que vous souhaitez ajouter à votre connecteur.
- Exécutez
npm run watch
afin que les modifications locales soient transférées vers Apps Script. - Modifiez le code à l'aide de votre éditeur JavaScript favori.
- Exécutez
npm run tryLatest
et vérifiez que votre nouvelle fonctionnalité fonctionne comme prévu. - Exécutez
npm run updateProduction
pour mettre à jour votre déploiement de production afin de disposer de votre nouvelle fonctionnalité. - 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