Google Drive-Verbindung
Einführung
Eine Google Drive-Verbindung, die mit dem Google Drive-Connector erstellt wurde, ermöglicht den Zugriff auf Google Drive. Sobald eine Verbindung konfiguriert ist, können Instanzen von Google Drive-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 Drive-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Die Agenten-Version 10.83 / 11.21 oder höher ist erforderlich, um 3LO zu verwenden.
Um den Google Drive-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 Drive beschrieben.
Der Google Drive-Ordner, auf den Sie zugreifen möchten, muss mit dem Google-Dienstkonto geteilt werden, das in der Verbindung verwendet wird. Dokumente außerhalb des freigegebenen Ordners können nicht zugegriffen werden.
Erstellen oder Bearbeiten einer Google Drive-Verbindung
Eine neue Google Drive-Verbindung wird mit dem Google Drive-Connector aus einem dieser Standorte erstellt:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).
Eine vorhandene Google Drive-Verbindung kann von diesen Standorten bearbeitet werden:
- Die Registerkarte Projektendpunkte und -verbindungen der Designkomponentenpalette (siehe Designkomponentenpalette).
- Die Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü der Komponenten in Projektbereich Komponentenregister).
- Die Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).
Konfigurieren einer Google Drive-Verbindung
Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Google Drive-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 Drive-Verbindung eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den Google Drive-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:
-
OAuth-Anwendung: Wählen Sie eine Google Drive-Connector-Anwendung aus, die in der Management-Konsole auf der Seite App-Registrierungen konfiguriert ist. Weitere Informationen zur Konfiguration einer Google Drive-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 Drive-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_idein, die in der JSON-Datei der Dienstkonto Anmeldeinformationen bereitgestellt wird. -
Client-Email: Geben Sie die
client_emailein, die in der JSON-Datei der Dienstkonto Anmeldeinformationen bereitgestellt wird. -
Privater Schlüsselstring: Geben Sie den
private_keyein, 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 imprivate_key-String vorhanden sind, müssen im Feld Privater Schlüsselstring 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 Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen 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 eine vorhandene Verbindungs-Konfiguration geöffnet wurde, 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 wirklich löschen möchten.
Nächste Schritte
Nachdem eine Google Drive-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:
-
Datei aktualisieren: Aktualisiert Dateien in Google Drive und ist als Ziel in einem Vorgang vorgesehen.
-
Datei löschen: Löscht eine Datei aus Google Drive und ist als Ziel in einem Vorgang vorgesehen.
-
Datei erstellen: Erstellt Dateien in Google Drive und ist als Ziel in einem Vorgang vorgesehen.
-
Dateien auflisten: Ruft eine Liste von Dateien (die einer Abfrage entsprechen) aus Google Drive ab und ist als Quelle in einem Vorgang vorgesehen.
-
Datei abrufen: Ruft eine Datei aus Google Drive ab und ist als Quelle in einem Vorgang vorgesehen.