Tester un module complémentaire d'éditeur

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les modules complémentaires doivent être testés de manière approfondie avant d'être publiés, pour vous 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 permet:

  • 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 (installés, activés ou les deux).
  • Vérifiez que le module complémentaire fonctionne comme prévu lorsque vous agissez sur un document et son contenu spécifiques.
  • Testez et comparez les versions actuelles et antérieures 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:

  1. Si vous ne l'avez pas encore fait, 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 > Déployer des tests.
  4. À côté de Sélectionner un 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 du code ou sélectionnez Dernier code.
  7. Dans la section Config, sélectionnez l'état d'autorisation initial du test.
  8. Sous Tester le document, cliquez sur Aucun document sélectionné. Sélectionnez le fichier Sheets, Docs, Slides ou Forms que vous souhaitez utiliser pour tester le module, 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 Tests de déploiement. Cela vous permet de revoir ultérieurement le même déploiement de test.

Exécuter un déploiement test

Si vous disposez d'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 > Déployer des tests.
  3. Sous Tests enregistrés, sélectionnez la case d'option correspondant au 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 est à l'é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 son menu et ses éléments d'interface utilisateur.

Détails du test

Voici quelques points à retenir lorsque vous testez des modules complémentaires d'éditeur:

  • Les déclencheurs installables ne sont pas pris en charge 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é avec le dernier code de test, vous pouvez afficher 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. Vous pourrez ainsi collaborer plus facilement avec d'autres personnes pendant les tests et le développement.
  • Si votre module complémentaire utilise le service des propriétés, les propriétés sont conservées et restent disponibles lors de la prochaine exécution du déploiement de test.
  • En outre, tout déploiement de test qui utilise la même combinaison de module complémentaire et de document 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, vous pouvez être invité à donner votre autorisation si vous n'avez pas encore exécuté le script. Sachez qu'autoriser un script pendant le test l'autorise également en dehors du test.