Les modules complémentaires doivent être testés minutieusement avant leur publication se comportent comme prévu. Apps Script vous permet de tester Modules complémentaires de l'éditeur en cours de développement sur des fichiers Google Docs, Sheets, Forms ou Slides spécifiques. Ce permet:
- Vérifier qu'un module complémentaire écrit dans un script autonome fonctionne comme prévu lorsqu'elle est appliquée à une feuille, un document, une présentation ou un formulaire.
- Vérifiez que le processus d'installation du module complémentaire fonctionne comme prévu, en particulier pour initiale différente États du cycle de vie des autorisations (installée, activée ou les deux).
- Vérifiez que le module complémentaire fonctionne comme prévu document et son contenu.
- Tester et comparer la version actuelle et la version précédente 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 n'en avez pas encore, créez une feuille de calcul, un document présentation ou formulaire pour tester le module complémentaire.
- Ouvrez le projet de script contenant votre module complémentaire.
- Cliquez sur Déployer > Tester les déploiements.
- À côté de Sélectionner le type, cliquez sur "Activer les types de déploiement" . et sélectionnez Module complémentaire de l'éditeur.
- Cliquez sur Créer un test ou sur Ajouter un test.
- Choisissez une version de code ou sélectionnez Code le plus récent.
- Dans la section Configuration, sélectionnez l'état d'autorisation initial pour le test.
- Sous Document de test, cliquez sur Aucun document sélectionné. Sélectionnez l'application Sheets, Docs, Fichier 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 test enregistrés s'affichent dans la boîte de dialogue Tester les déploiements. Cela permet vous reviendrez sur le même déploiement de test par la suite.
Exécuter un déploiement test
Si vous avez un ou plusieurs déploiements de test enregistrés, vous pouvez exécuter l'un d'entre eux en en procédant comme suit:
- Ouvrez le projet de script contenant votre module complémentaire.
- Cliquez sur Déployer > Tester les déploiements.
- Sous Tests enregistrés, cochez la case d'option à côté du test enregistré. le déploiement que vous souhaitez exécuter, puis cliquez sur Exécuter.
Le document de test s'ouvre dans un nouvel onglet. Le module complémentaire se trouve dans État d'autorisation spécifié dans le déploiement de test. Vous pouvez vérifier que le module complémentaire fonctionne comme prévu en interagissant avec ses éléments de menu et d'interface utilisateur.
Détails du test
Lorsque vous testez les modules complémentaires des éditeurs, vous devez tenir compte de plusieurs points. de cette façon:
- Déclencheurs installables ne sont pas prises en charge lors des tests. Fonctionnalité qui dépend de l'environnement d'installation ne peut pas être testé.
- Lors de l'exécution d'un déploiement test configuré pour tester le code le plus récent, vous peuvent voir les modifications enregistrées dans le script du module complémentaire en actualisant le document de test.
- Le document de test comporte une URL que vous pouvez partager avec les éditeurs de l'original. document de test. Vous pourrez ainsi collaborer plus facilement en phase de test et de développement.
- Si votre module complémentaire utilise Service des propriétés sont conservées et restent disponibles la prochaine fois que le déploiement s'exécute.
- De plus, tout déploiement de test utilisant la même combinaison de modules complémentaires le document de test a accès aux mêmes informations sur les propriétés. Par exemple, si vous créer 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 de la deuxième, 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 qui n'ont jamais exécuté le script auparavant. Sachez qu'autoriser un script le test autorise également le script en dehors des tests.