Makra Arkuszy Google

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

Gdy rejestrujesz makro, Arkusze Google automatycznie tworzą funkcję Apps Script (makro), która powiela kroki makra. Funkcja makra 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ć makro od podstaw w Apps Script lub przekształcać już zapisane funkcje w makra.

Tworzenie makr w Apps Script

Funkcje zapisane w Apps Script możesz używać jako funkcji makr. Najprostszy sposób to zaimportowanie istniejącej funkcji z edytora Arkuszy Google.

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

  1. W interfejsie Arkuszy Google kliknij Rozszerzenia > Apps Script, aby otworzyć skrypt powiązany z arkuszem w edytorze Apps Script.
  2. Napisz funkcję makra. Funkcje makro nie powinny przyjmować żadnych argumentów ani zwracać żadnych wartości.
  3. Zmień plik z manifestem 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 ona zgodnie z oczekiwaniami.

Edytowanie makr

Makra dołączone do arkusza możesz edytować w ten sposób:

  1. W interfejsie Arkuszy Google kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  2. Odszukaj makro, które chcesz edytować, i kliknij > Edytuj makro. Otworzy się edytor Apps Script z pliku projektu zawierającego funkcję makro.
  3. Aby zmienić działanie makra, zmodyfikuj funkcję makra.
  4. Zapisz projekt skryptu. Makro jest wtedy 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 arkuszami, możesz import funkcję ze skryptu jako nowe makro, a następnie przypisać mu skrót klawiszowy. Możesz to zrobić, edytując plik manifestu i dodając kolejny element do właściwości sheets.macros[].

Aby zaimportować funkcję jako makro z interfejsu Sheets, wykonaj te czynności:

  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ę, którą właśnie zaimportowałeś. Przypisz do makra unikalny skrót klawiszowy. Tutaj możesz też zmienić nazwę makra. Domyślnie jest to nazwa funkcji.
  6. Aby zapisać konfigurację makra, kliknij Zaktualizuj.

Struktura pliku manifestu dla makr

Poniższy przykładowy fragment pliku manifestu pokazuje sekcję manifest, która definiuje makr w Arkuszach Google. Sekcja sheets w pliku manifestu definiuje 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 tworzeniu plików manifestu makr Arkuszy znajdziesz w zasobach dotyczących pliku manifestu makr Arkuszy.

Sprawdzone metody

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

  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 rutynowych operacji, które trzeba często powtarzać, bez konieczności konfiguracji lub z minimalną konfiguracją. W przypadku innych operacji możesz użyć niestandardowego elementu menu.
  3. Pamiętaj, że skróty klawiszowe makr muszą być unikalne, a w arkuszu kalkulacyjnym może być jednocześnie tylko 10 makr z skrótami. Dodatkowe makro można uruchomić tylko z menu Rozszerzenia > Makro.
  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 trzeba tworzyć makr, które powielają tę samą operację w ramach zdefiniowanego zakresu komórek.

Czego nie możesz robić

Istnieją pewne ograniczenia dotyczące tego, co można robić za pomocą makr:

Używanie makr poza skryptami

Makra są definiowane w skryptach powiązanych z określonymi Arkuszami Google. Definicje makro 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. Użytkownicy dodatku ignorują definicje makr w projekcie dodatku do Arkuszy.

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