Pielāgotas funkcijas pievienošana Google izklājlapām: 5 soļi

2024 Autors: John Day | [email protected]. Pēdējoreiz modificēts: 2024-01-30 10:51

Esmu pārliecināts, ka kādā dzīves posmā jums bija jāizmanto izklājlapu programmatūra, piemēram, Microsoft Excel vai Google izklājlapas.

Tie ir salīdzinoši vienkārši un vienkārši lietojami, bet arī ļoti spēcīgi un viegli izvelkami.

Šodien mēs apskatīsim Google izklājlapas un tās iespējas pievienot kodu un pielāgotas funkcijas, lai mēs varētu to pagarināt.

1. darbība. Kas ir funkcijas?

Funkcija ir koda fragments, kas manipulē ar izklājlapas datiem, lai automātiski aprēķinātu jaunu vērtību. Ļoti izplatīts šādas funkcijas piemērs ir SUM, kas aprēķina kolonnas vai šūnu grupas summu.

Visa izklājlapu programmatūra atbalsta daudzas šādas funkcijas, kas ir iebūvētas tajās, taču atbalsta arī iespēju tās paplašināt un rakstīt mūsu pašu.

2. darbība. Kā uzrakstīt pielāgotu funkciju?

Lai rakstītu pielāgotu funkciju Google izklājlapās, mēs izmantojam tās funkciju ar nosaukumu Apps Script, kas ir ātra lietojumprogrammu izstrādes platforma, kurā mēs varam rakstīt kodu JavaScript tieši pārlūkprogrammā, kas pēc tam tiks izpildīta mūsu izklājlapā.

Lai sāktu rakstīt, augšējā izvēlnē dodieties uz Rīki> Skripta redaktors, un tiks parādīts tiešsaistes koda redaktors.

Tajā, pirmo reizi atverot, mums būs viens fails ar nosaukumu Code.gs kopā ar tukšu sākuma funkciju ar nosaukumu myFunction.

Kā sākuma piemēru mēs pārdēvēsim šo funkciju uz DOUBLE un pievienosim ievades parametru tās deklarācijā. Funkcijas pamattekstā mums jāatgriež vērtība, un šajā piemērā mēs tikai reizināsim ievades vērtību ar 2.

Tagad mēs varam saglabāt skriptu, un, ja mēs atgriezīsimies izklājlapā un pievienosim tam dažus datus, mēs tagad varam atsaukties uz šo funkciju jebkurā šūnā un nosūtīt datu šūnas atsauci kā vērtības ievadi.

Izpildot šo funkciju, Google izklājlapas šūnā drīz parādīs ziņojumu Loading, bet pēc tam parādīs funkcijas atgriezto vērtību.

3. darbība: funkciju ierobežojumi un automātiskā pabeigšana

Šīs funkcijas var darīt visu, ko vēlamies, taču ir jāievēro daži ierobežojumi, piemēram:

Nosaukumiem jābūt unikāliem un atšķirīgiem no tiem, kurus izmanto iebūvētās funkcijas. Nosaukums nedrīkst beigties ar _, un funkciju nosaukumi parasti tiek rakstīti ar lielajiem burtiem, lai gan tas nav obligāti.

Katra funkcija var atgriezt vienu vērtību, kā tas ir mūsu piemērā, taču tā var arī atgriezt vērtību masīvu. Pēc tam šis masīvs tiks izvērsts blakus esošajās šūnās, kamēr tās ir tukšas. Ja tie nav kļūda, tiks parādīts.

Mūsu rakstītā funkcija ir izmantojama, taču ikvienam citam, kas varētu nākt rediģēt dokumentu, tas nebūs zināms, un lietotājam būs jāzina, ka tas pastāv, lai to izmantotu. Mēs to varam novērst, pievienojot funkciju automātiskās pabeigšanas sarakstam, tāpat kā visas iebūvētās funkcijas.

Lai to izdarītu, funkcijas priekšā ir jāpievieno tags JsDoc @customfunction kā komentārs, kur šajā komentārā mēs varam uzrakstīt īsu paskaidrojumu par mūsu funkcijas darbību.

Tagad, pievienojot komentāru, kad mēs sākam rakstīt funkcijas nosaukumu, funkciju piedāvās automātiskā pabeigšana kopā ar funkcijas aprakstu.

4. darbība: zvaniet ārējiem dienestiem

Šo funkciju lielais spēks ir iespēja zvanīt un mijiedarboties ar citiem Google rīkiem un pakalpojumiem, piemēram, tulkotāju, Maps, izveidot savienojumu ar ārēju datu bāzi, strādāt ar XML un citiem. Līdz šim visspēcīgākā funkcija man ir iespēja veikt ārēju HTTP pieprasījumu jebkurai API vai tīmekļa lapai un iegūt datus no tās, izmantojot pakalpojumu UrlFetch.

Lai to pierādītu, es ievietošu funkciju, kas konvertēs ASV dolārus uz Šveices franku, bet neuzņemsies valūtas kursu, bet tā vietā to izgūs no ārējas API.

Funkcija izmanto arī iebūvēto kešatmiņas pakalpojumu, kur tā neizsauks API visiem aprēķiniem, bet pirmo reizi to izsauks vienu reizi un pēc tam saglabās šo vērtību kešatmiņā.

Katrs cits aprēķins tiks veikts, izmantojot kešatmiņā saglabāto vērtību, tāpēc to veiktspēja tiks ievērojami uzlabota, un mēs nesasniegsim serveri tik bieži, jo likmes tik ātri nemainās.

Tā kā API atgriež JSON, tad, kad esam saņēmuši atbildi no servera, mums jāanalizē JSON objektā, un pēc tam mēs varam iegūt likmi, reizināt to ar ievades vērtību un atgriezt šūnā jauno aprēķināto vērtību.

5. darbība. Nākamās darbības

Ja jums tas šķiet interesanti un vēlaties uzzināt vairāk, zemāk es atstāju saites uz papildu resursiem.

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

developers.google.com/apps-script

Ja jums patika Instructable, noteikti abonējiet manu YouTube kanālu, ja vēl neesat to izdarījis, un apskatiet dažus citus manus Instructables.

Prieks un paldies par lasīšanu.