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. Użyj 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 Arkuszy Rozszerzenia > Makra.

Podczas rejestrowania makra Arkusze 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 o tej nazwie jest już przypisany plik projektu, funkcja makra zostanie do niego dołączona. Arkusz automatycznie aktualizuje 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 napisać makra od zera w Apps Script lub przekształcić w makra funkcje, które już masz.

Tworzenie makr w Apps Script

Funkcje napisane w Apps Script możesz wykorzystywać jako funkcje makr. Najprostszym sposobem jest zaimportowanie istniejącej funkcji z edytora Arkuszy.

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

  1. W interfejsie Arkuszy 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 mu 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:

  1. W interfejsie Arkuszy wybierz Rozszerzenia > Makra > Zarządzaj makrami.
  2. Znajdź makro, które chcesz edytować, i kliknij > Edytuj makro. Otworzy się edytor skryptów 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. Aby to zrobić, edytuj plik manifestu i dodaj 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 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. Znajdź 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 pliku manifestu pokazuje sekcję manifestu, która definiuje makra Arkuszy. Sekcja sheets pliku manifestu określa nazwę i skrót klawiszowy przypisany do makra oraz nazwę funkcji makra.

Pliki manifestu zawierają inne komponenty związane z właściwościami Apps Script. Pola pod kluczem sheets są bezpośrednio powiązane z funkcjami Arkuszy. Ten przykład to tylko fragment pełnego pliku manifestu, który nie jest w pełni funkcjonalny.

{
  ...
  "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 postępuj zgodnie z tymi wskazówkami:

  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 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. Wszelkie 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. Definicje makr są ignorowane, jeśli są zdefiniowane w samodzielnym skrypcie lub aplikacji internetowej.

Definiowanie makr w dodatkach do Arkuszy Google Workspace

Nie możesz rozpowszechniać definicji makr za pomocą dodatku do Arkuszy Google Workspace. Wszelkie 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.

Korzystanie z makr poza Arkuszami

Makra są dostępne tylko w Arkuszach i nie działają w Dokumentach Google, Formularzach ani Prezentacjach Google.