Testare un componente aggiuntivo di Editor

I componenti aggiuntivi devono essere testati accuratamente prima della pubblicazione per garantire che funzionino come previsto. Apps Script consente di testare i componenti aggiuntivi dell'editor in fase di sviluppo per file di Fogli, Moduli o Presentazioni specifici. 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 i diversi stati di ciclo di vita dell'autorizzazione iniziali (installati, attivati o entrambi).
  • Verifica che il componente aggiuntivo funzioni come previsto quando agisci su un determinato documento e sui relativi contenuti.
  • Testa e confronta le versioni attuali e precedenti del componente aggiuntivo.

Crea un deployment di prova

Un deployment di test è la combinazione di un componente aggiuntivo e un documento di test. Dopo aver sviluppato una versione dello script e che vuoi 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 con cui 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 il tipo, fai clic su Abilita i tipi di deployment e seleziona Componente aggiuntivo Editor.
  5. Fai clic su Crea nuovo test o Aggiungi test.
  6. Scegli una versione del codice o seleziona Più recente codice.
  7. Nella sezione Configurazione, 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. Ciò ti consente di 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:

  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 di test salvato che vuoi eseguire e fai clic su Esegui.

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

Dettagli del test

Durante il test dei componenti aggiuntivi di Editor è necessario tenere presente quanto segue:

  • Gli attivabili installabili non sono supportati durante i test. La funzionalità che dipende dagli attivatori installabili non è verificabile.
  • Durante l'esecuzione di un deployment di test impostato per eseguire il test con l'ultimo codice, 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 gli altri durante i test e lo sviluppo.
  • Se il componente aggiuntivo utilizza il servizio Proprietà, le proprietà rimangono valide e rimangono disponibili alla successiva esecuzione del deployment di test.
  • 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 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 richiesta l'autorizzazione se non hai mai eseguito lo script. Tieni presente che l'autorizzazione di uno script durante il test autorizza anche lo script al di fuori del test.