Afegiu una funció personalitzada a Fulls de càlcul de Google: 5 passos

2024 Autora: John Day | [email protected]. Última modificació: 2024-01-30 08:11

Estic segur que en algun moment de la vostra vida va haver d’utilitzar programes de fulls de càlcul com Microsoft Excel o Google Sheets.

Són relativament senzills i senzills d’utilitzar, però també són molt potents i fàcilment extensibles.

Avui examinarem Fulls de càlcul de Google i la seva capacitat per afegir codi i funcions personalitzades per poder ampliar-lo.

Pas 1: Què són les funcions?

Una funció és un fragment de codi que manipula les dades del full de càlcul per calcular automàticament un valor nou. Un exemple molt comú d'aquesta funció és SUM, que calcula la suma d'una columna o grup de cel·les.

Tot el programari de fulls de càlcul admet moltes d’aquestes funcions que ja estan incorporades, però també admeten la possibilitat d’ampliar-les i escriure les nostres.

Pas 2: Com escriure una funció personalitzada?

Per escriure una funció personalitzada a Fulls de càlcul de Google, en fem servir una funció anomenada Apps Script, que és una plataforma de desenvolupament d’aplicacions ràpida on podem escriure codi en JavaScript directament al navegador que s’executarà al nostre full de càlcul.

Per començar a escriure podem anar a Eines> Editor de scripts al menú superior i apareixerà l’editor de codi en línia.

En ell, en obrir-se per primera vegada, tindrem un fitxer anomenat Code.gs juntament amb una funció d’inici en blanc, anomenada myFunction.

Com a exemple inicial, canviarem el nom d'aquesta funció a DOBLE i afegirem un paràmetre d'entrada a la seva declaració. Dins del cos de la funció, hem de retornar un valor i, per a aquest exemple, només multiplicarem el valor d’entrada per 2.

Ara podem desar l'script i, si tornem al full de càlcul i hi afegim algunes dades, ara podem fer referència a aquesta funció en qualsevol cel·la i enviar la referència de cel·la de dades com a entrada del valor.

En executar aquesta funció, Fulls de càlcul de Google mostrarà en breu un missatge de càrrega a la cel·la, però després mostrarà el valor retornat de la funció.

Pas 3: limitacions de funció i autocompletar

Aquestes funcions poden fer el que vulguem, però hi ha algunes limitacions que hem de seguir com:

Els noms han de ser únics i diferents dels que utilitzen les funcions integrades. El nom no ha d’acabar amb un _ i els noms de funcions s’escriuen normalment amb majúscules, tot i que no és necessari.

Cada funció pot retornar un valor únic com en el nostre exemple, però també pot retornar una matriu de valors. Aquesta matriu s’ampliarà a les cel·les adjacents sempre que estiguin buides. Si no són un error es mostrarà.

La funció que hem escrit es pot utilitzar, però per a qualsevol altra persona que pugui venir a editar el document serà desconeguda i l'usuari haurà de saber que existeix per utilitzar-lo. Ho podem solucionar afegint la funció a la llista d’autocompletar, igual que totes les funcions incorporades.

Per fer-ho, hem d’afegir una etiqueta JsDoc @customfunction davant de la funció com a comentari on en aquest comentari podem escriure una breu explicació del que fa la nostra funció.

Ara, amb el comentari afegit, quan comencem a escriure el nom de la funció, la funció l'oferirà l'autocompletar, juntament amb la descripció de la funció.

Pas 4: trucar a serveis externs

El gran poder que tenen aquestes funcions prové de la possibilitat de trucar i interactuar amb altres eines i serveis de Google com ara Translate, Maps, connectar-se a una base de dades externa, treballar amb XML i altres. De llarg, la característica més poderosa per a mi és la possibilitat de fer una sol·licitud HTTP externa a qualsevol API o pàgina web i obtenir-ne dades mitjançant el servei UrlFetch.

Per demostrar-ho, enganxaré una funció que convertirà els dòlars americans en franc suís, però no assumirà el tipus de canvi, sinó que la recuperarà d’una API externa.

La funció també utilitza el servei de memòria cau integrat, on no cridarà a l'API per a tots els càlculs, sinó que el cridarà una vegada per al primer càlcul i després emmagatzemarà aquest valor a la memòria cau.

A continuació, es farà qualsevol altre càlcul amb el valor emmagatzemat a la memòria cau, de manera que el rendiment dels mateixos es millorarà considerablement i no afectarem el servidor sovint, ja que les tarifes no canvien tan ràpidament.

Com que l’API retorna JSON, un cop rebem la resposta del servidor, hem d’analitzar el JSON en un objecte i, a continuació, podem obtenir la taxa, multiplicar-la amb el valor d’entrada i retornar el nou valor calculat a la cel·la.

Pas 5: passos següents

Si us sembla interessant i voleu obtenir més informació, us deixo els enllaços següents per obtenir recursos addicionals.

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

developers.google.com/apps-script

Si us ha agradat Instructable, assegureu-vos de subscriure-us al meu canal de YouTube si encara no ho heu fet i consulteu alguns dels meus altres Instructables.

Ànims i gràcies per llegir.