Modules complémentaires de l'éditeur de bâtiments

Suivez cette procédure générale lorsque vous créez un module complémentaire de l'éditeur:

  1. Créez un projet Apps Script.
  2. Écrivez du code permettant de définir l'apparence et le comportement du module complémentaire à l'aide du service HTML Apps Script intégré.
  3. Testez le module complémentaire.
  4. Publiez le module complémentaire.

Créer un projet de script

Un module complémentaire d'éditeur est un projet Apps Script autonome. Le guide du script autonome fournit des instructions pour créer des projets. Vous pouvez également simplement ouvrir un nouveau script. Dans ce cas, le fichier de projet (initialement nommé Untitled project) est placé dans votre dossier Drive racine.

Collaboration

Lorsque vous collaborez avec d'autres utilisateurs pour développer un module complémentaire, un seul compte utilisateur est propriétaire du projet de module complémentaire. Lorsque vous publiez un module complémentaire, un seul compte utilisateur fait office d'éditeur. Le compte de publication doit être autorisé à modifier le projet de script du module complémentaire, mais il n'a pas besoin d'être propriétaire du projet.

Il est très important d'éviter de perdre l'accès au code ou aux paramètres d'un module complémentaire parce que le propriétaire du projet a quitté votre organisation.

Pour éviter de perdre l'accès au code de module complémentaire, nous vous encourageons à utiliser des Drive partagés lorsque vous collaborez sur un module complémentaire. Le fait de placer le fichier de script du module complémentaire dans un Drive partagé garantit qu'aucun compte n'est le seul propriétaire du projet.

Il est également recommandé d'ajouter des collaborateurs au projet Cloud Platform (GCP) du projet de script. Cela permet de garantir qu'un membre de votre équipe puisse toujours accéder aux paramètres cloud du module complémentaire.

Coder le module complémentaire

Une fois que vous avez créé un projet de script, vous pouvez commencer à écrire du code pour définir l'apparence et le comportement du module complémentaire. Vous utilisez le service HTMLService d'Apps Script pour créer l'interface utilisateur du module complémentaire (boîtes de dialogue et barres latérales) à l'aide des langages HTML et CSS conventionnels. Ils peuvent également définir des éléments de menu personnalisés.

Au fur et à mesure que vous codez, consultez le guide de style pour les modules complémentaires de l'éditeur afin d'obtenir des consignes sur la conception de l'expérience utilisateur des modules complémentaires. Assurez-vous également de bien comprendre et de programmer les différents états du cycle de vie des autorisations que votre module complémentaire peut rencontrer.

Tester le module complémentaire

Vous pouvez tester les modules complémentaires des éditeurs avant leur publication pour vous assurer qu'ils se comportent comme prévu. Pour effectuer des tests, vous devez créer une configuration de test et utiliser un document, une feuille de calcul, un formulaire ou une présentation de test.

Pour en savoir plus, consultez Tester un module complémentaire de l'éditeur.

Publier le module complémentaire

En publiant votre module complémentaire, vous le rendez disponible pour d'autres utilisateurs, qu'ils soient publics ou seulement les utilisateurs de votre domaine. Avant de commencer le processus de publication, veillez à consulter la présentation des publications.

Les modules complémentaires des éditeurs sont publiés sur Google Workspace Marketplace. Les modules complémentaires accessibles au public doivent être examinés avant d'être publiés.

Pour en savoir plus, consultez Publier un module complémentaire d'éditeur.