Estendi Fogli Google con i componenti aggiuntivi

Fogli Google è una piattaforma di fogli di lavoro con collaborazione in tempo reale e strumenti potenti 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 dati di Fogli con altre applicazioni Google Workspace (come Presentazioni Google).

Puoi vedere i componenti aggiuntivi di Fogli creati da altri utenti 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 utilizzando Apps Script. Per scoprire di più su come accedere e gestire Fogli Google con Apps Script, vedi 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 inserire testo, numeri, link possono essere archiviati. Un gruppo di una o più celle adiacenti è chiamato intervallo.

Il servizio fogli di lavoro di Apps Script offre diversi corsi per rappresentare le strutture organizzative in Fogli (ad esempio Sheet e Range). Puoi utilizzare questi per leggere e modificare i dati e il comportamento di Fogli.

Trigger

Gli attivatori di Apps Script consentono a un progetto di script esegue una funzione specificata quando sono soddisfatte determinate condizioni, ad esempio quando quando viene aperto un foglio di lavoro o quando è installato un componente aggiuntivo.

Per ulteriori informazioni, consulta la sezione sugli attivatori dei componenti aggiuntivi. quali attivatori possono essere utilizzati con i componenti aggiuntivi di Fogli e quali restrizioni si applicano al loro utilizzo.

Funzioni personalizzate

Fogli Google offre diverse funzioni integrate come SUM e AVERAGE che possono essere richiamati dall'interno di una cella di Fogli Google. I componenti aggiuntivi di Fogli possono definire funzioni personalizzate per integrare queste funzioni integrate. Quando un utente installa il componente aggiuntivo, eventuali funzioni personalizzate definite incluse nel componente aggiuntivo diventano immediatamente disponibili. Un componente aggiuntivo può essere costituito solo le definizioni di funzioni personalizzate. Le definizioni delle funzioni personalizzate sono principalmente condivisi con altri utenti pubblicando un componente aggiuntivo contenente le definizioni.

Creazione di funzioni personalizzate aggiuntive

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

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

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

  • Quando assegni un nome alla funzione, prova a creare un nome univoco, forse correlato il nome del tuo componente aggiuntivo. Se due o più componenti aggiuntivi installati definiscono funzioni con lo stesso nome, gli utenti possono utilizzarne una sola.
  • Il componente aggiuntivo deve comunicare chiaramente quali funzioni personalizzate offre. Assicurati di fornire commenti JSDoc precisi per le tue funzioni personalizzate in modo che Apps Script può presentare informazioni di completamento automatico all'utente. Inoltre, ti consigliamo di fornire ulteriore documentazione funzioni personalizzate nel componente aggiuntivo stesso o in una pagina web di supporto 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. Creare un utente efficace limitando la quantità di elaborazione eseguita in una funzione personalizzata. Ottimizza la funzione. laddove possibile.
  • Le funzioni personalizzate non possono utilizzare servizi Apps Script che richiedono l'autorizzazione, e non riusciranno con un errore You do not have permission to call X service se di un nuovo tentativo di accesso. Utilizza solo servizi consentiti nella funzione personalizzata.
  • Ogni funzione personalizzata in un foglio genera una chiamata separata ad Apps Script server web. Se un utente cerca di utilizzare funzioni personalizzate in troppe celle, potrebbero essere eseguite lentamente. Per mitigare questo problema, mantieni le funzioni personalizzate il più semplice possibile. Se hai bisogno della funzione per eseguire attività complesse o estese l'elaborazione dei dati, non utilizzare una funzione personalizzata, fornisci questa funzionalità tramite una voce di menu, una finestra di dialogo o un'interazione con la barra laterale.

Macro di Fogli

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

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