AppSheet mit Apps Script verbinden

1. Einführung

In diesem Codelab erstellen Sie ein Apps Script-Projekt namens „Hello World“ und fügen Sie dann die einfache Funktion logThis hinzu, die eine an sie übergebene Nachricht protokolliert. Dann erstellen Sie eine AppSheet-Automatisierung und rufen das Skript auf. Nachdem das Skript aufgerufen wurde, kehren Sie zum Apps Script-Editor zurück und bestätigen seine Ausführung.

Aufgaben in diesem Lab

• Apps Script-Projekt mit einer einfachen Funktion erstellen
• Hier erfahren Sie, wie Sie eine einfache AppSheet-App basierend auf einer vorhandenen Google-Tabelle erstellen.
• Anleitung zum Erstellen einer AppSheet-Automatisierung, die die Skriptfunktion aufruft.
• Prüfen, ob das Script in AppSheet erfolgreich ausgeführt wurde

Voraussetzungen

• Zugriff auf die AppSheet-Entwicklungsumgebung (appsheet.com).
• Zugriff auf Apps Script-Entwicklungsumgebung (script.google.com).

2. Apps Script-Projekt erstellen

Erstellen Sie zuerst ein Apps Script-Projekt namens „Hello World“ und fügen Sie dann die einfache Funktion logThis hinzu, die eine an sie übergebene Nachricht protokolliert.

1. Rufen Sie die Apps Script-Startseite auf und klicken Sie auf + Neues Projekt.
2. Ändern Sie den Titel des Projekts in Hello World.
3. Aktualisieren Sie das Skript im Editor wie folgt:

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

4. Klicken Sie auf Projekt speichern.

Weitere Informationen finden Sie unter Projekte erstellen und löschen.

3. AppSheet-App erstellen

Als Nächstes generieren Sie schnell eine neue AppSheet-App basierend auf einer kopierten Beispieldatei aus Google-Tabelle. Anschließend aktualisieren Sie sie, um das Apps Script-Projekt aufzurufen, das Sie zuvor erstellt haben.

1. Öffnen Sie die Tabelle Beispiel für Shirt-Bestellungen und klicken Sie dann auf Kopie erstellen, um eine Kopie herunterzuladen und in Google Tabellen zu öffnen. Wenn Sie möchten, können Sie die Tabelle umbenennen (z.B. in "Bestellungen von T-Shirts").
2. Melden Sie sich in AppSheet an.
3. Klicken Sie auf der Seite „Meine Apps“ auf + Neue App erstellen. Das Dialogfeld Neue Anwendung erstellen wird angezeigt.
4. Klicken Sie auf Mit eigenen Daten beginnen.
5. Optional: Bearbeiten Sie den Namen der App und wählen Sie eine Kategorie aus.
6. Klicken Sie auf Daten auswählen.

7. Klicken Sie auf Google, um auf Google Drive zuzugreifen.
8. Gehen Sie zur Tabelle T-Shirt-Bestellungen, die Sie zuvor kopiert haben, und wählen Sie sie aus.

AppSheet richtet Ihre App ein.

9. Klicken Sie auf App anpassen, um die App im AppSheet-Editor zu öffnen.

4. Automatisierung erstellen

Als Nächstes erstellen Sie eine AppSheet-Automatisierung und rufen das Skript auf.

1. Wählen Sie Automatisierung > Bots.
2. Klicken Sie auf + Neuer Bot.
3. Wählen Sie das erste Element in der Liste der Vorschläge aus: Senden Sie eine Benachrichtigung, wenn ein Eintrag für Shirt-Bestellungen erstellt oder aktualisiert wird.

4. Klicken Sie auf den Schritt Benachrichtigung senden, um ihn zu bearbeiten.
5. Ändern Sie den Namen in Call a script.

6. Ändern Sie unter Einstellungen den Aufgabentyp in Skript aufrufen.

7. Klicken Sie im Feld Apps Script-Projekt auf Durchsuchen (Dateisymbol).
8. Wählen Sie in Drive das Apps Script-Projekt Hello World aus.
9. Klicken Sie auf Auswählen. Wenn Sie zur Autorisierung aufgefordert werden, klicken Sie auf Autorisieren und folgen Sie den Aufforderungen.

Das Apps Script-Projekt wird hinzugefügt und im Feld Funktionsname wird eine Liste der verfügbaren Funktionen angezeigt.

10. Wählen Sie in der Liste Funktionsname den Eintrag logThis(msg) aus.

Das Feld Funktionsargumente wird angezeigt.

11. Geben Sie für das Argument msg den folgenden Ausdruck mithilfe des Ausdrucksassistenten ein: ‘Hello from AppSheet’.

12. Klicken Sie auf Speichern, um die App zu speichern.
13. Klicken Sie im Vorschaubereich auf das Symbol Mobilgerät oder Tablet, um den App-Emulator aufzurufen.

14. Fügen Sie eine neue T-Shirt-Bestellung hinzu und klicken Sie auf Speichern.
15. Klicken Sie auf Synchronisieren, um die Änderungen zu synchronisieren.

5. Ausführung von Apps Script bestätigen

Kehren Sie nach dem Aufrufen des Skripts zum Apps Script-Editor zurück und prüfen Sie die Ausführung.

1. Kehren Sie zur Apps Script-Startseite zurück und sehen Sie sich das Projekt Hello World an.
2. Klicken Sie in der Navigationsleiste auf Ausführungen, um zu bestätigen, dass die Funktion logThis erfolgreich ausgeführt wurde. Wenn das Protokoll nicht angezeigt wird, klicken Sie auf Aktualisieren.

6. Optionale zusätzliche Schritte

Als zusätzlichen Schritt in diesem Workshop sehen Sie sich das Projekt mit den Apps Script-Beispielen an und führen Sie einige Beispiele aus AppSheet aus.

Erste Schritte mit den Apps Script-Beispielen

1. Erstellen Sie dazu zuerst eine Kopie des Apps Script-Beispielprojekts.
2. Klicken Sie auf das Symbol zum Kopieren.
3. Speichern Sie das neue Projekt und klicken Sie auf Ausführen, um die Apps im Projekt zu autorisieren.

Experimentieren Sie mit einigen der Beispiele.

• createCalendarEvent() – einen neuen Kalendertermin erstellen
• createDoc(): Erstellt automatisch ein neues Dokument.
• createSheet(): Erstellt ein neues Tabellenblatt.
• createSlideDeck() – Erstellen Sie eine neue Präsentation mit einem Bild und Text.

Weitere Informationen zu dieser wichtigen Funktion