Arkusze Google to rozwiązanie w postaci arkusza kalkulacyjnego działające w chmurze, które umożliwia współpracę w czasie rzeczywistym i zawiera potężne narzędzia do wizualizacji, przetwarzania i przekazywania danych.
Możesz rozszerzyć Arkusze za pomocą dodatków, które umożliwiają tworzenie niestandardowych usprawnień przepływu pracy, nawiązywanie połączeń z systemami innych firm oraz integrację danych z Arkuszy z innymi aplikacjami Google Workspace (np. z Prezentacjami Google).
Dodatki do Arkuszy stworzone przez innych użytkowników możesz zobaczyć w Google Workspace Marketplace.
Co możesz zrobić
Oto kilka funkcji, które możesz wykonywać za pomocą dodatku rozszerzającego Arkusze Google:
- Za pomocą wbudowanej usługi Apps Script Spreadsheet service możesz odczytywać, edytować, wizualizować i formatować dane w arkuszach kalkulacyjnych Google. Usługa umożliwia też tworzenie i modyfikowanie formatowania warunkowego oraz reguł sprawdzania poprawności danych.
- Aby uzyskać bezpośredni dostęp do interfejsu Google Sheets API, możesz użyć zaawansowanej usługi Arkuszy w Apps Script.
- Możesz tworzyć niestandardowe menu i definiować wiele niestandardowych okien i pasków bocznych za pomocą standardowego kodu HTML i CSS.
- W przystawce możesz uwzględniać definicje funkcji niestandardowych.
- Możesz używać reguł dodatków, które wykonują określone funkcje, gdy wystąpią określone zdarzenia uruchamiające.
Dodatki do Arkuszy są tworzone za pomocą Apps Script. Więcej informacji o uzyskiwaniu dostępu do Arkuszy Google i zarządzaniu nimi za pomocą Apps Script znajdziesz w artykule Rozszerzanie Arkuszy Google.
Struktura arkusza
Arkusz w Arkuszach Google składa się z co najmniej 1 arkusza. Każdy arkusz jest w istocie dwuwymiarową siatką komórek, w których można przechowywać tekst, liczby, linki i inne wartości. Grupa co najmniej 1 sąsiednich komórek to zakres.
Usługa Arkuszy Google w Apps Script udostępnia kilka klas reprezentujących struktury organizacyjne w Arkuszach (np. Sheet i Range). Za pomocą tych klas możesz odczytywać i modyfikować dane oraz zachowanie Arkuszy.
Reguły
Reguły Apps Script umożliwiają projektowi skryptu wykonywanie określonej funkcji po spełnieniu określonych warunków, np. po otwarciu arkusza kalkulacyjnego lub zainstalowaniu dodatku.
Więcej informacji o tym, jakie wyzwalacze można używać z dodatkami do Arkuszy, oraz o ograniczeniach ich stosowania, znajdziesz w artykule Wyzwalacze dodatków.
Funkcje niestandardowe
Arkusze Google zawierają wiele wbudowanych funkcji, takich jak SUM i AVERAGE, które można wywołać z komórki arkusza Google.
Dodatki do Arkuszy mogą definiować dodatkowe funkcje niestandardowe, które uzupełniają te wbudowane. Gdy użytkownik zainstaluje dodatek, zdefiniowane w nim funkcje niestandardowe staną się dostępne natychmiast. Wtyczka 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 w dodatku
Jako funkcji niestandardowej można użyć dowolnej funkcji zdefiniowanej w projekcie skryptu dodatku. Gdy funkcja zostanie zaimplementowana, a dodatek zainstalowany, możesz wywoływać funkcję niestandardową jak każdą inną wbudowaną funkcję Arkuszy: w komórce Arkuszy 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 arkusza, a w razie potrzeby przenoszony do sąsiednich komórek.
Podczas tworzenia funkcji niestandardowych w dodatku należy przestrzegać ogólnych wskazówek dotyczących funkcji niestandardowych:
- Wytyczne dotyczące nazw funkcji
- Definiowanie argumentów funkcji
- Definiowanie wartości zwracanej przez funkcję
- Typy danych niestandardowych funkcji
- Włączanie autouzupełniania za pomocą JSDoc
- Funkcje niestandardowe usług mogą korzystać z:
- Optymalizacja funkcji niestandardowych
Dodatkowo funkcje niestandardowe zdefiniowane w dodatkach mają pewne szczególne cechy:
- Nadaj funkcji unikalną nazwę, na przykład powiązaną z nazwą dodatku. Jeśli co najmniej 2 zainstalowane dodatki definiują funkcje niestandardowe o tej samej nazwie, użytkownicy mogą korzystać tylko z jednego z nich.
- Dodatek powinien jasno informować o dostępnych funkcjach niestandardowych. Pamiętaj, aby dodać dokładne komentarze JSDoc do swoich funkcji niestandardowych, aby Apps Script mógł wyświetlać użytkownikowi informacje o autouzupeł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 są wykonywane w mniej niż 30 sekund, kończą się błędem
Internal error executing the custom function. Zadbaj o dobre wrażenia użytkowników, ograniczając ilość przetwarzania w funkcji niestandardowej. Zoptymalizuj funkcję, jeśli to możliwe. - Funkcje niestandardowe nie mogą korzystać z usług Apps Script, które wymagają autoryzacji. Jeśli spróbujesz to zrobić, funkcja nie zadziała i wyświetli 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 arkuszu 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 zapewnij tę funkcjonalność za pomocą elementu menu, okna dialogowego lub interakcji z boczną belką.
Makra w Arkuszach
Makra umożliwiają rejestrowanie działań wykonywanych w Arkuszach Google i powtarzanie ich później za pomocą skrótu klawiszowego. Gdy makro zostanie utworzone w arkuszu, zostanie dodane jako funkcja makra w projekcie Apps Script powiązanym z tym arkuszem. Więcej informacji o makrach znajdziesz w artykule Makry w Arkuszach Google.
Makr w Arkuszach nie można rozpowszechniać w dodatkach. Jeśli dodasz definicję makra do pliku manifestu dodatku, nie będzie ona dostępna dla użytkowników tego dodatku.