Makra Arkuszy Google

Arkusze Google umożliwiają nagrywanie makr, które powielają określoną przez Ciebie serię zdefiniowanych przez Ciebie interakcji z interfejsem. Po nagraniu makro możesz połączyć je 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.

Podczas nagrywania makra Arkusze Google automatycznie tworzą funkcję Apps Script (funkcję makra), która odtwarza kroki makra. Funkcja makra jest dodawana 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 makr zostanie do niego dodana. Arkusze Google automatycznie aktualizują też manifest projektu skryptu, zapisując nazwę i skrót klawiszowy przypisane do makra.

Każde nagrane makro jest zdefiniowane w ramach Apps Script, więc 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. Najłatwiej to zrobić, importując istniejącą funkcję 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ę makro. 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, aby sprawdzić, czy działa zgodnie z oczekiwaniami.

Importowanie funkcji jako makr

Jeśli skrypt jest już powiązany z arkuszami, możesz import funkcję w skrypcie jako nowe makro, a następnie przypisać mu skrót klawiszowy. Aby to zrobić, edytuj plik manifestu i dodaj do właściwości sheets.macros[] kolejny element.

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 listy, a potem kliknij Dodaj funkcję.
  3. Kliknij , aby zamknąć okno.
  4. Kliknij Rozszerzenia > Makra > Zarządzaj makrami.
  5. Odszukaj 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 w przypadku 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 tym, jak tworzyć pliki z makro w Arkuszach, znajdziesz w zasobie z plikiem z makrem w Arkuszach.

Sprawdzone metody

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

  1. Makra są bardziej wydajne, gdy są lekkie. W miarę możliwości 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 stosować do zakresu komórek. Aby to zrobić, zaznacz cały zakres, a potem 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.