Estendere Fogli Google con i componenti aggiuntivi

Fogli Google è una soluzione di fogli di lavoro basata sul cloud con strumenti potenti e di collaborazione in tempo reale per visualizzare, elaborare e comunicare i dati.

Puoi estendere Fogli con componenti aggiuntivi che creano miglioramenti del flusso di lavoro personalizzati, stabiliscono la connettività ai sistemi di terze parti e integrano i dati di Fogli con altre applicazioni Google Workspace (come Presentazioni Google).

Puoi visualizzare i componenti aggiuntivi di Fogli creati da altri utenti su Google Workspace Marketplace.

Cosa puoi fare

Ecco alcune delle cose che puoi fare con i componenti aggiuntivi che estendono Fogli:

I componenti aggiuntivi di Fogli sono creati utilizzando Apps Script. Per saperne di più su come accedere a Fogli e gestirlo con Apps Script, vedi Estendere Fogli.

Struttura del foglio

Un foglio di lavoro di Fogli è costituito da uno o più fogli. Ogni foglio è essenzialmente una griglia 2D di celle in cui è possibile memorizzare testo, numeri, link o altri valori. Un gruppo di una o più celle adiacenti è chiamato intervallo.

Il servizio Fogli di lavoro Apps Script fornisce diverse classi per rappresentare le strutture organizzative in Fogli (ad esempio Sheet e Range). Puoi utilizzare queste classi per leggere e modificare i dati e il comportamento di Fogli.

Trigger

I trigger di Apps Script consentono a un progetto di script di eseguire una funzione specifica quando vengono soddisfatte determinate condizioni, ad esempio quando viene aperto un foglio di lavoro o quando viene installato un componente aggiuntivo.

Per ulteriori informazioni sui trigger dei componenti aggiuntivi che possono essere utilizzati con i componenti aggiuntivi di Fogli e sulle restrizioni applicate al loro utilizzo, vedi Trigger dei componenti aggiuntivi.

Funzioni personalizzate

Fogli ha una serie di funzioni integrate come SUM e AVERAGE che possono essere richiamate da una cella di Fogli. I componenti aggiuntivi di Fogli possono definire funzioni personalizzate aggiuntive per integrare queste funzioni integrate. Quando un utente installa il componente aggiuntivo, tutte le funzioni personalizzate definite incluse nel componente aggiuntivo diventano immediatamente disponibili. È possibile che un componente aggiuntivo sia costituito solo da definizioni di funzioni personalizzate. Le definizioni delle funzioni personalizzate vengono condivise principalmente con altri utenti pubblicando un componente aggiuntivo contenente le definizioni.

Creare funzioni personalizzate per i componenti aggiuntivi

Qualsiasi funzione definita in un progetto di script di un componente aggiuntivo può essere utilizzata come funzione personalizzata. Una volta implementata la funzione e installato il componente aggiuntivo, puoi chiamare la funzione personalizzata come qualsiasi altra funzione di Fogli integrata: in una cella del foglio, inserisci = seguito dal nome della funzione e da eventuali parametri obbligatori. Se non ci sono errori, il risultato restituito dalla funzione viene inserito nella cella di Fogli, con overflow nelle celle adiacenti, se necessario.

Quando crei funzioni personalizzate in un componente aggiuntivo, devi seguire le linee guida generali per le funzioni personalizzate:

Inoltre, le funzioni personalizzate definite nei componenti aggiuntivi presentano alcune considerazioni speciali:

  • Quando assegni un nome alla funzione, prova a crearne uno univoco, magari correlato al nome del componente aggiuntivo. Se due o più componenti aggiuntivi installati definiscono funzioni personalizzate con lo stesso nome, gli utenti possono utilizzarne solo una.
  • Il componente aggiuntivo deve comunicare chiaramente le funzioni personalizzate che fornisce. Assicurati di fornire commenti JSDoc accurati per le funzioni personalizzate in modo che Apps Script possa presentare all'utente le informazioni di completamento automatico. Inoltre, valuta la possibilità di fornire documentazione aggiuntiva delle funzioni personalizzate nel componente aggiuntivo stesso o in una pagina web di assistenza per i componenti aggiuntivi.
  • Le funzioni personalizzate che non vengono completate in meno di 30 secondi generano un errore Internal error executing the custom function. Crea una buona esperienza utente limitando la quantità di elaborazione eseguita in una funzione personalizzata. Ottimizza la funzione dove possibile.
  • Le funzioni personalizzate non possono utilizzare i servizi Apps Script che richiedono l'autorizzazione e generano un errore You do not have permission to call X service se viene tentato. Utilizza solo i servizi consentiti nella funzione personalizzata.
  • Ogni funzione personalizzata in Fogli genera una chiamata separata ai server Apps Script. Se un utente tenta di utilizzare funzioni personalizzate in troppe celle, le funzioni possono essere eseguite lentamente. Per risolvere questo problema, mantieni le funzioni personalizzate il più semplici possibile. Se hai bisogno che la funzione esegua un'elaborazione complessa o estesa, non utilizzare una funzione personalizzata, ma fornisci questa funzionalità utilizzando un elemento di menu, una finestra di dialogo o un'interazione della barra laterale.

Macro di Fogli

Le macro ti consentono di registrare le azioni eseguite in Fogli e ripeterle in un secondo momento con una scorciatoia da tastiera. Quando viene creata una macro in Fogli, viene aggiunta come una funzione macro in un progetto Apps Script associato a quel foglio. Per ulteriori informazioni sulle macro, vedi Macro di Fogli.

Purtroppo, le macro di Fogli non possono essere distribuite con i componenti aggiuntivi. Se includi una definizione di macro nel manifest di un componente aggiuntivo, non è disponibile per gli utenti di quel componente aggiuntivo.