Estensione di Fogli Google con componenti aggiuntivi

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

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

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

Cosa puoi fare

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

I componenti aggiuntivi di Fogli vengono creati con Apps Script. Per saperne di più su come accedere a Fogli Google e gestirli con Apps Script, vedi Estensione di Fogli Google.

Struttura del foglio

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

Il servizio Fogli di lavoro di Apps Script fornisce diversi corsi 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 sono soddisfatte determinate condizioni, ad esempio quando viene aperto un foglio di lavoro o quando è installato un componente aggiuntivo.

Consulta la sezione sugli attivatori dei componenti aggiuntivi per ulteriori informazioni su quali attivatori possono essere utilizzati con i componenti aggiuntivi di Fogli e su quali limitazioni si applicano al loro utilizzo.

Funzioni personalizzate

Fogli Google ha una serie di funzioni incorporate, come SUM e AVERAGE, che possono essere richiamate dall'interno di una cella di Fogli Google. I componenti aggiuntivi di Fogli possono definire ulteriori funzioni personalizzate per integrarle. Quando un utente installa il componente aggiuntivo, qualsiasi funzione personalizzata definita inclusa nel componente aggiuntivo diventa subito disponibile. Un componente aggiuntivo può essere costituito solo da definizioni di funzioni personalizzate. Le definizioni delle funzioni personalizzate vengono condivise principalmente con altri tramite la pubblicazione di un componente aggiuntivo contenente le definizioni.

Creazione di funzioni personalizzate aggiuntive

Qualsiasi funzione definita in un progetto di script per componenti aggiuntivi 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 di Foglio, inserisci = seguito dal nome della funzione ed eventuali parametri richiesti. Se non ci sono errori, il risultato restituito dalla funzione viene inserito nella cella Foglio, con conseguente overflow delle celle vicine, se necessario.

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

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

  • Quando assegni un nome alla funzione, prova a 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 quali funzioni personalizzate fornisce. Assicurati di fornire commenti JSDoc precisi per le funzioni personalizzate in modo che Apps Script possa presentare all'utente informazioni di completamento automatico. Inoltre, valuta la possibilità di fornire ulteriore documentazione sulle funzioni personalizzate nel componente aggiuntivo stesso o in una pagina web di supporto per il componente aggiuntivo.
  • Le funzioni personalizzate che non vengono completate in meno di 30 secondi non riescono e viene restituito 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, se tenta di farlo, non riescono e generano un errore You do not have permission to call X service. Utilizza solo i servizi consentiti nella funzione personalizzata.
  • Ogni funzione personalizzata in un foglio genera una chiamata separata ai server Apps Script. Se un utente tenta di utilizzare le funzioni personalizzate in troppe celle, le funzioni potrebbero essere eseguite lentamente. Per mitigare questo problema, mantieni le tue funzioni personalizzate il più semplici possibile. Se hai bisogno che la funzione esegua un'elaborazione complessa o estesa, non utilizzare una funzione personalizzata: fornisci invece una voce di menu, una finestra di dialogo o un'interazione nella barra laterale.

Macro di Fogli

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

Sfortunatamente, le macro di Fogli non possono essere distribuite con i componenti aggiuntivi. Se includi la definizione di una macro nel file manifest di un componente aggiuntivo, quest'ultima non sarà disponibile per gli utenti del componente aggiuntivo.