Zum Inhalt springen

Google Sheets-Connector in Jitterbit Studio

Zusammenfassung

Der Google Sheets-Connector stellt Zugriff auf Google Sheets bereit.

Der Google Sheets-Connector bietet eine Schnittstelle zum Erstellen einer Google Sheets-Verbindung, die Grundlage für die Generierung von Google Sheets-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Google Sheets.

Der Google Sheets-Connector wird über die Registerkarte Projektendpunkte und Konnektoren der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Google Sheets-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Google Sheets-Verbindung und ihre Aktivitäten als Google Sheets-Endpunkt bezeichnet:

Google Sheets-Aktivitätstypen

  • Get Sheets: Ruft eine Tabelle aus Google Sheets ab und soll als Quelle in einem Vorgang verwendet werden.

  • Update Sheets: Aktualisiert eine Tabelle in Google Sheets und soll als Ziel in einem Vorgang verwendet werden.

  • Create Sheets: Erstellt eine Tabelle in Google Sheets und soll als Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update ausgesetzt werden.

Der Google Sheets-Connector verwendet die Google Sheets API v4. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Um die 3-beinige OAuth 2.0 (3LO)-Authentifizierung oder die Google Cloud-Dienstkontenauthentifizierung mit dem Google Sheets-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Agent-Version 10.83 / 11.21 oder später ist erforderlich, um 3LO zu verwenden.

Um den Google Sheets-Connector ohne 3LO zu verwenden, benötigen Sie ein Google-Dienstkonto für Ihr Projekt mit entsprechenden Berechtigungen und bestimmte Anmeldedaten vom Dienstkonto, wie in Google Sheets-Voraussetzungen beschrieben.

Fehlerbehebung

Bei Problemen mit dem Google Sheets-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern die Organisationsrichtlinie Disable Auto Connector Update nicht verwendet wird).

  2. Überprüfen Sie die Vorgangsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie die Vorgangsprotokollierung zum Debuggen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie die Verbose-Protokollierung für Connectoren für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agents hinzufügen:

    <logger name="org.jitterbit.connector.sheets" level="DEBUG"/>

    Weitere Informationen zur Verbose-Protokollierung für Connectoren finden Sie unter Verbose-Protokollierung für Connectoren mit Jitterbit-Privatagents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

Praktische Anwendung