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.
Arkusze możesz rozszerzyć za pomocą dodatków, które usprawniają przepływ pracy, umożliwiają połączenie z systemami innych firm i integrują dane z Arkuszy z innymi aplikacjami Google Workspace (np. Prezentacjami Google).
Dodatki do Arkuszy utworzone przez innych użytkowników znajdziesz w Google Workspace Marketplace.
Co możesz zrobić
Oto kilka rzeczy, które możesz zrobić za pomocą dodatków rozszerzających Arkusze:
- Odczytywać, edytować, wizualizować i formatować dane w arkuszach kalkulacyjnych Arkuszy za pomocą wbudowanej usługi Apps Script Spreadsheet. Usługa umożliwia też tworzenie i modyfikowanie reguł formatowania warunkowego i sprawdzania poprawności danych.
- Używać zaawansowanej usługi Apps Script Sheets, aby uzyskać bezpośredni dostęp do interfejsu Google Sheets API.
- Tworzyć niestandardowe menu oraz definiować wiele niestandardowych okien i interfejsów pasków bocznych za pomocą standardowego kodu HTML i CSS.
- Dodawać do dodatku definicje funkcji niestandardowych.
- Używać aktywatorów dodatków, które uruchamiają określone funkcje, gdy wystąpią określone zdarzenia wyzwalające.
Dodatki do Arkuszy są tworzone za pomocą Apps Script. Więcej informacji o tym, jak uzyskiwać dostęp do Arkuszy i zarządzać nimi za pomocą Apps Script, znajdziesz w artykule Rozszerzanie Arkuszy.
Struktura arkusza
Arkusze Google składają się z co najmniej 1 arkusza. Każdy arkusz to zasadniczo 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 nazywana jest zakresem.
Usługa Apps Script
Spreadsheet udostępnia kilka
klas reprezentujących struktury organizacyjne w Arkuszach (np.
Sheeti Range). Możesz używać tych
klas do odczytywania i modyfikowania danych oraz zachowania Arkuszy.
Aktywatory
Aktywatory 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 aktywatorów można używać z dodatkami do Arkuszy i jakie ograniczenia obowiązują w przypadku ich użycia, znajdziesz w artykule Aktywatory 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 zawarte w dodatku będą 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 dodatków
Każda funkcja zdefiniowana w projekcie skryptu dodatku może być używana jako funkcja niestandardowa. Po zaimplementowaniu funkcji i zainstalowaniu dodatku możesz wywołać funkcję niestandardową tak jak każdą inną wbudowaną funkcję Arkuszy: w komórce Arkuszy wpisz znak = oraz nazwę funkcji i wymagane parametry. Jeśli nie ma błędów, wynik zwrócony przez funkcję zostanie umieszczony w komórce Arkuszy, a w razie potrzeby zostanie rozszerzony na sąsiednie komórki.
Podczas tworzenia funkcji niestandardowych w dodatku należy przestrzegać ogólnych wytycznych dotyczących funkcji niestandardowych:
- Wytyczne dotyczące nazewnictwa funkcji
- Definiowanie argumentów funkcji
- Definiowanie wartości zwracanej przez funkcję
- Typy danych funkcji niestandardowych
- Włączanie autouzupełniania za pomocą JSDoc
- Usługi, z których mogą korzystać funkcje niestandardowe
- Optymalizowanie funkcji niestandardowych
Ponadto w przypadku funkcji niestandardowych zdefiniowanych w dodatkach obowiązują pewne szczególne zasady:
- Podczas nazywania funkcji staraj się utworzyć unikalną nazwę, która może być powiązana z nazwą dodatku. Jeśli co najmniej 2 zainstalowane dodatki definiują funkcje niestandardowe o tej samej nazwie, użytkownicy mogą używać tylko jednej z nich.
- Dodatek powinien jasno informować o tym, jakie funkcje niestandardowe udostępnia. Pamiętaj, aby podać dokładne komentarze JSDoc dotyczące funkcji niestandardowych, tak aby Apps Script mógł wyświetlać informacje o autouzupełnianiu użytkownikowi. Dodatkowo rozważ udostępnienie dodatkowej dokumentacji funkcji niestandardowych w samym dodatku lub na stronie pomocy dotyczącej dodatku.
- Funkcje niestandardowe, które nie zostaną wykonane w ciągu 30 sekund, zakończą się niepowodzeniem i wyświetlą błąd
Internal error executing the custom function(Wystąpił błąd wewnętrzny podczas wykonywania funkcji niestandardowej). Zadbaj o wygodę użytkowników, ograniczając ilość przetwarzania wykonywanego w funkcji niestandardowej. Zoptymalizuj funkcję w miarę możliwości. - Funkcje niestandardowe nie mogą korzystać z usług Apps Script, które wymagają autoryzacji. Jeśli spróbujesz to zrobić, wyświetli się błąd
You do not have permission to call X service(Nie masz uprawnień do wywołania usługi X). W funkcji niestandardowej używaj tylko dozwolonych usług. - Każda funkcja niestandardowa w Arkuszach powoduje osobne 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, uprość funkcje niestandardowe. Jeśli funkcja ma wykonywać złożone lub długotrwałe przetwarzanie, nie używaj funkcji niestandardowej. Zamiast tego udostępnij tę funkcję za pomocą elementu menu, okna lub interakcji z paskiem bocznym.
Makra Arkuszy
Makra umożliwiają rejestrowanie działań wykonywanych w Arkuszach i powtarzanie ich później za pomocą skrótu klawiaturowego. Gdy makro zostanie utworzone w Arkuszach, jest dodawane jako funkcja makra w projekcie Apps Script powiązanym z tymi Arkuszami. Więcej informacji o makrach znajdziesz w artykule Makra Arkuszy.
Niestety makr Arkuszy nie można rozpowszechniać z dodatkami. Jeśli w manifeście dodatku umieścisz definicję makra, będzie ona niedostępna dla użytkowników tego dodatku.