Componenti aggiuntivi per Editor di edifici

Per la creazione di un componente aggiuntivo dell'editor, segui questa procedura generale:

  1. Creare un progetto Apps Script.
  2. Scrivi il codice per definire l'aspetto e il comportamento del componente aggiuntivo utilizzando il servizio HTML integrato di Apps Script.
  3. Testa il componente aggiuntivo.
  4. Pubblicare il componente aggiuntivo.

Crea un progetto di script

Un componente aggiuntivo dell'editor è un progetto Apps Script autonomo. La guida agli script autonomi fornisce istruzioni per creare nuovi progetti. Puoi anche aprire un nuovo script. In questo caso, il file di progetto (inizialmente denominato Untitled project) verrà inserito nella cartella principale di Drive.

Collaborazione

Quando collabori con altre persone allo sviluppo di un componente aggiuntivo, il progetto del componente aggiuntivo è di proprietà di un singolo account utente. Quando pubblichi un componente aggiuntivo, un singolo account utente agisce come editore. L'account di pubblicazione deve avere accesso in modifica al progetto di script del componente aggiuntivo, ma non è necessario che sia proprietario del progetto.

È molto importante evitare situazioni in cui perdi l'accesso al codice o alle impostazioni di un componente aggiuntivo perché il proprietario del progetto ha lasciato l'organizzazione.

Per evitare di perdere l'accesso al codice del componente aggiuntivo, ti invitiamo a utilizzare i Drive condivisi quando collabori a un componente aggiuntivo. Se posizioni il file di script dei componenti aggiuntivi in un Drive condiviso, nessun singolo account sia l'unico proprietario del progetto.

Ti consigliamo inoltre di aggiungere collaboratori al progetto Cloud Platform (GCP) del progetto di script. Ciò garantisce che qualcuno nel tuo team possa sempre accedere alle impostazioni Cloud del componente aggiuntivo.

Codificare il componente aggiuntivo

Una volta creato un progetto di script, puoi iniziare a scrivere codice per definire l'aspetto e il comportamento dei componenti aggiuntivi. Puoi utilizzare HTMLService di Apps Script per creare l'interfaccia utente del componente aggiuntivo (finestre e barre laterali) utilizzando HTML e CSS convenzionali. I componenti aggiuntivi di Editor possono anche definire voci di menu personalizzate.

Durante la programmazione, consulta la guida di stile per i componenti aggiuntivi dell'Editor per le linee guida su come progettare l'esperienza utente dei componenti aggiuntivi. Inoltre, assicurati di comprendere e programmare i diversi stati del ciclo di vita dell'autorizzazione che il componente aggiuntivo può incontrare.

Testare il componente aggiuntivo

Puoi testare i componenti aggiuntivi dell'editor prima che vengano pubblicati per assicurarti che funzionino come previsto. Il test richiede la creazione di una configurazione di test e l'utilizzo di un documento, un foglio di lavoro, un modulo o una presentazione di test.

Per i dettagli, consulta Testare un componente aggiuntivo Editor.

Pubblicare il componente aggiuntivo

La pubblicazione del componente aggiuntivo lo rende disponibile pubblicamente o solo per gli utenti del dominio. Prima di iniziare la procedura di pubblicazione, assicurati di leggere la panoramica della pubblicazione.

I componenti aggiuntivi dell'editor vengono pubblicati in Google Workspace Marketplace. I componenti aggiuntivi disponibili pubblicamente devono completare la revisione prima di essere pubblicati.

Per ulteriori dettagli, consulta la sezione Pubblicazione di un componente aggiuntivo Editor.