Script associati ai container

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.

Nota: la pubblicazione degli script associati è generalmente annullata componenti aggiuntivi che funzionano solo per al file a cui sono associati.

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.

Nota: lo strumento clasp non può creare script associati, ma può clonarli e modificarli.

Metodi speciali

Gli script associati possono richiamare alcuni metodi che gli script autonomi non sono in grado di:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation(), e getActiveForm() consentire agli script associati di fare riferimento al file principale senza fare riferimento al l'ID del file.
• getUi consente 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(), e getActiveCell() consente allo script di determinare il foglio corrente dell'utente, l'intervallo di celle selezionato o singola cella selezionata. setActiveSheet(sheet) e setActiveRange(range) lascia che lo script modifichi queste selezioni.
• In Documenti Google, getCursor() e getSelection() consente allo script di determinare la posizione del cursore o del testo selezionato dell'utente. setCursor(position) e setSelection(range) lascia che lo script modifichi queste posizioni.

Per ulteriori informazioni, consulta guida all'estensione di Fogli Google o la guida all'estensione di Documenti Google.

Nota: questi metodi sono disponibili solo per gli script associati eseguiti da l'editor di script, le voci di menu, le finestre di dialogo, le barre laterali o gli attivatori. Quando un limite viene eseguito come app web o tramite API Apps Script, questi metodi non sono disponibile.

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.

I componenti aggiuntivi possono anche aggiungere menu, finestre di dialogo e barre laterali personalizzati. È consigliabile sviluppare componenti aggiuntivi utilizzando: script autonomi.

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.

Tutti gli script associati a un container utilizzano lo stesso proprietario, visualizzatore per gli accessi all'editor definito per il file del contenitore. Il proprietario del container prende proprietà di un nuovo progetto di script, indipendentemente da chi lo ha creato.