Zum Inhalt springen

Daten in ein Google Sheets-Tabellenblatt in Jitterbit Studio schreiben

Einführung

Der Google Sheets-Connector schreibt Tabellendaten in Google Sheets mit einem Service Account, den Sie in der Google Cloud Console konfigurieren. Die Aktivität Create Sheets erstellt jedes Mal, wenn der Vorgang ausgeführt wird, ein neues Tabellenblatt und füllt es mit Zeilen aus der Quelle.

Um in ein vorhandenes Tabellenblatt zu schreiben, verwenden Sie stattdessen die Aktivität Update Sheets.

Diese Anleitung setzt Folgendes voraus:

  • Ein Google Cloud Service Account mit aktivierter Google Sheets API und erhaltenen Anmeldedaten, wie in den Google Sheets-Voraussetzungen beschrieben.
  • Eine Quellaktivität ist bereits im Projekt konfiguriert.

Entwurfsmuster

Die Aktivität Create Sheets folgt dem Transformationsmuster:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR A[Source activity] --> B[Transformation] --> C[Create Sheets activity]

Teil 1: Google Sheets-Verbindung konfigurieren

Schritt 1: Verbindung erstellen

  1. Suchen Sie auf der Registerkarte Project endpoints and connectors der Designkomponentenpalette den Google Sheets-Connector und klicken Sie darauf, um seine Konfiguration zu öffnen.

  2. Connection Name: Geben Sie einen eindeutigen Namen für die Verbindung ein. Der Name darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  3. Project ID: Geben Sie den Wert project_id aus der JSON-Datei mit den Service Account-Anmeldedaten ein.

  4. Client Email: Geben Sie den Wert client_email aus der JSON-Datei mit den Anmeldedaten ein.

  5. Private Key String: Geben Sie den Wert private_key aus der JSON-Datei mit den Anmeldedaten ein.

  6. Key Algorithm: Wählen Sie RSA aus.

  7. Klicken Sie auf Test, um die Verbindung zu überprüfen.

  8. Klicken Sie auf Save Changes.

Teil 2: Aktivität „Create Sheets" konfigurieren

Schritt 1: Aktivität benennen und Tabellenblatt konfigurieren

  1. Ziehen Sie auf der Designfläche eine Aktivität vom Typ Create Sheets aus der Google Sheets-Verbindung auf die Fläche.

  2. Doppelklicken Sie auf die Aktivität, um ihre Konfiguration zu öffnen.

  3. Name: Geben Sie einen aussagekräftigen Namen ein, z. B. Create Contacts Spreadsheet.

  4. Spreadsheet Name: Geben Sie den Namen für die Google Sheets-Datei ein, z. B. Contacts Export. Dies ist der Dateiname, der in Google Drive angezeigt wird.

    Tipp

    Verwenden Sie eine Projektvariable für den Namen des Tabellenblatts, wenn der Name der Zieldatei zwischen Umgebungen unterschiedlich sein muss.

  5. Number of Columns: Geben Sie die Anzahl der Spalten ein, die Ihr Datensatz benötigt. Der Standardwert ist 26, was die Spalten A bis Z bereitstellt. Erhöhen Sie diesen Wert, wenn Ihre Quelldaten mehr als 26 Felder haben.

  6. Continue on Error: Wählen Sie diese Option, um den Vorgang fortzusetzen, wenn während einer Batch-Anfrage ein Fehler auftritt. Alle Fehler werden im Operationsprotokoll protokolliert.

  7. Klicken Sie auf Next.

Schritt 2: Datenschema überprüfen

  1. Überprüfen Sie das Request-Schema. Die Schlüsselstruktur ist:

    createSheetsRequest > Entity > Sheets > Sheet > data > row

    Der Knoten row ist der Loop-Knoten: Jeder Eintrag stellt eine Zeile im Tabellenblatt dar. Innerhalb jeder row enthalten die Felder A, B, C... Zeichenfolgenwerte für jede Zelle.

  2. Das Feld folder_id unter createSheetsRequest ist optional. Geben Sie eine Google Drive-Folder-ID in der Transformation an, um das Tabellenblatt in einem bestimmten Ordner zu platzieren. Falls weggelassen, wird das Tabellenblatt in dem Ordner erstellt, der mit dem Service Account der Verbindung geteilt ist.

  3. Klicken Sie auf Finished.

Teil 3: Transformation abbilden

  1. Fügen Sie auf der Designfläche einen Transformation-Schritt zwischen der Quellaktivität und der Aktivität Create Sheets hinzu.

  2. Öffne die Transformation. Das Quellschema wird auf der linken Seite und das Create Sheets-Zielschema auf der rechten Seite angezeigt.

  3. Suche den row-Knoten unter Entity > Sheets > Sheet > data. Studio behandelt diesen Knoten automatisch als Schleifenknoten, sodass jeder Quelldatensatz eine Zeile in der Tabelle erzeugt.

  4. Ordne Quellenfelder den Spaltenbuchstaben (A, B, C...) unter dem row-Knoten zu. Die Spalten entsprechen den Tabellenkalkulationsspalten von links nach rechts.

  5. (Optional) Ordne das SheetTitle-Feld unter Sheet zu, um den Namen der Registerkartenbezeichnung in der Tabelle festzulegen. Wenn nicht zugeordnet, wird eine Standardregisterkartenbezeichnung verwendet.

  6. (Optional) Ordne startRow- und startColumn-Werte unter Sheet zu, um zu steuern, wo das Schreiben von Daten beginnt. Beide Felder sind ganzzahlige Indizes mit Basis Null, daher beginnt ein Wert von 0 in der ersten Zeile oder Spalte.

Eine vollständige Anleitung zur Transformationszuordnung findest du unter Übersicht über die Transformationszuordnung.

Integration überprüfen

Stelle bereit und führe aus den Vorgang durch. Überprüfe die Vorgangsprotokolle, um zu bestätigen, dass die Create Sheets-Aktivität erfolgreich abgeschlossen wurde. Öffne Google Drive, um zu überprüfen, dass die Tabelle mit dem erwarteten Namen erstellt wurde und dass die Zeilen und Spalten mit den Quelldaten übereinstimmen.

Wenn Daten fehlen oder Spalten abgeschnitten sind, überprüfe, dass der Wert Anzahl der Spalten in der Aktivitätskonfiguration mindestens gleich der Anzahl der zugeordneten Spalten in der Transformation ist.

Um diesen Vorgang nach einem wiederkehrenden Plan auszuführen, siehe Plane einen Vorgang für automatische Ausführung.