I componenti aggiuntivi devono essere testati a fondo prima della pubblicazione per assicurarsi che si comportino come previsto. Apps Script ti consente di testare i componenti aggiuntivi per gli editor in fase di sviluppo su file specifici di Documenti, Fogli, Moduli o Presentazioni Google. Puoi utilizzarlo 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 (installato, attivato o entrambi).
- Verifica che il componente aggiuntivo funzioni come previsto quando agisce su un particolare 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 un documento di test. Una volta sviluppata una versione dello script e se vuoi testarla come componente aggiuntivo, segui questi passaggi:
- Se non ne hai già uno, crea un foglio di lavoro, un documento, una presentazione o un modulo per testare il componente aggiuntivo.
- Apri il progetto di script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa i deployment.
- Accanto a Seleziona tipo, fai clic su Attiva tipi di deployment e seleziona Componente aggiuntivo Editor.
- Fai clic su Crea nuovo test o Aggiungi test.
- Scegli una versione del codice o seleziona Ultimo codice.
- Nella sezione Config (Configurazione), seleziona lo stato di autorizzazione iniziale per il test.
- In Documento di test, fai clic su Nessun documento selezionato. Seleziona il file Fogli, Documenti, Presentazioni o Moduli che vuoi utilizzare per testare il componente aggiuntivo e fai clic su Inserisci.
- Fai clic su Salva test.
Tutti i deployment di test salvati vengono visualizzati nella finestra di dialogo Deployment di test. In questo modo potrai rivisitare lo stesso deployment di test in un secondo momento.
Eseguire un deployment di prova
Se hai uno o più test di implementazione salvati, puoi eseguirne uno seguendo questi passaggi:
- Apri il progetto di script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa i deployment.
- Nella sezione Test salvati, seleziona il pulsante di opzione accanto all'implementazione 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 suo menu e gli elementi dell'interfaccia utente.
Per testare la funzionalità OAuth granulare sul tuo componente aggiuntivo, assicurati che il tuo progetto non disponga già di autorizzazioni. Per invalidare le autorizzazioni esistenti, utilizza ScriptApp.invalidateAuth.
Dettagli del test
Ci sono una serie di cose da tenere a mente durante il test dei componenti aggiuntivi di Editor in questo modo:
- Gli attivatori installabili non sono supportati durante il test. La funzionalità che dipende da trigger installabili non è testabile.
- Durante l'esecuzione di un deployment di test configurato per il test con il codice più recente, puoi visualizzare 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 i test e lo sviluppo.
- Se il componente aggiuntivo utilizza il servizio Proprietà, le proprietà vengono mantenute e rimangono disponibili la volta successiva che viene eseguito il test di implementazione.
- Inoltre, qualsiasi deployment 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 test di implementazione, le proprietà salvate durante l'esecuzione del primo sono disponibili durante l'esecuzione del secondo e viceversa, ma solo se le implementazioni utilizzano lo stesso script e lo stesso documento di test.
- Se esegui un deployment di test, potrebbe esserti richiesta l'autorizzazione se non hai mai eseguito lo script prima. Tieni presente che l'autorizzazione di uno script durante il test autorizza lo script anche al di fuori del test.