Skrypt jest powiązany z plikiem Arkuszy, Dokumentów, Prezentacji lub Formularzy Google, jeśli został utworzony na podstawie tego dokumentu, a nie jako samodzielny skrypt. Plik, do którego jest dołączony skrypt, nazywa się „kontenerem”. Scenariusze połączone działają podobnie jak skrypty samodzielne, z tym wyjątkiem, że nie są widoczne na Dysku Google, nie można ich odłączyć od pliku, z którym są połączone, i mają kilka specjalnych uprawnień w stosunku do pliku nadrzędnego.
Pamiętaj, że skrypty mogą być też powiązane z Witrynami Google, ale prawie zawsze są one wdrażane jako aplikacje internetowe. Skrypty powiązane z Arkuszami, Dokumentami, Prezentacjami lub Formularzami Google mogą też stać się aplikacjami internetowymi, choć jest to rzadkie.
Tworzenie skryptu powiązanego
Dokumenty, Arkusze lub Prezentacje Google
Aby utworzyć połączony skrypt w Dokumentach Google, Arkuszach lub Prezentacjach, otwórz dokument w Dokumentach, arkusz kalkulacyjny w Arkuszach lub prezentację w Prezentacjach i kliknij Wtyczki > Skrypt aplikacji. Aby ponownie otworzyć skrypt w przyszłości, wykonaj te same czynności lub otwórz skrypt na panelu Apps Script.
Formularze Google
Aby utworzyć skrypt powiązany w Google Forms, otwórz formularz i kliknij Więcej > Edytor skryptów. Aby ponownie otworzyć skrypt w przyszłości, wykonaj te same czynności lub otwórz go na panelu Skrypty aplikacji.
Metody specjalne
Powiązane skrypty mogą wywoływać kilka metod, których nie można wywoływać w samodzielnych skryptach:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()igetActiveForm()pozwalają powiązanym skryptom odwoływać się do ich pliku nadrzędnego bez podawania jego identyfikatora.getUipozwala skryptom wbudowanym uzyskiwać dostęp do interfejsu użytkownika w pliku nadrzędnym, aby dodawać niestandardowe menu, okna i paski boczne.- W Arkuszach Google funkcje
getActiveSheet(),getActiveRange()igetActiveCell()pozwalają skryptowi określić bieżący arkusz użytkownika, wybrany zakres komórek lub wybraną pojedynczą komórkę.setActiveSheet(sheet)isetActiveRange(range)pozwalają skryptowi zmienić te wybory. - W Dokumentach Google,
getActiveTab(),getCursor()igetSelection()skrypt może określać bieżącą kartę użytkownika, pozycję kursora lub zaznaczony tekst.setActiveTab(tabId),setCursor(position)isetSelection(range)pozwól skryptowi zmienić te wybory.
Więcej informacji znajdziesz w przewodniku po rozszerzaniu Arkuszy Google lub przewodniku po rozszerzaniu Dokumentów Google.
Menu, okna i paski boczne niestandardowe
Powiązane skrypty mogą dostosowywać Arkusze Google, Dokumenty i Formularze Google przez dodawanie niestandardowych menu oraz okien dialogowych lub pasków bocznych. Pamiętaj jednak, że skrypt może wchodzić w interakcję z interfejsem tylko w przypadku bieżącego otwartego pliku. Oznacza to, że skrypt powiązany z jednym dokumentem nie może wpływać na interfejs innego dokumentu.
Reguły
Powiązane skrypty mogą używać prostych wyzwalaczy, takich jak specjalna funkcja onOpen(), która działa automatycznie za każdym razem, gdy plik otwiera użytkownik z uprawnieniami do edycji. Podobnie jak inne skrypty, mogą one też używać instalowanych wyzwalaczy.
Funkcje niestandardowe
Funkcja niestandardowa to funkcja w skrypcie powiązanym z Arkuszami Google, którą wywołujesz bezpośrednio z komórki za pomocą składni =myFunctionName(). Funkcje niestandardowe są więc podobne do setek wbudowanych funkcji w Arkuszach, takich jak AVERAGE czy SUM, z tą różnicą, że to Ty definiujesz działanie funkcji niestandardowej.
Dostęp do powiązanych skryptów
Tylko użytkownicy, którzy mają uprawnienia do edytowania kontenera, mogą uruchamiać powiązany skrypt. Współpracownicy, którzy mają tylko uprawnienia do wyświetlania, nie mogą otworzyć edytora skryptu, ale jeśli utworzą kopię pliku kontenera, staną się właścicielami tej kopii i będą mogli ją wyświetlać oraz uruchamiać.
Aby dowiedzieć się, jak udostępnić plik kontenera skryptu, przeczytaj artykuł Udostępnianie plików na Dysku Google.