Testare un componente aggiuntivo Editor

I componenti aggiuntivi devono essere testati accuratamente prima della pubblicazione per assicurarsi che si comportino come previsto. Apps Script ti consente di testare componenti aggiuntivi di Editor in fase di sviluppo in file di Documenti, Fogli, Moduli o Presentazioni Google specifici. Questo può essere utilizzato per:

  • Verifica che un componente aggiuntivo scritto in uno script autonomo funzioni come previsto quando viene applicato a un foglio, un documento, una presentazione o un modulo.
  • Verifica che il flusso di installazione del componente aggiuntivo funzioni come previsto, in particolare per diversi stati del ciclo di vita dell'autorizzazione iniziali (installato, abilitato o entrambi).
  • Verifica che il componente aggiuntivo funzioni come previsto quando agisce su un determinato documento e sui relativi contenuti.
  • Testa e confronta le versioni attuale e precedente del componente aggiuntivo.

Creare un deployment di test

Un deployment di test è la combinazione di un componente aggiuntivo e di un documento di test. Una volta sviluppata una versione dello script e volendo testarla come componente aggiuntivo, segui questi passaggi:

  1. Se non ne hai già uno, crea un foglio di lavoro, un documento, una presentazione o un modulo per testare il componente aggiuntivo.
  2. Apri il progetto di script contenente il componente aggiuntivo.
  3. Fai clic su Esegui il deployment > Testa i deployment.
  4. Accanto a Seleziona tipo, fai clic su Attiva i tipi di implementazione e seleziona Componente aggiuntivo Editor.
  5. Fai clic su Crea nuovo test o Aggiungi test.
  6. Scegli una versione del codice o seleziona Codice più recente.
  7. Nella sezione Config, seleziona lo stato di autorizzazione iniziale per il test.
  8. In Documento di test, fai clic su Nessun documento selezionato. Seleziona il file di Fogli, Documenti, Presentazioni o Moduli che vuoi utilizzare per testare il componente aggiuntivo e fai clic su Inserisci.
  9. Fai clic su Salva test.

Tutti i deployment di test salvati vengono visualizzati nella finestra di dialogo Deployment di test. In questo modo, potrai esaminare di nuovo lo stesso deployment di test in un secondo momento.

Esegui un deployment di prova

Se hai uno o più implementazioni di test salvate, puoi eseguirne una seguendo questi passaggi:

  1. Apri il progetto di script contenente il componente aggiuntivo.
  2. Fai clic su Esegui il deployment > Testa i deployment.
  3. In Test salvati, seleziona il pulsante di opzione accanto al deployment del test salvato che vuoi eseguire e fai clic su Esegui.

Il documento di test si apre in una nuova scheda. Il componente aggiuntivo si trova nello stato di autorizzazione specificato nel deployment di test. Puoi verificare che il componente aggiuntivo funzioni come previsto interagendo con il menu e gli elementi dell'interfaccia utente.

Dettagli dei test

Esistono diversi aspetti da tenere presenti durante il test dei componenti aggiuntivi di Editor in questo modo:

  • Gli attivatori installabili non sono supportati durante i test. La funzionalità che dipende da attivatori installabili non è testabile.
  • Durante l'esecuzione di un deployment di test impostato per il test con il codice più recente, puoi vedere le modifiche salvate nello script del componente aggiuntivo aggiornando il documento di test.
  • Il documento di test ha un URL che puoi condividere con gli editor del documento di test originale. In questo modo, puoi collaborare più facilmente con altre persone durante il test e lo sviluppo.
  • Se il tuo componente aggiuntivo utilizza il servizio Proprietà, le proprietà rimangono e rimangono disponibili alla successiva esecuzione dell'implementazione di test.
  • Inoltre, qualsiasi implementazione di test che utilizza la stessa combinazione di componente aggiuntivo e documento di test ha accesso alle stesse informazioni sulla proprietà. Ad esempio, se crei due implementazioni di test, le proprietà salvate durante l'esecuzione della prima sono disponibili durante l'esecuzione della seconda e viceversa, ma solo se le implementazioni utilizzano lo stesso script e lo stesso documento di test.
  • Se esegui un deployment di prova, ti potrebbe essere richiesta l'autorizzazione se non hai mai eseguito lo script. Tieni presente che l'autorizzazione di uno script durante il test lo autorizza anche al di fuori del test.