Добавяне на персонализирана функция в Google Sheets: 5 стъпки

2024 Автор: John Day | [email protected]. Последно модифициран: 2024-01-30 07:50

Сигурен съм, че в даден момент от живота си трябваше да използвате софтуер за електронни таблици като Microsoft Excel или Google Sheets.

Те са сравнително прости и директни за използване, но също така са много мощни и лесно се разширяват.

Днес ще разгледаме Google Sheets и способността му да добавя код и персонализирани функции, за да можем да го разширим.

Стъпка 1: Какви са функциите?

Функция е част от код, който манипулира данните от електронната таблица, за да изчисли автоматично нова стойност за нас. Много често срещан пример за такава функция е SUM, който изчислява сумата на колона или група клетки.

Целият софтуер за електронни таблици поддържа много такива функции, които са предварително вградени в тях, но също така поддържат възможността да ги разширяваме и да пишем наши собствени.

Стъпка 2: Как да напиша персонализирана функция?

За да напишем персонализирана функция в Google Sheets, използваме нейната функция, наречена Apps Script, която е платформа за бързо разработване на приложения, където можем да напишем код в JavaScript директно в браузъра, който след това ще бъде изпълнен в нашата електронна таблица.

За да започнем да пишем, можем да отидем в Инструменти> Редактор на скриптове в горното меню и това ще изведе онлайн редактора на кодове.

В него при първото отваряне ще имаме един файл, наречен Code.gs заедно с празна начална функция, наречена myFunction.

Като начален пример ще преименуваме тази функция на DOUBLE и ще добавим входен параметър в нейната декларация. Вътре в тялото на функцията трябва да върнем стойност и за този пример просто ще умножим входната стойност с 2.

Вече можем да запишем скрипта и ако се върнем към електронната таблица и добавим към нея някои данни, сега можем да се позовем на тази функция във всяка клетка и да изпратим препратката към клетката с данни като вход за стойността.

При изпълнение на тази функция Google Sheets скоро ще покаже съобщение за зареждане в клетката, но след това ще покаже върнатата стойност от функцията.

Стъпка 3: Ограничения на функциите и автодовършване

Тези функции могат да правят каквото искаме, но има някои ограничения, които трябва да следваме като:

Имената трябва да бъдат уникални и различни от тези, използвани от вградените функции Името не трябва да завършва с _, а имената на функциите обикновено се пишат с главни букви, въпреки че това не е задължително.

Всяка функция може да върне единична стойност, както в нашия пример, но може да върне и масив от стойности. След това този масив ще бъде разширен в съседни клетки, стига да са празни. Ако те не са, ще се покаже грешка.

Функцията, която написахме, е използваема, но за всеки друг, който може да дойде да редактира документа, тя ще бъде неизвестна и потребителят ще трябва да знае, че съществува, за да я използва. Можем да поправим това, като добавим функцията към списъка за автоматично довършване, същата като всички вградени функции.

За да направим това, трябва да добавим JsDoc @customfunction маркер пред функцията като коментар, където в този коментар можем да напишем кратко обяснение за това, което прави нашата функция.

Сега с добавения коментар, когато започнем да записваме името на функцията, функцията ще се предлага от автодовършването, заедно с описанието на функцията.

Стъпка 4: Обаждане на външни услуги

Голямата сила, която имат тези функции, идва от възможността да се обаждате и да взаимодействате с други инструменти и услуги от Google като Translate, Maps, да се свързвате с външна база данни, да работите с XML и други. Най -мощната функция за мен е възможността да направя външна HTTP заявка към всеки API или уеб страница и да получавам данни от нея с помощта на услугата UrlFetch.

За да демонстрирам това, ще вмъкна функция, която ще преобразува щатски долари в швейцарски франк, но няма да приема валутния курс, а вместо това ще го извлече от външен API.

Функцията също така използва вградената кеш услуга, където няма да извиква API за всички изчисления, но ще я извика веднъж за първото изчисление и след това ще съхрани тази стойност в кеша.

След това всяко друго изчисление ще бъде направено с кешираната стойност, така че тяхната производителност ще бъде значително подобрена и няма да ударим сървъра толкова често, тъй като процентите не се променят толкова бързо.

Тъй като API връща JSON, след като получим отговора от сървъра, трябва да анализираме JSON в обект и след това можем да получим скоростта, да я умножим с входната стойност и да върнем новата, изчислена стойност в клетката.

Стъпка 5: Следващи стъпки

Ако намирате това за интересно и искате да научите повече, ще оставя връзки по -долу към допълнителни ресурси.

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

developers.google.com/apps-script

Ако ви харесва Instructable, не забравяйте да се абонирате за канала ми в YouTube, ако все още не сте го направили, и разгледайте някои от другите ми инструктажи.

Наздраве и благодаря за четенето.