Zum Inhalt springen

Google Docs-Verbindung in Jitterbit Studio

Einführung

Eine Google Docs-Verbindung, die mit dem Google Docs-Connector erstellt wurde, ermöglicht den Zugriff auf Google Docs. Sobald eine Verbindung konfiguriert ist, können Instanzen von Google Docs-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 Docs-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Eine Agent-Version von 10.83 / 11.21 oder höher ist erforderlich, um 3LO zu verwenden.

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

Erstellen oder Bearbeiten einer Google Docs-Verbindung

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

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

Konfigurieren einer Google Docs-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Google Docs-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 Docs-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Google Docs-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische 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-beinige 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 Docs-Connector-Anwendung auf der Seite App-Registrierungen. Weitere Informationen zur Konfiguration einer Google Docs-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den 3-beinigen 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 Docs-Anwendung zuzugreifen.

    • Privatschlüssel-basiert: 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 Dienstkonto Anmeldeinformationen bereitgestellt wird.

      • Client-Email: Geben Sie die client_email ein, die in der JSON-Datei der Dienstkonto Anmeldeinformationen bereitgestellt wird.

      • Privater Schlüssel-String: Geben Sie den private_key ein, der in der JSON-Datei der Dienstkonto Anmeldeinformationen bereitgestellt wird. Der private Schlüssel sollte in folgendem Format eingegeben werden:

        -----BEGIN PRIVATE KEY-----
<private_key>
-----END PRIVATE KEY-----

        Hinweis

        Alle Zeilenumbrüche (\n), die im private_key-String vorhanden sind, müssen im Feld Privater Schlüssel-String durch einen Wagenrücklauf ersetzt werden. Andernfalls tritt ein Fehler auf, wenn die Verbindung getestet wird.

  • 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 Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und 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 fragt Sie, ob 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 fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Verbindung zu Google Docs hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, 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:

  • Docs erstellen: Erstellt Dokumente und platziert sie in Google Docs und ist als Ziel in einem Vorgang vorgesehen.

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

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