Tester un module complémentaire de l'éditeur

Les modules complémentaires doivent être testés de façon approfondie avant d'être publiés pour s'assurer qu'ils fonctionnent comme prévu. Apps Script vous permet de tester les modules complémentaires de l'éditeur en cours de développement sur des fichiers Google Docs, Sheets, Forms ou Slides spécifiques. Cela peut être utilisé pour:

  • Vérifiez qu'un module complémentaire écrit dans un script autonome fonctionne comme prévu lorsqu'il est appliqué à une feuille, un document, une présentation ou un formulaire.
  • Vérifiez que le flux d'installation du module complémentaire fonctionne comme prévu, en particulier pour différents états initiaux du cycle de vie d'autorisation (installé, activé ou les deux).
  • Vérifiez que le module complémentaire fonctionne comme prévu lorsque vous agissez sur un document particulier et son contenu.
  • Testez et comparez la version actuelle et la version précédente du module complémentaire.

Créer un déploiement de test

Un déploiement test associe un module complémentaire et un document de test. Une fois que vous avez développé une version de script et que vous souhaitez la tester en tant que module complémentaire, procédez comme suit:

  1. Si vous n'en avez pas encore, créez une feuille de calcul, un document, une présentation ou un formulaire pour tester le module complémentaire.
  2. Ouvrez le projet de script contenant votre module complémentaire.
  3. Cliquez sur Déployer > Tester les déploiements.
  4. À côté de Sélectionner le type, cliquez sur "Activer les types de déploiement" , puis sélectionnez Module complémentaire de l'éditeur.
  5. Cliquez sur Créer un test ou sur Ajouter un test.
  6. Choisissez une version de code ou sélectionnez Dernier code.
  7. Dans la section Configuration, sélectionnez l'état d'autorisation initial pour le test.
  8. Sous Document de test, cliquez sur Aucun document sélectionné. Sélectionnez le fichier Sheets, Docs, Slides ou Forms que vous souhaitez utiliser pour tester le module complémentaire, puis cliquez sur Insérer.
  9. Cliquez sur Enregistrer le test.

Tous les déploiements de test enregistrés s'affichent dans la boîte de dialogue Tester les déploiements. Cela vous permet de revenir ultérieurement au même déploiement de test.

Exécuter un déploiement test

Si vous avez un ou plusieurs déploiements de test enregistrés, vous pouvez en exécuter un en procédant comme suit:

  1. Ouvrez le projet de script contenant votre module complémentaire.
  2. Cliquez sur Déployer > Tester les déploiements.
  3. Sous Saved Tests (Tests enregistrés), sélectionnez la case d'option à côté du déploiement de test enregistré que vous souhaitez exécuter, puis cliquez sur Execute (Exécuter).

Le document de test s'ouvre dans un nouvel onglet. L'état d'autorisation du module complémentaire est spécifié dans le déploiement test. Vous pouvez vérifier que le module complémentaire fonctionne comme prévu en interagissant avec son menu et ses éléments d'interface utilisateur.

Détails du test

Voici un certain nombre d'éléments à prendre en compte lorsque vous testez les modules complémentaires des éditeurs:

  • Les déclencheurs installables ne sont pas compatibles lors des tests. Les fonctionnalités qui dépendent de déclencheurs installables ne peuvent pas être testées.
  • Lors de l'exécution d'un déploiement de test configuré pour être testé avec le dernier code, vous pouvez voir les modifications enregistrées dans le script du module complémentaire en actualisant le document de test.
  • Le document de test possède une URL que vous pouvez partager avec les éditeurs du document de test d'origine. De cette façon, vous pouvez plus facilement collaborer avec d'autres personnes lors des tests et du développement.
  • Si votre module complémentaire utilise le service Properties, les propriétés sont conservées et restent disponibles lors de la prochaine exécution du déploiement test.
  • De plus, tout déploiement de test utilisant la même combinaison de document complémentaire et de document de test a accès aux mêmes informations de propriété. Par exemple, si vous créez deux déploiements de test, les propriétés enregistrées lors de l'exécution du premier sont disponibles lors de l'exécution du second et inversement, mais uniquement si les déploiements utilisent le même script et le même document de test.
  • Si vous exécutez un déploiement test, une autorisation peut vous être demandée si vous n'avez pas encore exécuté le script. Sachez que le fait d'autoriser un script lors des tests autorise également le script en dehors des tests.