Uno script è associato a un file di Fogli, Documenti, Presentazioni o Moduli Google, se è creato da quel documento anziché come script autonomo. Il file a cui è collegato uno script associato è chiamato "container". Gli script associati si comportano generalmente come script autonomi, ad eccezione del fatto che non vengono visualizzati su Google Drive, non possono essere scollegati dal file a cui sono associati, disponendo di alcuni privilegi speciali sul file principale.
Tieni presente che anche gli script possono essere associati a Google Sites, ma sono vengono quasi sempre implementate come app web. Script associati a Fogli, Documenti, Presentazioni o Moduli Google possono diventare anch'essi applicazioni web, ma è 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 in futuro, ripeti la stessa operazione o apri lo script Dashboard di Apps Script.
Moduli Google
Per creare uno script associato in Moduli Google, apri un modulo e fai clic su Altro > Script dell'editor video. Per riaprire lo script nella fai la stessa cosa 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()consentire agli script associati di fare riferimento al file principale senza fare riferimento al l'ID del file.getUiconsente gli script associati accedono all'interfaccia utente per consentire al file principale di aggiungere menu, finestre di dialogo e barre laterali personalizzati.- In Fogli Google,
getActiveSheet(),getActiveRange(), egetActiveCell()consente allo script di determinare il foglio corrente dell'utente, l'intervallo di celle selezionato o singola cella selezionata.setActiveSheet(sheet)esetActiveRange(range)lascia che lo script modifichi queste selezioni. - In Documenti Google,
getActiveTab(),getCursor()egetSelection()consente allo script di determinare la scheda corrente dell'utente, la posizione cursore o testo selezionato.setActiveTab(tabId),setCursor(position)esetSelection(range)lascia che lo script modifichi queste selezioni.
Per ulteriori informazioni, consulta 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. Ricorda: tuttavia, che uno script può interagire solo con l'interfaccia utente per l'istanza corrente di un file aperto. Vale a dire, uno script legato a un documento non possono influire sull'interfaccia utente di un altro documento.
Componenti aggiuntivi
I componenti aggiuntivi vengono eseguiti all'interno di Gmail, Fogli Google, Documenti Presentazioni e Moduli. Se hai sviluppato un limite autonomo e vuoi condividerlo con tutti, Apps Script ti consente pubblicare lo script come per consentire agli altri utenti di 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, è possibile
utilizzare anche gli attivatori installabili.
Funzioni personalizzate
Una funzione personalizzata è una funzione in una
associato a Fogli Google che chiami direttamente da una cella utilizzando
sintassi =myFunctionName(). Le funzioni personalizzate sono quindi simili alle centinaia
funzioni integrate in Fogli
come AVERAGE o
SUM, ad eccezione del fatto che definisci
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 lo script dell'editor, anche se creano una copia del file container, proprietario della copia e può visualizzare ed eseguire una copia dello script.
Per informazioni su come condividere il file del container di uno script, consulta Condividere file da Google Drive.