Zum Inhalt springen

Google Sheets Update Sheets-Aktivität

Einführung

Eine Google Sheets Update Sheets-Aktivität, die über ihre Google Sheets-Verbindung verwendet wird, aktualisiert eine Google Sheets-Tabelle und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

Erstellen einer Google Sheets Update Sheets-Aktivität

Eine Instanz einer Google Sheets Update Sheets-Aktivität wird aus einer Google Sheets-Verbindung unter Verwendung des Aktivitätstyps Update Sheets erstellt.

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

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

Konfigurieren einer Google Sheets Update Sheets-Aktivität

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

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und spezifizieren die Anzahl der Spalten. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Google Sheets Update Sheets Aktivitätskonfiguration Schritt 1

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

  • Anzahl der Spalten: Geben Sie die Anzahl der Spalten an, die beim Erstellen der Tabelle verwendet werden sollen (optional); wenn keine Angabe erfolgt, wird der Standardwert von 26 verwendet.

  • Fortfahren bei Fehler: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im Betriebsprotokoll aufgezeichnet.

  • Speichern & 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 zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen Sie die Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Google Sheets Update Sheets Aktivitätskonfiguration Schritt 2

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen übernommen und während der Transformationszuordnung erneut angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

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

    Wichtig

    Während die Kardinalität der Felder spreadsheetId, title und sheetId im Anfrage-Schema [0, 1] beträgt (was die Felder als optional kennzeichnet), sind Eingaben für diese Felder gemäß der Google Sheets API erforderlich, wie unten dokumentiert.

    • Anfrage:

      Anfrage-Schema Feld/Knoten Google API Feld/Methode, Typ Hinweise
      updateSheetsRequest spreadsheets.update Anfrage zur Aktualisierung eines Tabellenblatts
      spreadsheetId (erforderlich) spreadsheetId ID des zu aktualisierenden Tabellenblatts (erforderlich)
      title (erforderlich) title Titel des Tabellenblatts (erforderlich)
      request Knoten Jede Anfrage ist eine der findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, oder updateCellRequest
      findReplaceRequest FindReplaceRequest Sucht und ersetzt Daten in Zellen über einen Bereich, ein Blatt oder alle Blätter
      find Zeichenfolge Der Wert, nach dem gesucht werden soll
      replacement Zeichenfolge Der Wert, der als Ersatz verwendet werden soll
      matchCase Boolean True, wenn die Suche groß-/kleinschreibungssensitiv ist
      searchByRegex Boolean True, wenn der Suchwert ein regulärer Ausdruck ist. Der reguläre Ausdruck und der Ersatz sollten den Java-Regel für reguläre Ausdrücke folgen.
      matchEntireCell Boolean True, wenn der Suchwert die gesamte Zelle übereinstimmen soll
      includeFormulas Boolean True, wenn die Suche Zellen mit Formeln einbeziehen soll. False, um Zellen mit Formeln zu überspringen.
      unionFields Knoten Umfang des Unionfeldes: Der Umfang, über den gesucht/ersetzt werden soll; Sie müssen eines der Felder SheetID oder allSheets oder die Felder unter dem [gridRange][grid-range] Knoten festlegen.
      addSheetRequest
      updateSheetsRequest spreadsheets.update Anfrage zur Aktualisierung eines Tabellenblatts
      spreadsheetId spreadsheetId ID des zu aktualisierenden Tabellenblatts
      title title Titel des Tabellenblatts
      request Knoten Jede Anfrage ist eine der findReplaceRequest, addSheetRequest, updateSheetRequest, deleteSheetRequest, deleteCellRequest, oder updateCellRequest
      findReplaceRequest FindReplaceRequest Sucht und ersetzt Daten in Zellen über einen Bereich, ein Blatt oder alle Blätter
      find Zeichenfolge Der Wert, nach dem gesucht werden soll
      replacement Zeichenfolge Der Wert, der als Ersatz verwendet werden soll
      matchCase Boolean True, wenn die Suche groß-/kleinschreibungssensitiv ist
      searchByRegex Boolean True, wenn der Suchwert ein regulärer Ausdruck ist. Der reguläre Ausdruck und der Ersatz sollten den Java-Regel für reguläre Ausdrücke folgen.
      matchEntireCell Boolean True, wenn der Suchwert die gesamte Zelle übereinstimmen soll
      includeFormulas Boolean True, wenn die Suche Zellen mit Formeln einbeziehen soll. False, um Zellen mit Formeln zu überspringen.
      unionFields (erforderlich) Knoten Umfang des Unionfeldes: Der Umfang, über den gesucht/ersetzt werden soll; Eingaben in entweder das SheetID oder das allSheets Feld sind erforderlich
      SheetId Ganzzahl Das Blatt, über das gesucht/ersetzt werden soll
      allSheets Boolean Auf true setzen, um über alle Blätter zu suchen/ersetzen
      gridRange Knoten Sucht und ersetzt Daten innerhalb eines Bereichs auf einem Blatt
      sheetId (erforderlich) Ganzzahl Das Blatt, auf dem sich dieser Bereich befindet (erforderlich)
      startRowIndex Ganzzahl Die Startzeile (einschließlich) des Bereichs
      endRowIndex Ganzzahl Die Endzeile (ausschließlich) des Bereichs
      startColumnIndex Ganzzahl Die Startspalte (einschließlich) des Bereichs
      endColumnIndex Ganzzahl Die Endspalte (ausschließlich) des Bereichs

    • Antwort:

      Antwort-Schema Feld/Knoten Google API Feld Hinweise
      updateSheetsResponse n/a Antwort von der Erstellung des Tabellenblatts
      spreadsheetId spreadsheetId ID des neu aktualisierten Tabellenblatts
      sheets n/a Knoten, der das Tabellenblatt darstellt
      properties n/a Knoten, der die zurückgegebenen Eigenschaften darstellt
      code n/a Zurückgegebener Fehlercode (falls vorhanden)
      message n/a Nachricht, die bei der Erstellung zurückgegeben wird (falls vorhanden)

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Google Sheets-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, wo dasselbe Schema referenziert wird, wie in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Google Sheets Update Sheets-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

Google Sheets Update Sheets-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

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

Wenn Sie bereit sind, bereitstellen und ausführen Sie den Vorgang und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.