Estendi Fogli Google con i componenti aggiuntivi

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

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

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

Cosa puoi fare

Ecco alcune cose che puoi fare con un componente aggiuntivo che espande Fogli Google:

I componenti aggiuntivi di Fogli vengono creati utilizzando Apps Script. Per scoprire di più su come accedere e gestire Fogli Google con Apps Script, consulta Estensione di Fogli Google.

Struttura del foglio

Un foglio di lavoro di Fogli Google è 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 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

Gli attivatori di Apps Script consentono a un progetto di script di eseguire una funzione specificata quando vengono soddisfatte determinate condizioni, ad esempio quando viene aperta un'area di lavoro o viene installato un componente aggiuntivo.

Per saperne di più su quali attivatori possono essere utilizzati con i componenti aggiuntivi di Fogli e quali limitazioni si applicano al loro utilizzo, consulta la sezione Attivatori dei componenti aggiuntivi.

Funzioni personalizzate

Fogli Google dispone di una serie di funzioni integrate come SUM e AVERAGE che possono essere richiamate da una cella di Fogli Google. 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 disponibili immediatamente. È possibile che un componente aggiuntivo sia costituito solo da definizioni di funzioni personalizzate. Le definizioni di funzioni personalizzate vengono principalmente condivise con altri pubblicando un componente aggiuntivo contenente le definizioni.

Creazione di funzioni personalizzate dei componenti aggiuntivi

Qualsiasi funzione definita in un progetto di script del 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 incorporata: in una cella di Fogli, inserisci = seguito dal nome della funzione e dagli eventuali parametri richiesti. Se non sono presenti errori, il risultato restituito dalla funzione viene inserito nella cella del foglio e, se necessario, nelle celle adiacenti.

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 richiedono alcune considerazioni speciali:

  • Quando assegni un nome alla funzione, cerca di creare un nome 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 informazioni di completamento automatico. Inoltre, ti consigliamo di fornire documentazione aggiuntiva delle funzioni personalizzate nel componente aggiuntivo stesso o in una pagina web di assistenza del componente aggiuntivo.
  • Le funzioni personalizzate che non vengono completate in meno di 30 secondi non riescono con un Internal error executing the custom function errore. Crea una buona esperienza utente limitando la quantità di elaborazione eseguita in una funzione personalizzata. Ottimizza la funzione ove possibile.
  • Le funzioni personalizzate non possono utilizzare i servizi di Apps Script che richiedono l'autorizzazione e non riescono con un errore You do not have permission to call X service se si tenta di farlo. Utilizza solo i servizi consentiti nella tua funzione personalizzata.
  • Ogni funzione personalizzata in un foglio comporta una chiamata separata ai server di Apps Script. Se un utente tenta di utilizzare funzioni personalizzate in troppe celle, le funzioni potrebbero essere eseguite lentamente. Per attenuare 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à tramite un elemento di menu, una finestra di dialogo o un'interazione con la barra laterale.

Macro di Fogli

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

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, questa non è disponibile per gli utenti di quel componente aggiuntivo.