I componenti aggiuntivi devono essere testati accuratamente prima della pubblicazione per verificare che si comportino come previsto. Apps Script ti consente di testare i componenti aggiuntivi di Editor in fase di sviluppo su specifici file di Fogli, Moduli o Presentazioni Google. Può essere utilizzato per:
- Verifica che un componente aggiuntivo scritto in uno script autonomo funzioni come previsto quando applicato a un foglio, un documento, una presentazione o un modulo.
- Verifica che il flusso di installazione dei componenti aggiuntivi funzioni come previsto, in particolare per diversi stati del ciclo di vita di autorizzazione iniziali (installato, abilitato o entrambi).
- Verifica che il componente aggiuntivo funzioni come previsto quando agisce su un particolare documento e i suoi contenuti.
- Testa e confronta le versioni attuali e precedenti del componente aggiuntivo.
Crea un deployment di test
Un deployment di test è la combinazione di un componente aggiuntivo e di un documento di test. Dopo aver sviluppato una versione dello script e vuoi testarla come componente aggiuntivo, procedi nel seguente modo:
- Se non ne hai già uno, crea un foglio di lavoro, un documento, una presentazione o un modulo con cui testare il componente aggiuntivo.
- Apri il progetto dello script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa i deployment.
- Accanto a Seleziona tipo, fai clic su Abilita tipi di deployment e seleziona Componente aggiuntivo Editor.
- Fai clic su Crea nuovo test o Aggiungi test.
- Scegli una versione del codice o seleziona Codice più recente.
- Nella sezione Configurazione, seleziona lo stato di autorizzazione iniziale per il test.
- 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.
- Fai clic su Save test (Salva test).
Tutti i deployment di test salvati vengono visualizzati nella finestra di dialogo Deployment di test. In questo modo puoi rivedere lo stesso deployment di test in un secondo momento.
Esegui un deployment di prova
Se hai uno o più deployment di test salvati, puoi eseguirne uno seguendo questi passaggi:
- Apri il progetto dello script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa i deployment.
- In Test salvati, seleziona il pulsante di opzione accanto al deployment di 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 relativo menu e gli elementi UI.
Dettagli del test
Quando testi i componenti aggiuntivi di Editor, devi tenere presente una serie di aspetti:
- I trigger 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 testare con il codice più recente, puoi visualizzare le modifiche salvate allo script del componente aggiuntivo aggiornando il documento di test.
- Il documento di test include un URL che puoi condividere con gli editor del documento di test originale. In questo modo, puoi collaborare più facilmente con gli altri durante i test e lo sviluppo.
- Se il componente aggiuntivo utilizza il servizio Proprietà, le proprietà rimangono disponibili e rimangono disponibili alla successiva esecuzione del deployment di prova.
- Inoltre, tutti i deployment di test che utilizzano la stessa combinazione di componente aggiuntivo e documento di test hanno accesso alle stesse informazioni sulla proprietà. Ad esempio, se crei due deployment di test, le proprietà salvate durante l'esecuzione del primo sono disponibili durante l'esecuzione del secondo e viceversa, ma solo se i deployment utilizzano lo stesso script e documento di test.
- Se esegui un deployment di prova, ti potrebbe essere chiesta l'autorizzazione se non hai mai eseguito lo script prima d'ora. Tieni presente che l'autorizzazione di uno script durante il test autorizza anche lo script al di fuori del test.