Zum Inhalt springen

Google Sheets - Aktivität „Sheets abrufen“

Einführung

Eine Google Sheets Aktivität Get Sheets unter Verwendung ihrer Google Sheets-Verbindung, ruft eine Google Sheets-Tabelle ab und soll als Quelle zum Bereitstellen von Daten in einem Operation verwendet werden.

Erstellen einer Google Sheets Aktivität „Tabellen abrufen“

Eine Instanz einer Google Sheets Aktivität Get Sheets wird aus einer Google Sheets-Verbindung erstellt mithilfe des Aktivitätstyps Tabellen abrufen.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Google Sheets Aktivität Get Sheets kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Google Sheets Get Sheets-Aktivität

Befolgen Sie diese Schritte, um eine Google Sheets Aktivität Get Sheets zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und geben Sie die Tabellen-ID, den Bereich und die Anzahl der Spalten an. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Google Sheets - Schritt 1 der Aktivität „Tabellen abrufen“ konfigurieren

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Google Sheets-Aktivität Get Sheets eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Tabellenblatt-ID: Geben Sie die ID des Google Sheets-Tabellenblatts ein.

  • Bereich: Die abzurufenden Zellen in A1-Notation (optional).

  • Anzahl der Spalten: Geben Sie die Anzahl der Spalten ein, die in der Antwort zurückgegeben werden sollen (optional); wenn nicht angegeben, wird der Standardwert 26 verwendet.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Alle Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Google Sheets - Schritt 2 der Aktivität „Tabellen abrufen“ konfigurieren

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Notiz

    Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

    Der Google Sheets Konnektor verwendet die Google Sheets API v4. Informationen zu den Schema und -feldern finden Sie in der API -Dokumentation.

    • Anfrage:

      Anforderungsschema-Feld/-Knoten Google API Feld/-Methode Hinweise
      getSheetRequest spreadsheets.get Anfrage zum Abrufen einer Tabelle
      SpreadSheetID n. z. ID der Tabelle (optional)
      ranges n/a Knoten, der die Tabelle darstellt Bereiche
      range n/a Reichweite in A1-Notation

    • Antwort:

      Antwortschema-Feld/Knoten Google API Feld Hinweise
      getSheetsResponse n/a Antwort vom Erstellen der Tabelle
      Entity n. z. Knoten, der die gesamte Tabellenstruktur darstellt
      SpreadSheet n/a Knoten, der die Tabelle darstellt
      spreadsheetId spreadsheetId ID der Tabelle
      Sheets sheets Knoten, der die Blätter darstellt
      Sheet sheet Knoten, der ein Blatt darstellt
      SheetTitle title Blatttitel
      SheetID sheetId Blatt-ID; darf nicht negativ sein und kann nach der Festlegung nicht mehr geändert werden
      data GridData Knoten, der die Daten für das Blatt darstellt
      row RowdData Knoten, der eine Zeile des Blattes darstellt
      A…Z n. z. Zeichenfolgendaten für die Spalten des Arbeitsblatts; standardmäßig werden in einem neuen Arbeitsblatt 26 Spalten erstellt

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Google Sheets Endpoint neu zu generieren. Diese Aktion generiert ein Schema auch an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Google Sheets Aktivität Get Sheets konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im selben oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Google Sheets Get Sheets-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.