Łączenie AppSheet za pomocą Apps Script

1. Wprowadzenie

W ramach tego ćwiczenia w programie utworzysz projekt Apps Script o nazwie „Hello World” a potem dodać prostą funkcję logThis, która rejestruje przekazywaną do niej wiadomość. Następnie tworzysz automatyzację Appsheet i powodujesz jej wywołanie skryptu. Po wywołaniu skryptu możesz wrócić do edytora Apps Script i potwierdzić 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 będzie wywoływać funkcję skryptu.
• Jak sprawdzić, czy skrypt został poprawnie 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 potem dodać 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.
3. Zaktualizuj skrypt w edytorze w ten sposób:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. Kliknij Save project (Zapisz projekt).

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

3. Tworzenie aplikacji AppSheet

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

1. Otwórz arkusz kalkulacyjny Przykładowe zamówienie na koszul i kliknij Utwórz kopię, aby pobrać i otworzyć kopię pliku w Arkuszach Google. W razie potrzeby możesz zmienić nazwę arkusza kalkulacyjnego (np. „Zamówienia na koszulki”).
2. Zaloguj się w AppSheet.
3. Na stronie Moje aplikacje kliknij + Utwórz nową aplikację. Pojawi się okno Utwórz nową aplikację.
4. Kliknij Zacznij z własnymi danymi.
5. Opcjonalnie zmień nazwę aplikacji i wybierz kategorię.
6. Kliknij Wybierz dane.

7. Kliknij google, aby uzyskać dostęp do Dysku Google.
8. Przejdź do skopiowanego wcześniej arkusza kalkulacyjnego Zamówienia na koszul i wybierz go.

AppSheet skonfiguruje Twoją aplikację.

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

4. Utwórz automatyzację

Następnie tworzysz automatyzację Appsheet i prosisz o wywołanie skryptu.

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.

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

6. W sekcji Ustawienia zmień typ zadania na Wywoływanie skryptu.

7. W polu Apps Script Project (Projekt Apps Script) kliknij Przeglądaj (ikona pliku).
8. Przejdź do i wybierz na Dysku projekt Apps Script Hello World.
9. Kliknij Wybierz, a jeśli pojawi się prośba o autoryzację, kliknij Autoryzuj i postępuj zgodnie z wyświetlanymi instrukcjami.

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

10. Wybierz logThis(msg) z listy Nazwa funkcji.

Pojawi się pole Argumenty funkcji.

11. W przypadku argumentu msg wpisz następujące wyrażenie przy użyciu Asystenta wyrażeń: „Cześć z AppSheet”

12. Kliknij Zapisz, aby zapisać aplikację.
13. W panelu podglądu kliknij ikonę urządzenia mobilnego lub tabletu, by wyświetlić emulator aplikacji.

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

5. Potwierdź wykonanie Apps Script

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

1. Wróć na stronę główną Apps Script i wyświetl projekt Hello World.
2. Kliknij Uruchomienia na pasku nawigacyjnym, aby sprawdzić, czy funkcja logThis została wykonana. Jeśli dziennik się nie wyświetlił, kliknij Refresh (Odśwież).

6. Opcjonalne kroki dodatkowe

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. Zacznij od utworzenia kopii przykładowego projektu Apps Script.
2. Kliknij ikonę kopiowania.
3. Zapisz nowy projekt i kliknij Uruchom, aby autoryzować zawarte w nim aplikacje.

Eksperymentuj z kilkoma przykładami

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

Więcej informacji o tej ważnej funkcji znajdziesz w artykule na temat wywoływania aplikacji Apps Script z automatyzacji, który zawiera szczegółowy opis, filmy, samouczki oraz dostępny do skopiowania projekt Apps Script zawierający wiele przykładów działania AppSheet-Apps Script.