Adăugați o funcție personalizată în Foi de calcul Google: 5 pași

2024 Autor: John Day | [email protected]. Modificat ultima dată: 2024-01-30 11:41

Sunt sigur că, la un moment dat din viața ta, a trebuit să folosești software pentru foi de calcul precum Microsoft Excel sau Foi de calcul Google.

Acestea sunt relativ simple și simple pentru a fi utilizate, dar și foarte puternice și ușor de extins.

Astăzi, vom analiza Foi de calcul Google și capacitatea acestuia de a adăuga cod și funcții personalizate, astfel încât să îl putem extinde.

Pasul 1: Care sunt funcțiile?

O funcție este o bucată de cod care manipulează datele din foaia de calcul pentru a calcula automat o nouă valoare pentru noi. Un exemplu foarte comun al unei astfel de funcții este SUM, care calculează suma unei coloane sau a unui grup de celule.

Toate programele de calcul tabelar acceptă o mulțime de astfel de funcții care sunt pre-încorporate în ele, dar acceptă, de asemenea, capacitatea de a le extinde și de a scrie a noastră.

Pasul 2: Cum se scrie o funcție personalizată?

Pentru a scrie o funcție personalizată în Foi de calcul Google, folosim o caracteristică a acesteia numită Apps Script, care este o platformă rapidă de dezvoltare a aplicațiilor în care putem scrie cod în JavaScript direct în browser, care va fi apoi executat în foaia noastră de calcul.

Pentru a începe să scriem, putem accesa Instrumente> Editor de scripturi din meniul de sus și care va afișa editorul de cod online.

În el, la prima deschidere, vom avea un fișier numit Code.gs împreună cu o funcție de pornire necompletată, numită funcția mea.

Ca exemplu de pornire, vom redenumi această funcție în DOUBLE și vom adăuga un parametru de intrare în declarația sa. În corpul funcției, trebuie să returnăm o valoare și, pentru acest exemplu, vom înmulți doar valoarea de intrare cu 2.

Acum putem salva scriptul și dacă ne întoarcem la foaia de calcul și adăugăm câteva date la acesta, putem face referință acum la această funcție în orice celulă și putem trimite referința celulei de date ca intrare pentru valoare.

La executarea acestei funcții, Foi de calcul Google va afișa în scurt timp un mesaj de încărcare în celulă, dar va afișa apoi valoarea returnată din funcție.

Pasul 3: Limitări de funcții și completare automată

Aceste funcții pot face orice vrem, dar există câteva limitări pe care trebuie să le urmăm, cum ar fi:

Numele trebuie să fie unice și diferite de cele utilizate de funcțiile încorporate Numele nu trebuie să se termine cu un _, iar numele funcțiilor sunt de obicei scrise cu litere mari, deși acest lucru nu este necesar.

Fiecare funcție poate returna o singură valoare ca în exemplul nostru, dar poate returna și o serie de valori. Această matrice va fi apoi extinsă în celule adiacente, atâta timp cât acestea sunt goale. Dacă nu sunt o eroare va fi afișat.

Funcția pe care am scris-o este utilizabilă, dar pentru oricine ar putea veni să editeze documentul, aceasta va fi necunoscută și utilizatorul va trebui să știe că există pentru a-l utiliza. Putem remedia acest lucru adăugând funcția la lista de completare automată, la fel ca toate funcțiile încorporate.

Pentru a face acest lucru, trebuie să adăugăm o etichetă JsDoc @customfunction în fața funcției ca un comentariu, unde în acest comentariu putem scrie o scurtă explicație a ceea ce face funcția noastră.

Acum, cu comentariul adăugat, când începem să scriem numele funcției, funcția va fi oferită de completarea automată, împreună cu descrierea funcției.

Pasul 4: Apelarea serviciilor externe

Marea putere pe care o au aceste funcții provine din capacitatea de a apela și de a interacționa cu alte instrumente și servicii de la Google, cum ar fi Traducere, Hărți, conectarea la o bază de date externă, lucrul cu XML și altele. De departe, cea mai puternică caracteristică pentru mine este capacitatea de a face o cerere HTTP externă către orice API sau pagină web și de a obține date de la aceasta utilizând serviciul UrlFetch.

Pentru a demonstra acest lucru, voi insera o funcție care va converti dolari SUA în franc elvețian, dar nu va asuma rata valutară, ci o va prelua dintr-un API extern.

Funcția folosește și serviciul cache încorporat, unde nu va apela API-ul pentru toate calculele, dar îl va apela o dată pentru primul calcul și apoi va stoca acea valoare în cache.

Orice alt calcul se va face apoi cu valoarea cache, astfel încât performanța acestora va fi mult îmbunătățită și nu vom atinge serverul, de multe ori, deoarece ratele nu se schimbă atât de repede.

Deoarece API returnează JSON, odată ce primim răspunsul de la server, trebuie să analizăm JSON într-un obiect și putem obține rata, înmulți-o cu valoarea de intrare și restitui noua valoare calculată la celulă.

Pasul 5: Pașii următori

Dacă vi se pare interesant și doriți să aflați mai multe, vă voi lăsa linkurile de mai jos pentru resurse suplimentare.

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

developers.google.com/apps-script

Dacă ți-a plăcut Instructable, atunci asigură-te că te abonezi la canalul meu YouTube dacă nu ți-ai făcut-o deja și verifică unele dintre celelalte Instructables ale mele.

Noroc și mulțumesc pentru lectură.