Makra Arkuszy Google

Arkusze Google umożliwiają rejestrowanie makr, które powielają określoną przez Ciebie serię interakcji z interfejsem użytkownika. Po zarejestrowaniu makra możesz połączyć je ze skrótem klawiszowym w formularzu Ctrl+Alt+Shift+Number. Używając tego skrótu, możesz szybko wykonać dokładne kroki makra, zwykle w innym miejscu lub z innymi danymi. Możesz też aktywować makro w menu Rozszerzenia >Makra Arkusze Google.

Gdy rejestrujesz makro, Arkusze Google automatycznie tworzą funkcję Apps Script (funkcję makra), która powiela kroki makr. Makro jest dodawane do projektu Apps Script powiązanego z arkuszem w pliku o nazwie macros.gs. Jeśli plik projektu jest już powiązany z arkuszem o tej nazwie, do niego jest dołączana funkcja makro. Arkusze Google automatycznie aktualizują też plik manifestu projektu skryptu, rejestrując nazwę i skrót klawiszowy przypisany do makra.

Każde zarejestrowane makro jest zdefiniowane w całości Apps Script, więc możesz edytować je bezpośrednio w edytorze Apps Script. Możesz nawet pisać od zera w aplikacji Apps Script lub używać funkcji, które wcześniej zostały zapisane, i przekształcać je w makra.

Tworzenie makr w Apps Script

Możesz korzystać z funkcji zapisanych w Google Apps Script i używać ich jako funkcji makr. Najprostszym sposobem jest zaimportowanie istniejącej funkcji z edytora Arkuszy Google.

Możesz też utworzyć makra w edytorze Apps Script, wykonując te czynności:

  1. W interfejsie Arkuszy Google wybierz Rozszerzenia > Apps Script, aby otworzyć skrypt powiązany z arkuszem w edytorze Apps Script.
  2. Zapisz funkcję makro. Funkcje makr nie powinny przyjmować żadnych argumentów ani zwracać wartości.
  3. Edytuj plik manifestu skryptu, aby utworzyć makro i połączyć je z funkcją makra. Przypisz unikalny skrót i nazwę klawiatury.
  4. Zapisz projekt skryptu. Makro będzie wtedy dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, aby sprawdzić, czy działa ona zgodnie z oczekiwaniami.

Edytowanie makr

Makra dołączone do arkusza możesz edytować, wykonując te czynności:

  1. W interfejsie Arkuszy Google wybierz Rozszerzenia > Makra > Zarządzaj makrami
  2. Odszukaj makro, które chcesz edytować, i kliknij > Edytuj makro. Spowoduje to otwarcie edytora Apps Script w pliku zawierającym funkcję makro.
  3. Edytuj funkcję makra, aby zmienić jej działanie.
  4. Zapisz projekt skryptu. Makro będzie wtedy dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, aby sprawdzić, czy działa ona zgodnie z oczekiwaniami.

Importowanie funkcji jako makr

Jeśli do arkusza istnieje już funkcja, możesz zaimportować ją do skryptu jako nowe makro, a potem przypisać do niego skrót klawiszowy. Aby to zrobić, edytuj plik manifestu i dodaj kolejny element do właściwości sheets.macros[].

Możesz też wykonać te czynności, aby zaimportować funkcję jako makro z interfejsu Arkuszy:

  1. W interfejsie Arkuszy Google wybierz Rozszerzenia > Makra > Importuj.
  2. Wybierz postać funkcji z listy, a następnie kliknij Dodaj funkcję.
  3. Kliknij , aby zamknąć okno.
  4. Kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  5. Znajdź na liście nowo zaimportowaną funkcję. Przypisz do makra unikalny skrót klawiszowy. Tutaj możesz też zmienić nazwę makra. Domyślnie jest to nazwa funkcji.
  6. Kliknij Aktualizuj, aby zapisać konfigurację makra.

Struktura pliku manifestu dla makr

Poniższy przykładowy fragment pliku manifestu zawiera sekcję pliku manifestu, która definiuje makra Arkuszy Google. Sekcja sheets pliku manifestu określa nazwę i skrót klawiszowy przypisany do makra, a także nazwę funkcji makro.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

Szczegółowe informacje o tym, jak skonstruowane są pliki manifestu Apps Script, znajdziesz w przewodniku po strukturze plików. Sekcje Arkusze i Makraopisują pola definiujące makra Arkusze.

Sprawdzone metody

Podczas tworzenia makr w skryptach Apps Script lub zarządzania nimi należy przestrzegać poniższych wytycznych.

  1. Makra są bardziej skuteczne, jeśli są mniejsze. W miarę możliwości ograniczaj liczbę działań wykonywanych przez makro.
  2. Makra najlepiej nadają się do operacji rotacji, które trzeba często powtarzać przy niewielkiej konfiguracji lub bez niej. W innych przypadkach możesz użyć niestandardowego elementu menu.
  3. Pamiętaj, że skróty klawiszowe makr muszą być unikalne, a w danym arkuszu może znajdować się tylko 10 makr. Dodatkowe makra możesz wykonywać tylko w menu Rozszerzenia > Makra.
  4. Makra, które wprowadzają zmiany w jednej komórce, mogą być stosowane do zakresu komórek przez wybranie całego zakresu, a następnie aktywację makra. Oznacza to, że często nie ma potrzeby tworzenia makr, które powielają tę samą operację we wstępnie zdefiniowanym zakresie komórek.

Czego nie można robić

Jest kilka ograniczeń związanych z makrami:

Używanie makr spoza powiązanych skryptów

Makra definiuje się w skryptach powiązanych z określonymi Arkuszami Google. Definicje makr są ignorowane w samodzielnym skrypcie lub aplikacji internetowej.

Definiowanie makr w dodatkach do Arkuszy

Definicji makr nie można rozpowszechniać za pomocą dodatku Arkusze. Wszystkie definicje makr w projekcie dodatku do Arkuszy są ignorowane przez użytkowników tego dodatku.

Dystrybucja makr w bibliotekach skryptów

Definicji makr nie można rozpowszechniać za pomocą bibliotek Apps Script.

Używanie makr poza Arkuszami Google

Makra to funkcja dostępna tylko w Arkuszach Google, która nie istnieje w Dokumentach, Formularzach ani Prezentacjach Google.