Makra Arkuszy Google

Arkusze Google umożliwiają rejestrowanie makr, które powielają określoną przez Ciebie serię interakcji w interfejsie. Po zarejestrowaniu makra możesz połączyć je ze skrótem klawiszowym w postaci Ctrl+Alt+Shift+Number. Możesz użyć tego skrótu, by szybko wykonać dokładnie te same działania makro, zwykle w innym miejscu lub na innych danych. Makro możesz też włączyć w menu Rozszerzenia > Makra w Arkuszach Google.

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

Ponieważ każde zarejestrowane makro jest w całości zdefiniowane w Apps Script, możesz je edytować bezpośrednio w edytorze Apps Script. Możesz nawet pisać makra od zera w Apps Script lub wykorzystać napisane już funkcje i przekształcić je w makra.

Tworzenie makr w Apps Script

Możesz wykorzystać funkcje napisane w Apps Script i używać ich jako funkcji makr. Najprostszy sposób to zaimportowanie istniejącej funkcji z edytora Arkuszy Google.

Makra możesz też tworzyć w edytorze Apps Script, wykonując te czynności:

  1. W interfejsie Arkuszy Google wybierz Rozszerzenia > Apps Script, aby w edytorze Apps Script otworzyć skrypt powiązany z arkuszem.
  2. Napisz funkcję makra. Funkcje makr nie powinny przyjmować żadnych argumentów i zwracać żadnych wartości.
  3. Edytuj plik manifestu skryptu, aby utworzyć makro i połączyć je z jego funkcją. Przypisz mu unikalny skrót klawiszowy i nazwę.
  4. Zapisz projekt skryptu. Następnie makro jest dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, by sprawdzić, czy działa prawidłowo.

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. Znajdź makro, które chcesz edytować, i kliknij > Edytuj makro. Spowoduje to otwarcie edytora Apps Script do pliku projektu zawierającego funkcję makra.
  3. Zmodyfikuj funkcję makra, aby zmienić jej działanie.
  4. Zapisz projekt skryptu. Następnie makro jest dostępne do użycia w arkuszu.
  5. Przetestuj funkcję makra w arkuszu, by sprawdzić, czy działa prawidłowo.

Importowanie funkcji jako makr

Jeśli skrypt jest już powiązany z arkuszem, możesz import funkcję w skrypcie jako nowe makro, a potem przypisać do niej skrót klawiszowy. Możesz to zrobić, edytując plik manifestu i dodając 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 kliknij Rozszerzenia > Makra > Importuj.
  2. Wybierz funkcję z wyświetlonej listy, a potem kliknij Dodaj funkcję.
  3. Aby zamknąć okno, wybierz .
  4. Kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  5. Znajdź na liście funkcję zaimportowaną przed chwilą. Przypisz do makra unikalny skrót klawiszowy. W tym miejscu możesz też zmienić nazwę makra. Domyślnie jest to nazwa funkcji.
  6. Aby zapisać konfigurację makra, kliknij Aktualizuj.

Struktura pliku manifestu dla makr

Poniższy przykładowy fragment kodu w pliku manifestu pokazuje sekcję manifestu definiującego makra Arkuszy Google. Sekcja sheets pliku manifestu zawiera nazwę i skrót klawiszowy przypisane 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 tworzeniu plików manifestu makr Arkuszy znajdziesz w zasobach dotyczących pliku manifestu makr Arkuszy.

Sprawdzone metody

Podczas tworzenia makr w Apps Script i zarządzania nimi zalecamy przestrzeganie podanych niżej wskazówek.

  1. Makra są bardziej wydajne, gdy są lekkie. Gdy tylko jest to możliwe, ogranicz liczbę działań wykonywanych przez makro.
  2. Makra najlepiej nadają się do wykonywania operacji rotacji, które trzeba często powtarzać przy niewielkiej konfiguracji lub bez konfiguracji. Jeśli chcesz wykonywać inne czynności, możesz zamiast nich użyć elementu menu niestandardowego.
  3. Zawsze pamiętaj, że skróty klawiszowe makr muszą być unikalne, a dany arkusz może mieć maksymalnie 10 makr ze skrótami naraz. Dodatkowe makra można uruchamiać tylko z menu Rozszerzenia > Makra.
  4. Makra, które wprowadzają zmiany w pojedynczej komórce, można zastosować do zakresu komórek. Najpierw wybierz pełny zakres, a następnie aktywuj makro. Oznacza to, że często nie ma potrzeby tworzenia makr, które powielają tę samą operację we wstępnie zdefiniowanym zakresie komórek.

Rzeczy, których nie można robić

Jest kilka ograniczeń dotyczących tego, co możesz robić z makrami:

Używanie makr spoza powiązanych skryptów

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

Definiowanie makr w dodatkach do Arkuszy

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

Rozpowszechnianie 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 i nie ma jej w Dokumentach, Formularzach ani Prezentacjach Google.