Google Docs-Connector in Jitterbit Studio

Zusammenfassung

Der Google Docs-Connector ermöglicht den Zugriff auf Google Docs.

Der Google Docs-Connector bietet eine Schnittstelle zur Erstellung einer Google Docs-Verbindung, die als Grundlage für die Generierung von Instanzen von Google Docs-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Google Docs.

Der Google Docs-Connector wird über die Registerkarte Projektendpunkte und Connectoren in der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Google Docs-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische Google Docs-Verbindung und ihre Aktivitäten als Google Docs-Endpunkt bezeichnet:

• Docs erstellen: Erstellt Dokumente in Google Docs und ist als Ziel in einem Vorgang gedacht.

• Docs aktualisieren: Aktualisiert Dokumente in Google Docs und ist als Ziel in einem Vorgang gedacht.

• Docs abrufen: Ruft Dokumente aus Google Docs ab und ist als Quelle in einem Vorgang gedacht.

Voraussetzungen und unterstützte API-Versionen

Der Google Docs-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der Google Docs-Connector verwendet die Google Docs API v1. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Um 3-beinige OAuth 2.0 (3LO)-Authentifizierung oder die Authentifizierung mit einem Google Cloud-Dienstkonto mit dem Google Docs-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Für die Verwendung von 3LO ist die Agentenversion 10.83 / 11.21 oder höher erforderlich.

Um den Google Docs-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 Docs beschrieben.

Fehlersuche

Wenn Sie Probleme mit dem Google Docs-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

1. Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).

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

3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

4. Wenn Sie private Agenten verwenden, können Sie ausführliches Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

   Weitere Informationen zum ausführlichen Protokollieren des Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, die Jitterbit private Agenten verwenden.

5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle für weitere Informationen überprüfen.

6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlersuche bei Operationen.