Script associati ai container

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 è allegato uno script associato è chiamato "container". Gli script associati in genere si comportano come script autonomi, tranne per il fatto che non vengono visualizzati su Google Drive, non possono essere scollegati dal file a cui sono associati e ottengono alcuni privilegi speciali sul file principale.

Tieni presente che gli script possono essere associati anche a Google Sites, ma vengono quasi sempre distribuiti come app web. Anche gli script associati a Fogli, Documenti, Presentazioni o Moduli Google possono diventare app web, anche se questo non è comune.

Nota: gli script associati sono di fatto componenti aggiuntivi non pubblicati che funzionano solo per il file a cui sono associati.

Crea uno script associato

Documenti, Fogli o Presentazioni Google

Per creare uno script associato 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, ripeti l'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 aprilo 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 chiamare alcuni metodi che gli script autonomi non possono:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() e getActiveForm() 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() e getActiveCell() consenti allo script di determinare il foglio corrente dell'utente, l'intervallo di celle selezionato o la singola cella selezionata. setActiveSheet(sheet) e setActiveRange(range) consentono allo script di modificare queste selezioni.
• In Documenti Google, getCursor() e getSelection() consentono allo script di determinare la posizione del cursore o del testo selezionato dell'utente. setCursor(position) e setSelection(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.

Nota: 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 dagli attivatori. Quando uno script associato viene eseguito come app web o tramite l'API Apps Script, questi metodi non sono disponibili.

Barre laterali, finestre di dialogo e menu 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.

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

Componenti aggiuntivi

I componenti aggiuntivi sono eseguiti all'interno di Gmail, Fogli Google, Documenti, Presentazioni e Moduli Google. Se hai sviluppato uno script associato o autonomo e vuoi condividerlo con tutti, Apps Script ti consente di publish come componente aggiuntivo in modo che altri utenti possano installarlo dallo store dei componenti aggiuntivi.

Trigger

Gli script associati possono utilizzare attivatori semplici come la funzione speciale onOpen(), che viene eseguita automaticamente ogni volta che un utente viene aperto da un utente con 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(). Pertanto, le funzioni personalizzate sono simili alle centinaia di funzioni integrate in Fogli, come AVERAGE o SUM, con la differenza che sei tu a definire il comportamento della funzione personalizzata.

Accesso agli script associati

Solo gli utenti autorizzati a modificare un container possono eseguire lo script associato. I collaboratori che hanno solo accesso in visualizzazione non possono aprire l'editor di script, ma se creano una copia del file del container ne diventano il proprietario 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.

Tutti gli script associati al container utilizzano lo stesso elenco per gli accessi di proprietario, visualizzatore ed editor definito per il file del container. Il proprietario del container acquisisce la proprietà di un nuovo progetto di script indipendentemente da chi lo ha creato.