Łączenie AppSheet za pomocą Apps Script

1. Wprowadzenie

W tym samouczku utworzysz projekt Apps Script o nazwie „Hello World”, a następnie dodasz prostą funkcję logThis, która rejestruje przekazaną do niej wiadomość. Następnie utwórz automatyzację AppSheet i spraw, aby wywoływała skrypt. Po wywołaniu skryptu wrócisz do edytora skryptów Apps Script i potwierdzisz jego wykonanie.

Czego się nauczysz

  • Jak utworzyć projekt Apps Script z prostą funkcją.
  • Jak utworzyć prostą aplikację AppSheet na podstawie istniejącego arkusza Google.
  • Jak utworzyć automatyzację AppSheet, która wywołuje funkcję skryptu.
  • Jak sprawdzić, czy skrypt został pomyślnie wykonany w AppSheet.

Czego potrzebujesz

  • Dostęp do środowiska programistycznego AppSheet (appsheet.com).
  • Dostęp do środowiska programistycznego Apps Script (script.google.com).

2. Tworzenie projektu Apps Script

Najpierw utwórz projekt Apps Script o nazwie „Hello World”, a następnie dodaj prostą funkcję logThis, która rejestruje przekazaną do niej wiadomość.

  1. Otwórz stronę główną Apps Script, a potem kliknij + Nowy projekt.
  2. Zmień tytuł projektu na Hello World. Okno dialogowe Zmień nazwę projektu z nową nazwą..
  3. Zaktualizuj skrypt w edytorze w ten sposób:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Kliknij Zapisz projekt.

Więcej informacji znajdziesz w artykule Tworzenie i usuwanie projektów.

3. Tworzenie aplikacji AppSheet

Następnie szybko wygenerujesz nową aplikację AppSheet na podstawie skopiowanego przykładowego arkusza Google, a potem zaktualizujesz ją, aby wywoływała utworzony wcześniej projekt Apps Script.

  1. Otwórz arkusz kalkulacyjny Przykładowe zamówienia koszulek, a następnie kliknij Utwórz kopię, aby pobrać i otworzyć kopię w Arkuszach Google. W razie potrzeby możesz zmienić nazwę arkusza kalkulacyjnego (np. „Zamówienia koszulek”).
  2. Zaloguj się w AppSheet.
  3. Na stronie Moje aplikacje kliknij + Utwórz nową aplikację. Wyświetli się okno Utwórz nową aplikację.
  4. Kliknij Zacznij od własnych danych. Okno tworzenia nowej aplikacji.
  5. Opcjonalnie zmień nazwę aplikacji i wybierz kategorię.
  6. Kliknij Wybierz dane.

W oknie tworzenia nowej aplikacji kliknij „Wybierz dane”.

  1. Kliknij google, aby otworzyć Dysk Google.
  2. Otwórz arkusz kalkulacyjny Shirt Orders, który został wcześniej skopiowany.

AppSheet skonfiguruje aplikację. Początkowe okno podglądu wygenerowanej aplikacji.

  1. Kliknij Dostosuj aplikację, aby otworzyć aplikację w edytorze AppSheet.

4. Utwórz automatyzację

Następnie utwórz automatyzację AppSheet i spraw, aby wywoływała skrypt.

  1. Wybierz Automatyzacja > Boty.
  2. Kliknij + Nowy bot.
  3. Wybierz pierwszy element na liście sugestii: When a Shirt Orders record is created or updated, send a notification. (Gdy rekord zamówień koszulek zostanie utworzony lub zaktualizowany, wyślij powiadomienie).

5037cdd726e326e9.png

  1. Aby edytować krok, kliknij Wyślij powiadomienie.
  2. Zmień nazwę na Call a script.

Kroki automatyzacji wywołujące skrypt.

  1. W sekcji Ustawienia zmień typ zadania na Wywołaj skrypt.

Wybierz typ zadania „Wywołaj skrypt” w ustawieniach automatyzacji.

  1. W polu Projekt Apps Script kliknij Przeglądaj (ikona pliku).
  2. Otwórz projekt Apps Script Hello World na Dysku.
  3. Kliknij Wybierz, a jeśli pojawi się prośba o autoryzację, kliknij Autoryzuj i postępuj zgodnie z instrukcjami.

Projekt Apps Script zostanie dodany, a pole Nazwa funkcji zostanie wypełnione listą dostępnych funkcji.

  1. Z listy Nazwa funkcji wybierz logThis(msg). Wybieranie funkcji Apps Script „logThis()” w menu.

Wyświetli się pole Argumenty funkcji.

  1. W argumencie msg wpisz to wyrażenie za pomocą Asystenta wyrażeń: „Hello from AppSheet”.

Dodawanie argumentów do wywołania funkcji Apps Script.

  1. Aby zapisać aplikację, kliknij Zapisz.
  2. W panelu podglądu kliknij ikonę telefonu komórkowego lub tabletu, aby wyświetlić emulator aplikacji.

68471f4646fc8fbe.png

  1. Dodaj nowe zamówienie koszulki i kliknij Zapisz.
  2. Aby zsynchronizować zmiany, kliknij Synchronizuj.

Kliknij ikonę synchronizacji w prawym górnym rogu panelu podglądu, aby zsynchronizować dane ze źródłem danych.

5. Potwierdzanie wykonania skryptu Apps Script

Po wywołaniu skryptu wróć do edytora skryptów Apps Script i potwierdź jego wykonanie.

  1. Wróć na stronę główną Apps Script i wyświetl projekt Hello World.
  2. Na pasku nawigacyjnym kliknij Wykonania, aby sprawdzić, czy funkcja logThis została wykonana. Jeśli log nie pojawił się, kliknij Odśwież.

Wyświetlanie dzienników wykonania w środowisku edytora skryptów Apps Script w celu sprawdzenia wykonania funkcji z wywołania AppSheet.

6. Opcjonalne dodatkowe czynności

Dodatkowo w ramach tego warsztatu przejrzyj projekt Przykłady Apps Script i uruchom niektóre przykłady z AppSheet.

Pierwsze kroki z przykładami Apps Script

  1. Na początek utwórz kopię projektu z przykładami skryptów Apps Script.
  2. Kliknij ikonę kopiowania.
  3. Zapisz nowy projekt i kliknij Uruchom, aby autoryzować aplikacje w projekcie.

Wypróbuj kilka przykładów

  • createCalendarEvent() – Utwórz nowe wydarzenie w Kalendarzu.
  • createDoc() – automatyczne tworzenie nowego dokumentu.
  • createSheet() – tworzenie nowego arkusza.
  • createSlideDeck() – tworzenie nowej prezentacji na podstawie obrazu i tekstu.

Więcej informacji o tej ważnej funkcji znajdziesz w artykule Wywoływanie Apps Script z automatyzacji, w którym znajdziesz szczegółowe omówienie, film z prezentacją funkcji, samouczki i projekt Apps Script, który można skopiować i który zawiera wiele działających przykładów AppSheet i Apps Script.