Zum Inhalt springen

Google Sheets-Verbindung in Jitterbit Studio

Einführung

Eine Google Sheets-Verbindung, die mit dem Google Sheets-Connector erstellt wurde, ermöglicht den Zugriff auf Google Sheets. Sobald eine Verbindung konfiguriert ist, können Instanzen von Google Sheets-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Um 3-beinige OAuth 2.0 (3LO)-Authentifizierung oder die Authentifizierung mit einem Google Cloud-Dienstkonto mit dem Google Sheets-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Die Agent-Version 10.83 / 11.21 oder höher ist erforderlich, um 3LO zu verwenden.

Um den Google Sheets-Connector ohne 3LO zu verwenden, müssen Sie ein Google-Dienstkonto für Ihr Projekt mit den entsprechenden Berechtigungen einrichten und bestimmte Anmeldeinformationen vom Dienstkonto erhalten, wie in den Voraussetzungen für Google Sheets beschrieben.

Erstellen oder Bearbeiten einer Google Sheets-Verbindung

Eine neue Google Sheets-Verbindung wird mit dem Google Sheets-Connector aus einem dieser Standorte erstellt:

Eine vorhandene Google Sheets-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Google Sheets-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Google Sheets-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Google Sheets-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Google Sheets-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Wählen Sie die Methode der Authentifizierung, entweder OAuth oder Private-Key-basiert (Standard).

    • OAuth: Wählen Sie diese Option, um 3-legged OAuth 2.0 (3LO) zur Authentifizierung zu verwenden. Für wichtige Hinweise zum Verhalten von Zugriffstoken und Aktualisierungstoken siehe Wichtige Hinweise.

      • OAuth-Anwendung: Wählen Sie eine in der Management-Konsole konfigurierte Google Sheets-Connector-Anwendung auf der Seite App-Registrierungen. Weitere Informationen zur Konfiguration einer Google Sheets-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den 3-legged OAuth 2.0 (3LO) Voraussetzungen.

  • Mit Google-Konto anmelden: Klicken Sie, um sich über Google in einem separaten Browser-Tab zu authentifizieren und Jitterbit die Zustimmung zu erteilen, auf die Google Sheets-Anwendung zuzugreifen.

  • Basierend auf privatem Schlüssel: Wählen Sie diese Option, um ein Google Cloud Dienstkonto zur Authentifizierung zu verwenden.

    • Projekt-ID: Geben Sie die project_id ein, die in der JSON-Datei der Anmeldeinformationen bereitgestellt wird, wie in den Voraussetzungen für Google Sheets beschrieben.

    • Client-Email: Geben Sie die client_email ein, die in der JSON-Datei der Anmeldeinformationen bereitgestellt wird, wie in den Voraussetzungen für Google Sheets beschrieben.

    • Privater Schlüsselstring: Geben Sie den private_key ein, der in der JSON-Datei der Anmeldeinformationen bereitgestellt wird, wie in den Voraussetzungen für Google Sheets beschrieben.

    • Schlüsselalgorithmus: Wählen Sie aus dem Menü den Verschlüsselungsalgorithmus des privaten Schlüsselstrings. Derzeit wird nur RSA unterstützt.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche Einstellungen zu erweitern:

    • Verbindungszeitüberschreitung (Millisekunden): Geben Sie die Zeitüberschreitung für die Verbindung (in Millisekunden) an. Der maximal zulässige Wert beträgt 3600000 Millisekunden (1 Stunde). Der Standardwert beträgt 20000 Millisekunden (20 Sekunden).

    • Lesezeitüberschreitung (Millisekunden): Geben Sie die Zeitüberschreitung für die Anfrage der Get sheets activity (in Millisekunden) an. Der maximal zulässige Wert beträgt 3600000 Millisekunden (1 Stunde). Der Standardwert beträgt 20000 Millisekunden (20 Sekunden).

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

  • Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und die Verbindung zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Google Sheets-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Get Sheets: Ruft eine Google Sheets-Tabelle ab und ist als Quelle in einem Vorgang vorgesehen.

  • Update Sheets: Aktualisiert eine Google Sheets-Tabelle und ist als Ziel in einem Vorgang vorgesehen.

  • Create Sheets: Erstellt eine Tabelle und platziert sie in Google Sheets und ist als Ziel in einem Vorgang vorgesehen.