Google Tabellen ist eine cloudbasierte Tabellenkalkulationslösung, die die Zusammenarbeit in Echtzeit unterstützt und Tools für die zum Visualisieren, Verarbeiten und Kommunizieren von Daten.
In diesem Tutorial wird gezeigt, wie Sie Workflows Google Tabellen.
Lernziele
In dieser Anleitung wird Folgendes beschrieben:
- Verwenden Sie Google Formulare, ein cloudbasiertes und Umfragelösung, um ein Formular zu erstellen, über das VM-Instanzen erstellen können.
- Verknüpfen Sie eine Google Tabellen-Tabelle mit dem Formular, um Antworten zu erfassen und zu speichern.
- Verwenden Sie Google Apps Script, ein cloudbasierte JavaScript-Plattform nutzen, mit der Sie und Google Workspace-Produkte bearbeiten, um bei jeder Anfrage durch eine Aktualisierung der Tabelle genehmigt wird.
- Stellen Sie einen Workflow bereit, der den Compute Engine API-Connector aufruft und eine Compute Engine-VM-Instanz basierend auf den über das Formular erfassten Spezifikationen erstellt. Connectors vereinfachen das Aufrufen anderer Google Cloud-Dienste APIs Weitere Informationen zu Workflow-Connectors
- Testen Sie den gesamten Prozess und prüfen Sie, ob eine VM-Instanz wie erwartet erstellt wird.
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
In dieser Anleitung wird auch Google Workspace verwendet. Dienste für Unternehmen, die in den kostenlosen Google-Apps nicht enthalten sind, sind kostenpflichtig.
Hinweis
Einige der folgenden Befehle können Sie in der Google Cloud Console oder über die Google Cloud CLI in Ihrem Terminal oder in Cloud Shell ausführen.
Von Ihrer Organisation definierte Sicherheitsbeschränkungen verhindern möglicherweise, dass die folgenden Schritte ausgeführt werden. Informationen zur Fehlerbehebung finden Sie unter Anwendungen in einer eingeschränkten Google Cloud-Umgebung entwickeln.
Console
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
Aktivieren Sie die Compute Engine API und die Workflows API.
Notieren Sie sich das Compute Engine-Standarddienstkonto, da Sie es zu Testzwecken mit dem Workflow in dieser Anleitung verknüpfen. Neue Projekte, für die die Compute Engine API aktiviert ist dieses Dienstkonto mit der IAM-Basisversion Bearbeiterrolle mit folgendem E-Mail-Format:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Ihre Projektnummer finden Sie auf der Willkommen Seite der Google Cloud Console.
Für Produktionsumgebungen empfehlen wir dringend, Erstellen eines neuen Dienstkontos und und ihm eine oder mehrere IAM-Rollen zuweisen, die den Erforderliche Mindestberechtigungen und folgen dem Prinzip der geringste Berechtigung:
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
Aktivieren Sie die Compute Engine API und die Workflows API.
gcloud services enable \ compute.googleapis.com \ workflows.googleapis.com
Notieren Sie sich die Compute Engine-Standarddienstkonto da Sie es mit dem Workflow in dieser Anleitung verknüpfen, zu verstehen. Neue Projekte, für die die Compute Engine API aktiviert ist dieses Dienstkonto mit der IAM-Basisversion Bearbeiterrolle mit folgendem E-Mail-Format:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
So rufen Sie Ihre Projektnummer ab:
gcloud projects describe PROJECT_ID
Für Produktionsumgebungen empfehlen wir dringend, ein neues Dienstkonto zu erstellen und ihm eine oder mehrere IAM-Rollen zuzuweisen, die die erforderlichen Mindestberechtigungen enthalten und dem Grundsatz der geringsten Berechtigung folgen.
Formular zum Anfordern von VM-Instanzen erstellen
Erstellen Sie ein Formular, mit dem eine Anfrage zum Erstellen einer Compute Engine-VM-Instanz gesendet werden kann. Wenn Sie ein Formular über Google Formulare erstellen, Google Drive
- Rufen Sie forms.google.com auf.
- Klicken Sie auf Leere Vorlage .
Ein neues Formular wird geöffnet.
- Erstellen Sie ein Formular mit fünf Pflichtfeldern. Das Formular sollte ähnlich aussehen,
zu:
Beispielformular ansehen
Computername Kurzantworttext
Zone Drop-down-Menü:
- us-central1-a
- us-central1-b
- us-central1-c
- us-central1-f
Typ Drop-down-Menü:
- e2-micro
- e2-small
- e2-medium
- e2-standard-2
- e2-standard-4
Laufwerksgröße (GB) Kurzantworttext
Betriebssystem Drop-down-Menü:
- debian-10
- centos-stream-9
- cos-93-lts
- cos-97-lts
- Aktivieren Sie die E-Mail-Erfassung, um die E-Mail-Adressen der Personen zu erfassen, die Ihr Formular ausfüllen:
- Klicken Sie auf Einstellungen.
- Maximieren Sie den Bereich Antworten.
- Klicken Sie auf die Ein/Aus-Schaltfläche E-Mail-Adressen erfassen.
Tabelle mit Formular verknüpfen
Nachdem Sie ein Formular erstellt haben, verknüpfen Sie es mit einer Tabelle, damit Sie die Formularantworten in dieser Tabelle speichern können. Die Tabelle wird gespeichert in Google Drive
- Öffnen Sie Ihr Formular in Google Formulare.
- Klicken Sie auf Antworten.
- Klicken Sie auf Mit Google Tabellen verknüpfen.
- Wählen Sie im Dialogfeld Ziel für Antworten auswählen die Option Neu erstellen Tabelle.
Klicken Sie auf Erstellen.
Die verknüpfte Tabelle wird geöffnet.
Fügen Sie in Spalte H die Überschrift Genehmigt? ein.
Platzieren Sie den Cursor in der ersten Zeile von Spalte H und wählen Sie Einfügen > Kästchen.
Die Tabelle sollte in etwa so aussehen:
Jedes Mal, wenn die Tabelle mit einer Antwort aktualisiert wird, wird das Kästchen auch in der Zeile für diese Antwort angezeigt.
Google Tabellen mit Apps Script erweitern
Mit Apps Script können Sie Inhalte programmatisch erstellen, lesen und bearbeiten Google Tabellen. Die meisten Scripts für Google Tabellen bearbeiten Arrays, um mit den Zellen, Zeilen und Spalten in einer Tabelle zu interagieren. Eine Einführung in die Verwendung von Apps Script in Google Tabellen finden Sie in der Kurzanleitung für benutzerdefinierte Funktionen.
So erstellen Sie ein Apps Script-Projekt über Google Tabellen:
- Öffnen Sie die Google Tabellen-Tabelle.
- Wählen Sie Erweiterungen > Apps Script aus.
- Klicken Sie im Script-Editor auf Unbenanntes Projekt.
- Geben Sie Ihrem Projekt einen Namen und klicken Sie auf Umbenennen.
Das Skript ist jetzt mit Ihrer Tabelle verbunden. mit der das Skript die Benutzeroberfläche oder wenn die Tabelle geöffnet wird.
Ein Skriptprojekt repräsentiert eine Sammlung von Apps Script Dateien und Ressourcen. Codedateien in einem Scriptprojekt haben die Erweiterung
.gs
.Mit Apps Script können Sie benutzerdefinierte Funktionen schreiben, die in Google Tabellen genauso wie eine integrierte Funktion verwendet werden kann. Benutzerdefinierte Funktionen sind die mit Standard-JavaScript erstellt wurden. Erstellen Sie eine Funktion:
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie auf Bearbeiter .
- Eine Skriptdatei wird als Projektdatei mit dem Namen
Code.gs
angezeigt. Wählen Sie die Datei aus, um sie zu bearbeiten. Ersetzen Sie den gesamten Code im Script-Editor durch den folgenden Code, der die Daten in Ihrer Tabelle liest und als Eingabe an die Workflowausführung weitergibt:
Ersetzen Sie
your-project-id
durch Ihre Google Cloud-Projekt-ID.Sie finden Ihre Projekt-ID auf der Willkommensseite der Google Cloud Console.
Klicken Sie auf „Speichern“
.
Mit installierbaren Triggern in Apps Script kann in einem Scriptprojekt eine bestimmte Funktion ausgeführt werden, wenn bestimmte Bedingungen erfüllt sind, z. B. wenn eine Tabelle geöffnet oder bearbeitet wird. So erstellen Sie einen Trigger:
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie auf Trigger .
- Klicken Sie auf Trigger hinzufügen.
- Konfigurieren Sie im Dialogfeld Trigger für YOUR_PROJECT_NAME den
Trigger:
- Wählen Sie in der Liste Auszuführende Funktion auswählen die Option handleEdit aus.
- Wählen Sie in der Liste Auswählen, welche Bereitstellung ausgeführt werden soll die Option Head aus.
- Wählen Sie in der Liste Ereignisquelle auswählen die Option Aus Tabelle aus.
- Wählen Sie in der Liste Ereignistyp auswählen die Option Beim Bearbeiten aus.
- Wählen Sie in der Liste Benachrichtigungseinstellungen bei Fehlern die Option Täglich benachrichtigen aus.
- Klicken Sie auf Speichern.
Wenn Sie aufgefordert werden, ein Google-Konto auszuwählen, wählen Sie das entsprechende Konto aus und klicken Sie dann auf Zulassen.
So kann Ihr Apps Script-Projekt Tabellen in Google Tabellen erstellen und löschen, und eine Verbindung zu einem externen Dienst.
Eine Manifestdatei eines Apps Script-Projekts ist eine JSON-Datei mit grundlegenden Projektinformationen, Apps Script muss ein Script erfolgreich ausführen. Im Apps Script-Editor werden Manifestdateien standardmäßig ausgeblendet, um die Einstellungen Ihres Apps Script-Projekts zu schützen. Bearbeiten Sie die Manifestdatei:
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie auf Projekteinstellungen .
- Aktivieren Sie das Kontrollkästchen "appsscript.json" anzeigen Manifestdatei im Editor an.
- Klicken Sie auf Bearbeiter .
- Die Manifestdatei wird als Projektdatei mit dem Namen
appsscript.json
angezeigt. Wählen Sie die Datei aus, um sie zu bearbeiten. Im Feld
oauthScopes
wird ein Array von Strings angegeben. Wenn Sie die Autorisierungsbereiche festlegen möchten, die in Ihrem Projekt verwendet werden, fügen Sie ein Array mit den Bereichen hinzu, die unterstützt werden sollen. Beispiel:{ "timeZone": "America/Toronto", "dependencies": { }, "exceptionLogging": "STACKDRIVER", "runtimeVersion": "V8", "oauthScopes": [ "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/spreadsheets" ] }
Dadurch werden explizite Bereiche festgelegt auf:
- Verbindung mit externem Dienst herstellen
- Google Cloud-Daten abrufen, bearbeiten, konfigurieren und löschen sowie die E-Mail-Adresse Ihres Google-Kontos
- Alle Ihre Google Tabellen aufrufen, bearbeiten, erstellen oder löschen
Klicken Sie auf „Speichern“
.
Workflow bereitstellen, der eine VM-Instanz erstellt
Einen Workflow bereitstellen, der ausgelöst wird, wenn eine Anfrage zum Erstellen einer VM-Instanz genehmigt wird. Der Workflow ruft die Methode Compute Engine API-Connector zum Erstellen einer Compute Engine-VM-Instanz basierend auf den Spezifikationen die über das Formular erfasst wurden.
Console
Öffnen Sie in der Google Cloud Console die Seite Workflows.
Klicken Sie auf
Erstellen.Geben Sie einen Namen für den neuen Workflow ein:
create-vm-from-form
.Wählen Sie in der Liste Region die Option us-central1 (Iowa) aus.
Wählen Sie für das Dienstkonto die Compute Engine-Standardeinstellung aus. Dienstkonto (
PROJECT_NUMBER-compute@developer.gserviceaccount.com
).Klicken Sie auf Weiter.
Geben Sie im Workflow-Editor die Definition für Ihren Workflow ein:
Klicken Sie auf Bereitstellen.
gcloud
Erstellen Sie eine Quellcodedatei für Ihren Workflow:
touch create-vm-from-form.yaml
Kopieren Sie in einem Texteditor den folgenden Workflow in Ihre Quellcodedatei:
Stellen Sie den Workflow bereit. Geben Sie hierzu den folgenden Befehl ein:
gcloud workflows deploy create-vm-from-form \ --source=create-vm-from-form.yaml \ --location=us-central1 \ --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
Ersetzen Sie
PROJECT_NUMBER
durch Ihre Google Cloud-Projektnummer. So rufen Sie Ihre Projektnummer ab:gcloud projects describe PROJECT_ID
End-to-End-Ablauf testen
Führen Sie den gesamten Vorgang aus, um zu prüfen, ob alles wie erwartet funktioniert.
Senden Sie das Formular an sich selbst und beantworten Sie die Fragen entsprechend.
Die Spezifikationen, die Sie zum Erstellen einer VM-Instanz verwenden, müssen gültig sein. Andernfalls schlägt die Workflowausführung fehl. Weitere Informationen finden Sie unter Compute Engine-Maschinenfamilie für allgemeine Zwecke.
Klicken Sie auf Senden, um Ihre Antwort zu senden.
Öffnen Sie Ihr Formular in Google Formulare.
Klicken Sie auf Antworten.
Klicken Sie auf In Google Tabellen ansehen.
Die verknüpfte Tabelle wird geöffnet.
Klicken Sie in der Zeile für Ihre Antwort das Kästchen Genehmigt? an.
Öffnen Sie Ihr Apps Script-Projekt.
Klicken Sie auf Ausführungen
.Der Trigger sollte ausgeführt und mit dem Status
Completed
aufgeführt werden.Prüfen Sie, ob der
create-vm-from-form
-Workflow erfolgreich abgeschlossen wurde:Console
Öffnen Sie in der Google Cloud Console die Seite Workflows.
Klicken Sie auf der Seite Workflows auf das create-vm-from-form, um die zugehörige Detailseite aufzurufen.
Klicken Sie auf der Seite Workflow-Details auf die entsprechende Ausführungs-ID, um die Details für eine bestimmte Ausführung abzurufen.
Der Ausführungsstatus sollte Erfolgreich lauten. sollten Sie die angeforderten VM-Spezifikationen sehen.
gcloud
Rufen Sie eine Liste der Ausführungsversuche Ihres Workflows ab:
gcloud workflows executions list create-vm-from-form
Das Ergebnis sollte in etwa so aussehen:
NAME: projects/918619793306/locations/us-central1/workflows/create-vm-from-form/executions/d8947ecb-9ccb-4ea1-ba10-e5c10414e3be STATE: SUCCEEDED START_TIME: 2023-01-24T15:07:40.404741791Z END_TIME: 2023-01-24T15:07:55.649373625Z
Prüfen Sie, ob wie erwartet eine neue VM erstellt wurde:
Console
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Ihre VM-Instanz sollte mit dem Status „In Betrieb“ aufgeführt sein.
gcloud
Rufen Sie eine zusammengefasste Liste aller VMs in allen Zonen für ein Projekt ab:
gcloud compute instances list
Ihre VM-Instanz sollte mit einem Status aufgeführt sein, der angibt, dass sie ausgeführt wird.
Weitere Informationen zum Befehl
gcloud compute instances list
finden Sie auf der Referenzseite.
Bereinigen
Wenn Sie ein neues Projekt für diese Anleitung erstellt haben, löschen Sie das Projekt. Wenn Sie ein vorhandenes Projekt verwendet haben und es beibehalten möchten, ohne die Änderungen in dieser Anleitung hinzuzufügen, löschen Sie die für die Anleitung erstellten Ressourcen.
Projekt löschen
Am einfachsten vermeiden Sie weitere Kosten durch Löschen des für die Anleitung erstellten Projekts.
So löschen Sie das Projekt:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.