I componenti aggiuntivi devono essere testati a fondo prima della pubblicazione per garantire che funzionino 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. Questa funzionalità può essere utilizzata per:
- Verifica che un componente aggiuntivo scritto in uno script autonomo funzioni come previsto quando viene applicato a un foglio, a un documento, a una presentazione o a un modulo.
- Verifica che il flusso di installazione dei componenti aggiuntivi funzioni come previsto, in particolare per stati del ciclo di vita di autorizzazione iniziali diversi (installato, abilitato o entrambi).
- Verifica che il componente aggiuntivo funzioni come previsto quando si agisce su un determinato documento e sui suoi contenuti.
- Testa e confronta la versione attuale e quella precedente del componente aggiuntivo.
Crea un deployment di prova
Un deployment di test è la combinazione di un componente aggiuntivo e di un documento di test. Dopo aver sviluppato una versione dello script e desideri 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 di script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa il deployment.
- Accanto a Seleziona tipo, fai clic su Abilita tipi di deployment e seleziona Componente aggiuntivo dell'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 Salva test.
Tutti i deployment di test salvati vengono visualizzati nella finestra di dialogo Testa i deployment. 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 di script contenente il componente aggiuntivo.
- Fai clic su Esegui il deployment > Testa il 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 prova. Per verificare che il componente aggiuntivo funzioni come previsto, interagisci con i relativi elementi di menu e UI.
Dettagli del test
Quando testi i componenti aggiuntivi dell'editor in questo modo, tieni presente una serie di aspetti:
- 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 testare 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 gli altri durante test e sviluppo.
- Se il componente aggiuntivo utilizza il servizio delle proprietà, le proprietà rimangono invariate e rimangono disponibili alla successiva esecuzione di test del deployment.
- Inoltre, qualsiasi deployment di test che utilizza la stessa combinazione di componenti aggiuntivi e documenti di test ha 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, è possibile che ti venga richiesta l'autorizzazione se non hai mai eseguito lo script in precedenza. Tieni presente che l'autorizzazione di uno script durante il test autorizza anche lo script al di fuori dei test.