Uno script è associato a un file di Fogli, Documenti, Presentazioni o Moduli Google se è stato creato da quel documento anziché come script autonomo. Il file a cui è collegato uno script associato è chiamato "container". In genere gli script associati si comportano come script autonomi, ad eccezione del fatto che non vengono visualizzati su Google Drive, non possono essere scollegati dal file a cui sono associati e ricevono alcuni privilegi speciali sul file principale.
Tieni presente che anche gli script possono essere associati a Google Sites, ma il loro deployment viene quasi sempre eseguito come app web. Anche gli script associati a Fogli, Documenti, Presentazioni o Moduli Google possono diventare app web, anche se questo è raro.
Crea uno script associato
Documenti, Fogli o Presentazioni Google
Per creare uno script vincolato in Documenti, Fogli o Presentazioni Google, apri un documento in Documenti, un foglio di lavoro in Fogli o una presentazione in Presentazioni e fai clic su Estensioni > Apps Script. Per riaprire lo script in futuro, esegui la stessa operazione o apri lo script dalla dashboard di Apps Script.
Moduli Google
Per creare uno script associato in Moduli Google, apri un modulo e fai clic su Altro > Editor di script. Per riaprire lo script in futuro, ripeti la stessa operazione o apri lo script dalla dashboard di Apps Script.
Metodi speciali
Gli script associati possono richiamare alcuni metodi che gli script autonomi non sono in grado di:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
egetActiveForm()
consentono agli script associati di fare riferimento al file principale senza fare riferimento all'ID del file.getUi
consente agli script associati di accedere all'interfaccia utente del file principale per aggiungere menu, finestre di dialogo e barre laterali personalizzati.- In Fogli Google,
getActiveSheet()
,getActiveRange()
egetActiveCell()
consentono allo script di determinare il foglio corrente, l'intervallo di celle selezionato o una singola cella selezionata dell'utente.setActiveSheet(sheet)
esetActiveRange(range)
consentono allo script di modificare queste selezioni. - In Documenti Google,
getCursor()
egetSelection()
consentono allo script di determinare la posizione del cursore dell'utente o del testo selezionato.setCursor(position)
esetSelection(range)
consentono allo script di modificare queste posizioni.
Per ulteriori informazioni, consulta la guida all'estensione di Fogli Google o la guida all'estensione di Documenti Google.
Menu, finestre di dialogo e barre laterali personalizzati
Gli script associati possono personalizzare Fogli, Documenti e Moduli Google aggiungendo menu personalizzati e finestre di dialogo o barre laterali. Tuttavia, tieni presente che uno script può interagire con l'interfaccia utente solo per l'istanza corrente di un file aperto. Ciò significa che uno script associato a un documento non può influire sull'interfaccia utente di un altro documento.
Componenti aggiuntivi
I componenti aggiuntivi vengono eseguiti all'interno di Gmail, Fogli, Documenti, Presentazioni e Moduli Google. Se hai sviluppato uno script vincolato o autonomo e vuoi condividerlo con tutti, Apps Script ti consente di publish lo script come componente aggiuntivo in modo che altri utenti possano installarlo dallo store dei componenti aggiuntivi.
Trigger
Gli script associati possono utilizzare semplici attivatori come la funzione speciale onOpen()
, che viene eseguita automaticamente ogni volta che un file viene aperto da un utente che dispone dell'accesso in modifica. Come tutti i tipi di script, anche questi possono
utilizzare attivatori installabili.
Funzioni personalizzate
Una funzione personalizzata è una funzione in uno script associato a Fogli Google che chiami direttamente da una cella utilizzando la sintassi =myFunctionName()
. Di conseguenza, le funzioni personalizzate sono simili alle centinaia di
funzioni integrate in Fogli
come AVERAGE
o
SUM
, tranne per il fatto che sei tu a definire
il comportamento della funzione personalizzata.
Accesso agli script associati
Solo gli utenti autorizzati a modificare un contenitore possono eseguire lo script associato. I collaboratori con accesso solo in visualizzazione non possono aprire l'editor di script anche se creano una copia del file contenitore, diventano proprietari della copia e possono visualizzare ed eseguire una copia dello script.
Per informazioni su come condividere il file del contenitore di uno script, consulta Condividere file da Google Drive.