Łączenie AppSheet za pomocą Apps Script

1. Wprowadzenie

W ramach tego ćwiczenia w programie utworzysz projekt Apps Script o nazwie „Hello World”, a następnie dodasz prostą funkcję logThis, która rejestruje przekazywaną do niej wiadomość. Następnie tworzysz automatyzację Appsheet i ustawiasz ją tak, aby wywoływała skrypt. Po wywołaniu skryptu wracasz do edytora Apps Script i potwierdzasz jego wykonanie.

Czego się nauczysz

  • Jak utworzyć projekt Apps Script za pomocą prostej funkcji.
  • 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 z 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 przekazywaną do niej wiadomość.

  1. Otwórz stronę główną Apps Script i kliknij + Nowy projekt.
  2. Zmień tytuł projektu na Hello World. Okno 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łać wcześniej utworzony projekt Apps Script.

  1. Otwórz arkusz Przykład zamówienia koszulki, 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 aplikacji kliknij „Wybierz dane”.

  1. Kliknij google, aby uzyskać dostęp do Dysku Google.
  2. Przejdź do skopiowanego wcześniej arkusza kalkulacyjnego Zamówienia koszulek i go wybierz.

AppSheet skonfiguruje Twoją aplikację. Początkowy 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 ustaw ją tak, aby wywoływała skrypt.

  1. Kliknij Automatyzacja > Boty.
  2. Kliknij + Nowy bot.
  3. Wybierz pierwszy element na liście sugestii: Gdy zostanie utworzony lub zaktualizowany rekord Zamówienie koszul, wyślij powiadomienie.

5037cdd726e326e9.png

  1. Kliknij krok Wyślij powiadomienie, aby go edytować.
  2. Zmień nazwę na Call a script.

Kroki automatyzacji wywołujące skrypt.

  1. W sekcji Ustawienia zmień typ zadania na Wywołanie skryptu.

Wybranie w ustawieniach automatyzacji typu zadania „Wywołanie skryptu”.

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

Dodawany jest projekt Apps Script, a pole Nazwa funkcji jest wypełniane listą dostępnych funkcji.

  1. Z listy Nazwa funkcji wybierz logThis(msg). Wybierz z menu funkcję „logThis()” Apps Script.

Pojawi się pole Argumenty funkcji.

  1. W argumencie msg użyj tego wyrażenia za pomocą narzędzia Expression Assistant: ‘Hello from AppSheet’

Dodaję argumenty do wywołania funkcji Apps Script.

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

68471f4646fc8fbe.png

  1. Dodaj nowe zamówienie koszul i kliknij Zapisz.
  2. Kliknij Synchronizuj, aby zsynchronizować zmiany.

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

5. Potwierdź wykonanie skryptu Apps Script

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

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

Wyświetlanie dzienników wykonania w środowisku edytora Apps Script w celu sprawdzenia, czy funkcja została wykonana z wywołania AppSheet.

6. Opcjonalne dodatkowe kroki

Dodatkowym krokiem w tym warsztatie jest omówienie projektu Apps Script Example i uruchomienie kilku przykładów z AppSheet.

Pierwsze kroki z przykładami Apps Script

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

Eksperymentuj z kilkoma przykładami

  • createCalendarEvent() – utwórz nowe wydarzenie w Kalendarzu.
  • createDoc() – automatyczne tworzenie nowego dokumentu.
  • createSheet() – utwórz nowy arkusz.
  • createSlideDeck() – utwórz nową prezentację slajdów, używając obrazu i tekstu.

Więcej informacji o tej ważnej funkcji znajdziesz w artykule Wywoływanie Apps Script z automatyzacji, który zawiera szczegółowy opis, film z funkcją, samouczki i projekt Apps Script do skopiowania, w którym znajdziesz wiele przykładów działania AppSheet i Apps Script.