Makra Arkuszy Google

Arkusze Google umożliwiają nagrywanie makr, które powielają określoną serię zdefiniowanych przez Ciebie interakcji z interfejsem. Po nagraniu makra możesz połączyć je ze skrótem klawiszowym w formularzu Ctrl+Alt+Shift+Number. Możesz użyć tego skrótu, aby szybko ponownie wykonać te same kroki makra, zwykle w innym miejscu lub na innych danych. Makro możesz też aktywować w menu Rozszerzenia > Makra w Arkuszach Google.

Podczas rejestrowania makra Arkusze Google automatycznie tworzą funkcję Apps Script (funkcję makra), która odtwarza kroki makra. Funkcja makra zostanie dodana do projektu Apps Script powiązanego z arkuszem w pliku o nazwie macros.gs. Jeśli do arkusza jest już przypisany plik projektu o tej nazwie, funkcja makra zostanie do niego dołączona. Arkusze Google automatycznie aktualizują też manifest projektu skryptu, zapisując nazwę i skrót klawiszowy przypisany do makra.

Każde nagrane makro jest w całości zdefiniowane w Apps Script, więc możesz je edytować bezpośrednio w edytorze Apps Script. Możesz nawet pisać makra od zera w Apps Script lub przekształcać w makra napisane już funkcje.

Tworzenie makr w Apps Script

Możesz używać funkcji napisanych w Apps Script 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. Napisz funkcję makra. Funkcje makr nie powinny przyjmować argumentów ani zwracać wartości.
  3. Edytuj plik manifestu skryptu, aby utworzyć makro i połączyć je z funkcją makra. Przypisz do niego unikalny skrót klawiszowy i nazwę.
  4. Zapisz projekt skryptu. Makro jest wtedy dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, aby sprawdzić, czy działa zgodnie z oczekiwaniami.

Edytowanie makr

Aby edytować makra dołączone do arkusza, wykonaj te czynności:

  1. W interfejsie Arkuszy Google kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  2. Znajdź makro, które chcesz edytować, i kliknij > Edytuj makro. Otworzy się edytor Apps Script z plikiem projektu zawierającym funkcję makra.
  3. Edytuj funkcję makra, aby zmienić jego działanie.
  4. Zapisz projekt skryptu. Makro jest wtedy dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, aby sprawdzić, czy działa zgodnie z oczekiwaniami.

Importowanie funkcji jako makr

Jeśli do arkusza jest już dołączony skrypt, możesz zaimportować funkcję w skrypcie jako nowe makro, a następnie przypisać do niej skrót klawiszowy. Możesz to zrobić, edytując manifest i dodając kolejny element do właściwości sheets.macros[].

Możesz też zaimportować funkcję jako makro z interfejsu Arkuszy, wykonując te czynności:

  1. W interfejsie Arkuszy Google wybierz Rozszerzenia > Makra > Importuj.
  2. Wybierz funkcję z wyświetlonej listy, a potem kliknij Dodaj funkcję.
  3. Aby zamknąć okno, kliknij .
  4. Kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  5. Odszukaj na liście funkcję, którą właśnie zaimportowano. Przypisz do makra unikalny skrót klawiszowy. Możesz też zmienić nazwę makra. Domyślnie jest to nazwa funkcji.
  6. Aby zapisać konfigurację makra, kliknij Zaktualizuj.

Struktura pliku manifestu makr

Poniższy fragment przykładowego pliku manifestu pokazuje sekcję manifestu, która definiuje makra Arkuszy Google. Sekcja sheets pliku manifestu określa nazwę i skrót klawiszowy przypisany do makra oraz nazwę funkcji makra.

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

Więcej informacji o tym, jak są tworzone pliki manifestu makr Arkuszy, znajdziesz w tym artykule.

Sprawdzone metody

Podczas tworzenia makr w Apps Script lub zarządzania nimi zalecamy przestrzeganie tych wytycznych.

  1. Makra działają lepiej, gdy są proste. W miarę możliwości ogranicz liczbę działań wykonywanych przez makro.
  2. Makra najlepiej sprawdzają się w przypadku powtarzalnych operacji, które trzeba często wykonywać przy niewielkiej lub zerowej konfiguracji. W przypadku innych operacji możesz zamiast tego użyć niestandardowego elementu menu.
  3. Pamiętaj, że skróty klawiszowe makr muszą być unikalne, a arkusz może zawierać maksymalnie 10 makr ze skrótami. Wszystkie dodatkowe makra można uruchamiać tylko z menu Rozszerzenia > Makra.
  4. Makro, które wprowadza zmiany w pojedynczej komórce, można zastosować do zakresu komórek. Aby to zrobić, najpierw zaznacz pełny zakres, a potem aktywuj makro. Oznacza to, że często nie trzeba tworzyć makr, które powielają tę samą operację w określonym zakresie komórek.

Czego nie możesz robić

Istnieje kilka ograniczeń dotyczących tego, co można zrobić za pomocą makr:

Używanie makr poza skryptami powiązanymi

Makra są zdefiniowane w skryptach powiązanych z konkretnymi Arkuszami Google. Definicje makr są ignorowane, jeśli są zdefiniowane w samodzielnym skrypcie lub aplikacji internetowej.

Definiowanie makr w dodatkach do Arkuszy

Nie możesz rozpowszechniać definicji makr za pomocą dodatku do Arkuszy. Definicje makr w projekcie dodatku do Arkuszy są ignorowane przez użytkowników tego dodatku.

Rozpowszechnianie makr w bibliotekach skryptów

Nie możesz rozpowszechniać definicji makr za pomocą bibliotek Apps Script.

Używanie makr poza Arkuszami Google

Makra są dostępne tylko w Arkuszach Google, a nie w Dokumentach, Formularzach ani Prezentacjach Google.