Arkusze Google to oparte na chmurze rozwiązanie do obsługi arkuszy kalkulacyjnych, które umożliwia współpracę w czasie rzeczywistym i oferuje zaawansowane narzędzia do wizualizacji, przetwarzania i przekazywania danych.
Możesz rozszerzyć funkcjonalność Arkuszy za pomocą dodatków, które umożliwiają tworzenie niestandardowych ulepszeń przepływu pracy, nawiązywanie połączeń z systemami innych firm i integrowanie danych z Arkuszy z innymi aplikacjami Google Workspace (np. Prezentacjami Google).
Dodatki do Arkuszy utworzone przez inne osoby możesz zobaczyć w Google Workspace Marketplace.
Co możesz zrobić
Oto kilka czynności, które możesz wykonywać za pomocą dodatków rozszerzających Arkusze:
- Odczytywanie, edytowanie, wizualizowanie i formatowanie danych w arkuszach kalkulacyjnych Arkuszy za pomocą wbudowanej usługi Arkusze Apps Script. Usługa umożliwia też tworzenie i modyfikowanie reguł formatowania warunkowego oraz sprawdzania poprawności danych.
- Aby uzyskać bezpośredni dostęp do interfejsu Google Sheets API, użyj zaawansowanej usługi Arkuszy Apps Script.
- Twórz niestandardowe menu i definiuj wiele interfejsów niestandardowych okien i pasków bocznych za pomocą standardowych języków HTML i CSS.
- Uwzględnij w dodatku definicje funkcji niestandardowych.
- Używaj aktywatorów dodatków, które uruchamiają określone funkcje, gdy wystąpią określone zdarzenia wywołujące.
Dodatki do Arkuszy są tworzone za pomocą Apps Script. Więcej informacji o tym, jak uzyskiwać dostęp do Arkuszy i nimi zarządzać za pomocą Apps Script, znajdziesz w artykule Rozszerzanie Arkuszy.
Struktura arkusza
Arkusz kalkulacyjny w Arkuszach składa się z co najmniej 1 arkusza. Każdy arkusz to w zasadzie dwuwymiarowa siatka komórek, w których można przechowywać tekst, liczby, linki i inne wartości. Grupa co najmniej 1 sąsiadujących komórek to zakres.
Usługa Arkusze Apps Script udostępnia kilka klas do reprezentowania struktur organizacyjnych w Arkuszach (np. Sheet i Range). Możesz używać tych klas do odczytywania i modyfikowania danych oraz zachowań Arkuszy.
Aktywatory
Wyzwalacze Apps Script umożliwiają uruchamianie określonej funkcji w projekcie skryptu po spełnieniu określonych warunków, np. po otwarciu arkusza kalkulacyjnego lub zainstalowaniu dodatku.
Więcej informacji o tym, jakich wyzwalaczy można używać w dodatkach do Arkuszy i jakie ograniczenia obowiązują w przypadku ich używania, znajdziesz w artykule Wyzwalacze dodatków.
Funkcje niestandardowe
Arkusze mają wiele wbudowanych funkcji, takich jak SUM i AVERAGE, które można wywoływać z komórki Arkuszy. Dodatki do Arkuszy mogą definiować dodatkowe funkcje niestandardowe, które uzupełniają te wbudowane funkcje. Gdy użytkownik zainstaluje dodatek, wszystkie zdefiniowane funkcje niestandardowe dołączone do dodatku staną się od razu dostępne. Dodatek może składać się tylko z definicji funkcji niestandardowych. Definicje funkcji niestandardowych są udostępniane innym osobom głównie przez opublikowanie dodatku zawierającego te definicje.
Tworzenie funkcji niestandardowych dodatku
Każda funkcja zdefiniowana w projekcie skryptu dodatku może być używana jako funkcja niestandardowa. Po wdrożeniu funkcji i zainstalowaniu dodatku możesz wywołać funkcję niestandardową tak samo jak każdą inną wbudowaną funkcję Arkuszy: w komórce arkusza wpisz =, a następnie nazwę funkcji i wymagane parametry. Jeśli nie ma błędów, wynik zwrócony przez funkcję jest umieszczany w komórce Arkuszy, a w razie potrzeby rozlewa się na sąsiednie komórki.
Podczas tworzenia funkcji niestandardowych w dodatku należy postępować zgodnie z ogólnymi wytycznymi dotyczącymi funkcji niestandardowych:
- Wytyczne dotyczące nazewnictwa funkcji
- Określanie argumentów funkcji
- Definiowanie wartości zwracanej przez funkcję
- Typy danych funkcji niestandardowych
- Włączanie autouzupełniania za pomocą JSDoc
- Funkcje niestandardowe usług mogą używać
- Optymalizowanie funkcji niestandardowych
Dodatkowo funkcje niestandardowe zdefiniowane w dodatkach podlegają pewnym szczególnym zasadom:
- Podczas nazywania funkcji staraj się tworzyć unikalne nazwy, być może powiązane z nazwą dodatku. Jeśli 2 lub więcej zainstalowanych dodatków definiuje funkcje niestandardowe o tej samej nazwie, użytkownicy mogą używać tylko jednej z nich.
- Dodatek powinien jasno informować o dostarczanych przez niego funkcjach niestandardowych. Pamiętaj, aby podać dokładne komentarze JSDoc do funkcji niestandardowych, aby Apps Script mógł wyświetlać użytkownikowi informacje o automatycznym uzupełnianiu. Dodatkowo możesz udostępnić dodatkową dokumentację funkcji niestandardowych w samym dodatku lub na stronie pomocy dotyczącej dodatku.
- Funkcje niestandardowe, które nie zostaną wykonane w ciągu 30 sekund, zwracają błąd
Internal error executing the custom function. Zadbaj o dobre wrażenia użytkowników, ograniczając ilość przetwarzania w funkcji niestandardowej. Optymalizuj funkcję w miarę możliwości. - Funkcje niestandardowe nie mogą korzystać z usług Apps Script, które wymagają autoryzacji, i w takim przypadku zwracają błąd
You do not have permission to call X service. W funkcji niestandardowej używaj tylko dozwolonych usług. - Każda funkcja niestandardowa w Arkuszach powoduje oddzielne wywołanie serwerów Apps Script. Jeśli użytkownik spróbuje użyć funkcji niestandardowych w zbyt wielu komórkach, funkcje mogą działać wolno. Aby temu zapobiec, staraj się, aby funkcje niestandardowe były jak najprostsze. Jeśli funkcja ma wykonywać złożone lub rozszerzone przetwarzanie, nie używaj funkcji niestandardowej. Zamiast tego udostępnij tę funkcję za pomocą pozycji menu, okna dialogowego lub interakcji na pasku bocznym.
Makra Arkuszy
Makra umożliwiają rejestrowanie działań wykonywanych w Arkuszach i powtarzanie ich później za pomocą skrótu klawiszowego. Gdy w Arkuszach utworzysz makro, zostanie ono dodane jako funkcja makra w projekcie Apps Script powiązanym z tymi Arkuszami. Więcej informacji o makrach znajdziesz w artykule Makra w Arkuszach.
Niestety makr Arkuszy nie można rozpowszechniać z dodatkami. Jeśli w pliku manifestu dodatku umieścisz definicję makra, będzie ona niedostępna dla użytkowników tego dodatku.