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 gli script autonomi, tranne per il fatto che non vengono visualizzati in Google Drive, non possono essere scollegati dal file a cui sono associati e ottengono alcuni privilegi speciali sul file principale.
Gli script possono anche essere associati a Google Sites, ma questi script vengono quasi sempre implementati come app web. Gli script associati a Fogli, Documenti, Presentazioni o Moduli possono anche diventare app web, anche se è raro.
Gli script associati sono componenti aggiuntivi di Google Workspace non pubblicati che funzionano solo per il file a cui sono associati.
Creare uno script associato
Puoi creare script associati in Documenti, Fogli, Presentazioni e Moduli.
Documenti, Fogli o Presentazioni
Per creare uno script associato in Documenti, Fogli o Presentazioni, 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, fai la stessa cosa o apri lo script dalla dashboard di Apps Script.
Moduli
Per creare uno script associato in Moduli, apri un modulo e fai clic su Altro > Editor di script. Per riaprire lo script in futuro, fai la stessa cosa o apri lo script dalla dashboard di Apps Script.
Lo strumento clasp non può creare script associati, ma può clonarli e modificarli.
Metodi speciali
Gli script associati possono chiamare alcuni metodi che gli script autonomi non possono:
getActiveSpreadsheet,getActiveDocument,getActivePresentation, egetActiveFormconsentono agli script associati di fare riferimento al file principale senza fare riferimento all' ID del file.getUiconsente agli script associati di accedere all'interfaccia utente del file principale per aggiungere menu, finestre di dialogo e barre laterali personalizzati.- In Fogli,
getActiveSheet,getActiveRangeegetActiveCellconsentono allo script di determinare il foglio corrente dell'utente, l'intervallo di celle selezionato o la singola cella selezionata.setActiveSheetesetActiveRangeconsentono allo script di modificare queste selezioni. - In Documenti,
getActiveTab,getCursoregetSelectionconsentono allo script di determinare la scheda corrente dell'utente, la posizione del cursore dell'utente o il testo selezionato.setActiveTab,setCursoresetSelectionconsentono allo script di modificare queste selezioni.
Per ulteriori informazioni, consulta la guida all'estensione di Fogli o la guida all'estensione di Documenti.
Questi metodi sono disponibili solo per gli script associati eseguiti dall'editor di script, dalle voci di menu, dalle finestre di dialogo, dalle barre laterali o dai trigger. Quando uno script associato viene eseguito come app web o utilizzando l'API Google Apps Script, questi metodi non sono disponibili.
Menu, finestre di dialogo e barre laterali personalizzati
Gli script associati possono personalizzare Fogli, Documenti e Moduli aggiungendo menu personalizzati e finestre di dialogo o barre laterali. Uno script può interagire solo con l'interfaccia utente dell'istanza corrente di un file aperto. Uno script associato a un documento non può influire sull'interfaccia utente di un altro documento.
Trigger
Gli script associati possono utilizzare trigger semplici come la
funzione onOpen speciale, che viene eseguita automaticamente ogni volta che un utente con accesso in modifica apre un file. Come tutti i tipi di script, possono anche utilizzare
trigger installabili.
Funzioni personalizzate
Una funzione personalizzata è una funzione in uno
script associato a Fogli che chiami direttamente da una cella utilizzando
la sintassi =myFunctionName(). Le funzioni personalizzate sono simili alle centinaia di
funzioni integrate in
Fogli, come
AVERAGE o
SUM, tranne per il fatto che definisci
il comportamento della funzione personalizzata.
Accesso agli script associati
Solo gli utenti che hanno l'autorizzazione a modificare un container possono eseguire lo script associato. I collaboratori che hanno solo accesso in visualizzazione non possono aprire l'editor di script. Se creano una copia del file container, ne diventano proprietari e possono visualizzare ed eseguire una copia dello script.
Per scoprire come condividere il file container di uno script, consulta Condividere file da Drive.
Tutti gli script associati al container utilizzano lo stesso elenco per gli accessi di proprietario, visualizzatore ed editor definito per il file container. Il proprietario del container diventa proprietario di un nuovo progetto di script, indipendentemente da chi lo ha creato.