Zum Inhalt springen

Google Docs Update Docs-Aktivität in Jitterbit Studio

Einführung

Eine Google Docs Update Docs-Aktivität, die ihre Google Docs-Verbindung verwendet, aktualisiert Google Docs-Dokumente und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

Erstellen einer Google Docs Update Docs-Aktivität

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

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

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

Konfigurieren einer Google Docs Update Docs-Aktivität

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

Schritt 1: Geben Sie einen Namen ein

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

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Connector-Typs konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

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

  • 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-Anforderung 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

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

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.

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

    Die Anforderungs- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:

    • Anfrage:

      Feld/Knoten des Anforderungsschemas Google API-Feld Hinweise
      request Request Null oder mehr Dokumentanforderungen
      documentId documentId Dokument-ID des Google Dokuments
      ReplaceAllTextRequest ReplaceAllTextRequest Ersetzt alle Instanzen von Text, die einem Kriterium entsprechen, durch den Ersetzungstext
      replaceText replaceText Text, der den übereinstimmenden Text ersetzt
      text containsText Text für die SubstringMatchCriteria, Groß-/Kleinschreibung beachten
      InsertTextRequest InsertTextRequest Fügt Text an der angegebenen Stelle ein
      text text Einzufügender Text
      index index Einfügeort-Index; da kein segmentId angegeben ist, wird im Körper eingefügt
      DeleteContentRangeRequest DeleteContentRangeRequest Löscht Inhalte aus dem Dokument
      startIndex startIndex Nullbasierter Startindex dieses Bereichs, in UTF-16-Codeeinheiten
      endIndex endIndex Nullbasierter Endindex dieses Bereichs, exklusiv, in UTF-16-Codeeinheiten
      InsertTableRequest InsertTableRequest Fügt eine Tabelle an der angegebenen Stelle ein
      rows rows Anzahl der Zeilen in der Tabelle
      columns columns Anzahl der Spalten in der Tabelle
      index index Einfügeort-Index; da kein segmentId angegeben ist, wird im Körper eingefügt

    • Antwort:

      Antwort-Schema Feld/Knoten Google API Feld Hinweise
      update documents.batchUpdate.response Null oder mehr Dokumentantworten, eine für jede Dokumentanforderung
      statusCode n/a Statuscode, gesetzt bei Fehler
      documentId documentId Dokument-ID des Google Dokuments
      message n/a Zurückgegebene Nachrichten, falls vorhanden

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Google Docs-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen 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 Docs Update Docs-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. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Google Docs Update Docs-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 Speicherort und verwenden Sie dann diesen temporären Speicherort 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.