Aggiungi una funzione personalizzata in Fogli Google: 5 passaggi

2024 Autore: John Day | [email protected]. Ultima modifica: 2024-01-30 10:00

Sono sicuro che a un certo punto della tua vita hai dovuto usare un software per fogli di calcolo come Microsoft Excel o Fogli Google.

Sono relativamente semplici e diretti da usare, ma anche molto potenti e facilmente estensibili.

Oggi esamineremo Fogli Google e la sua capacità di aggiungere codice e funzioni personalizzate in modo da poterlo estendere.

Passaggio 1: cosa sono le funzioni?

Una funzione è un pezzo di codice che manipola i dati dal foglio di calcolo per calcolare automaticamente un nuovo valore per noi. Un esempio molto comune di tale funzione è SUM, che calcola la somma di una colonna o di un gruppo di celle.

Tutti i software per fogli di calcolo supportano molte di queste funzioni pre-integrate, ma supportano anche la possibilità di estenderle e scriverne di proprie.

Passaggio 2: come scrivere una funzione personalizzata?

Per scrivere una funzione personalizzata in Fogli Google utilizziamo una sua funzionalità chiamata Apps Script che è una piattaforma di sviluppo rapido di applicazioni in cui possiamo scrivere codice in JavaScript direttamente nel browser che verrà poi eseguito nel nostro foglio di calcolo.

Per iniziare a scrivere possiamo andare su Strumenti > Editor di script nel menu in alto e questo farà apparire l'editor di codice online.

In esso, alla prima apertura, avremo un file chiamato Code.gs insieme a una funzione iniziale vuota, denominata myFunction.

Come esempio iniziale, rinomineremo questa funzione in DOUBLE e aggiungeremo un parametro di input nella sua dichiarazione. All'interno del corpo della funzione, dobbiamo restituire un valore e per questo esempio, moltiplicheremo semplicemente il valore di input per 2.

Ora possiamo salvare lo script e se torniamo al foglio di calcolo e aggiungiamo alcuni dati, possiamo ora fare riferimento a questa funzione in qualsiasi cella e inviare il riferimento alla cella di dati come input per il valore.

Quando si esegue questa funzione, Fogli Google visualizzerà brevemente un messaggio di caricamento nella cella, ma visualizzerà quindi il valore restituito dalla funzione.

Passaggio 3: limitazioni delle funzioni e completamento automatico

Queste funzioni possono fare quello che vogliamo, ma ci sono alcune limitazioni che dobbiamo seguire come:

I nomi devono essere univoci e diversi da quelli utilizzati dalle funzioni integrate. Il nome non deve terminare con un _ ei nomi delle funzioni sono generalmente scritti con lettere maiuscole, sebbene ciò non sia necessario.

Ogni funzione può restituire un singolo valore come nel nostro esempio ma può anche restituire un array di valori. Questa matrice verrà quindi espansa in celle adiacenti finché sono vuote. Se non lo sono verrà mostrato un errore.

La funzione che abbiamo scritto è utilizzabile ma per chiunque altro possa venire a modificare il documento sarà sconosciuta e l'utente dovrà sapere che esiste per usarla. Possiamo risolvere questo problema aggiungendo la funzione all'elenco di completamento automatico, come tutte le funzioni integrate.

Per fare ciò, dobbiamo aggiungere un tag JsDoc @customfunction davanti alla funzione come commento dove in questo commento possiamo scrivere una breve spiegazione di cosa fa la nostra funzione.

Ora con il commento aggiunto, quando iniziamo a scrivere il nome della funzione, la funzione verrà offerta dal completamento automatico, insieme alla descrizione della funzione.

Passaggio 4: chiamata a servizi esterni

Il grande potere che hanno queste funzioni, deriva dalla possibilità di chiamare e interagire con altri strumenti e servizi di Google come Translate, Maps, connettersi a un database esterno, lavorare con XML e altri. Di gran lunga, la funzionalità più potente per me è la possibilità di effettuare una richiesta HTTP esterna a qualsiasi API o pagina Web e ottenere dati da essa utilizzando il servizio UrlFetch.

Per dimostrarlo, incollerò una funzione che convertirà i dollari statunitensi in franchi svizzeri ma non assumerà il tasso di cambio, ma invece lo recupererà da un'API esterna.

La funzione utilizza anche il servizio cache integrato in cui non chiamerà l'API per tutti i calcoli ma la chiamerà una volta per il primo calcolo e quindi memorizzerà quel valore nella cache.

Ogni altro calcolo verrà quindi effettuato con il valore memorizzato nella cache in modo che le prestazioni di questi vengano notevolmente migliorate e non colpiremo il server spesso poiché le tariffe non cambiano così rapidamente.

Poiché l'API restituisce JSON, una volta ottenuta la risposta dal server, dobbiamo analizzare il JSON in un oggetto e possiamo quindi ottenere la frequenza, moltiplicarla per il valore di input e restituire il nuovo valore calcolato alla cella.

Passaggio 5: passaggi successivi

Se lo trovi interessante e vuoi saperne di più, lascerò qui sotto i link a risorse aggiuntive.

developers.google.com/apps-script/guides/s…

developers.google.com/apps-script

Se ti è piaciuto Instructable, assicurati di iscriverti al mio canale YouTube se non l'hai già fatto e dai un'occhiata ad alcuni dei miei altri Instructables.

Saluti e grazie per la lettura.