Les modules complémentaires doivent être testés de manière approfondie avant leur publication, afin de garantir leur bon fonctionnement. Apps Script vous permet de tester les modules complémentaires des éditeurs en cours de développement sur des fichiers Google Docs Sheets, Forms ou Slides spécifiques. Vous pouvez ainsi:
- 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 les différents états du cycle de vie d'autorisation initial (installé, activé ou les deux).
- Vérifiez que le module complémentaire fonctionne comme prévu lorsqu'il agit sur un document particulier et son contenu.
- Testez et comparez les versions actuelles et précédentes du module complémentaire.
Créer un déploiement test
Un déploiement test est la combinaison d'un module complémentaire et d'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:
- Si vous ne l'avez pas déjà fait, créez une feuille de calcul, un document, une présentation ou un formulaire pour tester le module complémentaire.
- Ouvrez le projet de script contenant votre module complémentaire.
- Cliquez sur Déployer > Tests de déploiement.
- À côté de Sélectionner un type, cliquez sur Activer les types de déploiement , puis sélectionnez Module complémentaire de l'éditeur.
- Cliquez sur Créer un test ou sur Ajouter un test.
- Choisissez une version du code ou sélectionnez Dernier code.
- Dans la section Configuration, sélectionnez l'état d'autorisation initial du test.
- 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.
- Cliquez sur Enregistrer le test.
Tous les déploiements de tests 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 enregistré un ou plusieurs déploiements de test enregistrés, vous pouvez en exécuter un en procédant comme suit:
- Ouvrez le projet de script contenant votre module complémentaire.
- Cliquez sur Déployer > Tests de déploiement.
- Sous 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 Exécuter.
Le document de test s'ouvre dans un nouvel onglet. Le module complémentaire possède l'état d'autorisation 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 quelques points à retenir lorsque vous testez des modules complémentaires Editor:
- Les déclencheurs installables ne sont pas acceptés lors des tests. Une fonctionnalité qui dépend de déclencheurs d'installation n'est pas testable.
- Lorsque vous exécutez un déploiement test configuré pour tester le dernier code, vous pouvez afficher les modifications enregistrées dans le script du module complémentaire en actualisant le document de test.
- Le document de test contient une URL que vous pouvez partager avec les éditeurs du document de test d'origine. Ainsi, vous pouvez collaborer plus facilement avec d'autres utilisateurs pendant les tests et le développement.
- Si votre module complémentaire utilise le service Properties, les propriétés persistent et restent disponibles lors du prochain déploiement test.
- De plus, tout déploiement de test utilisant la même combinaison de modules complémentaires et de documents de test a accès aux mêmes informations sur les propriétés. 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 qu'autoriser un script pendant les tests l'autorise également en dehors des tests.