Zum Inhalt springen

Cloud Datastore Insert Items-Aktivität in Jitterbit Studio

Einführung

Eine Cloud Datastore Insert Items-Aktivität verwendet ihre Cloud Datastore-Verbindung zum Einfügen neuer Daten in einen Statuspeicher oder Schlüsselspeicher und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Cloud Datastore Insert Items-Aktivität

Eine Instanz einer Cloud Datastore Insert Items-Aktivität wird aus einer Cloud Datastore-Verbindung mit dem Aktivitätstyp Insert Items erstellt.

Um eine Aktivitätsinstanz 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ätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Cloud Datastore Insert Items-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Cloud Datastore Insert Items-Aktivität

Führen Sie diese Schritte aus, um eine Cloud Datastore Insert Items-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie den Speicher fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Die in diesem Schritt der Konfiguration einer Insert Items-Aktivität verwendete Benutzeroberfläche hängt von der ausgewählten Option Speicher auswählen ab:

Vorhandenen Speicher auswählen

Wenn Vorhandenen Speicher auswählen für Speicher auswählen ausgewählt ist, wird die nachfolgend beschriebene Benutzeroberfläche angezeigt.

  • Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration 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 Cloud Datastore Insert Items-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Speicher auswählen: Wählen Sie die Option Vorhandenen Speicher auswählen, um einen vorhandenen Speicher aus einer gefüllten Liste auszuwählen.

  • Speicher auswählen: Dieser Abschnitt zeigt Cloud Datastore-Speicher an, die für die Umgebung verfügbar sind.

    • Ausgewählter Speicher: Nach Auswahl eines Speichers wird dieser hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Speicher zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Speicher bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Speicher vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Elemente vom Cloud Datastore-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Speicher in Cloud Datastore hinzugefügt oder bearbeitet wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Speichertabelle verwendet werden.

  • Speicher auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um einen Speicher auszuwählen. Es kann nur ein Speicher ausgewählt werden. Die für jeden Speicher verfügbaren Informationen werden vom Cloud Datastore-Endpunkt abgerufen:

    • Name: Der Name des Speichers.

    • Typ: Der Speichertyp, entweder Nachschlag nach Schlüssel (Schlüsselspeicher) oder Nachschlag nach Status (Statusspeicher).

    • Beschreibung: Die Beschreibung des Speichers, die während der Speichererstellung angegeben wurde.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Einfügestrategie: Wählen Sie die Methode zum Einfügen von Daten:

      • Reihenfolge der Elemente beim Einfügen beibehalten (Standard): Bei Auswahl während einer Batch-Anfrage wird die Reihenfolge der eingefügten Elemente priorisiert. Diese Option kann zu längeren Verarbeitungszeiten führen.

      • Leistung bei Batch-Einfügung beibehalten (Elementreihenfolge kann nicht garantiert werden): Bei Auswahl während einer Batch-Anfrage wird die Reihenfolge der eingefügten Elemente nicht priorisiert und wird an Cloud Datastore selbst delegiert.

    • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Wenn Fehler auftreten, werden diese in das Operationsprotokoll geschrieben.

  • Speichern und beenden: 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 zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

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

Speichernamen manuell eingeben

Wenn Speichernamen manuell eingeben für Speicher auswählen ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration 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 Cloud Datastore-Aktivität Elemente einfügen eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Speicher: Geben Sie den Namen des Speichers ein, mit dem Sie interagieren möchten.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Einfügestrategie: Wählen Sie die Methode zum Einfügen von Daten:

      • Reihenfolge der Elemente beim Einfügen beibehalten (Standard): Bei Auswahl während einer Batch-Anfrage wird die Reihenfolge der eingefügten Elemente priorisiert. Diese Option kann zu längeren Verarbeitungszeiten führen.

  • Optimale Leistung mit Batch-Einfügung (Elementreihenfolge kann nicht garantiert werden): Bei Auswahl während einer Batch-Anfrage wird die Reihenfolge der eingefügten Elemente nicht priorisiert und wird Cloud Datastore selbst überlassen.

  • 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 zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf 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 an einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

    Hinweis

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

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

    Schlüsselspeicher-Anforderungsknoten oder -feld Beschreibung
    json Knoten mit dem JSON-Anfrageschema
    <custom field> Alle im Schlüsselspeicher definierten benutzerdefinierten Felder sind in der Anfrage enthalten
    Value Der Primärwert, der dem Schlüssel im Schlüssel-Wert-Paar zugeordnet ist. Dieses Feld entspricht der Spalte Value im Schlüsselspeicher
    Key Der Primärbezeichner für das Element im Schlüssel-Wert-Paar. Dieses Feld entspricht der Spalte Key im Schlüsselspeicher und unterscheidet Groß- und Kleinschreibung.
    AlternativeKey Ein alternativer Bezeichner, der zum Nachschlagen desselben Elements verwendet werden kann. Dieses Feld entspricht der Spalte Alternative Key im Schlüsselspeicher und unterscheidet Groß- und Kleinschreibung.
    Statuspeicher-Anforderungsknoten oder -feld Beschreibung
    json Knoten mit dem JSON-Anfrageschema
    Status Der Erfolg oder Misserfolg des Vorgangs
    RetryPolicyRetryCount (Nur zur internen Verwendung)
    RetryPolicyLastRetryDate (Nur zur internen Verwendung)
    DuplicationControl (Nur zur internen Verwendung)
    RetryPolicyNextRetryDate (Nur zur internen Verwendung)
    Key Der vom Benutzer bereitgestellte Elementschlüssel, der während der Elementerstellung mit einer [Insert Items-Aktivität] festgelegt wurde
    StatusMessage Meldung mit Informationen zum Einfügestatus
    MessageBody BigText für die Vorgangsnutzlast
Schlüssel und Status-Speicher-Antwortknoten oder -Feld Beschreibung
json Knoten mit dem JSON-Request-Schema
responses Knoten mit allen Antworten
item Knoten mit jedem eingefügten Element
data In den Speicher eingefügte Daten
id Die ID des Speicherelements
created Boolescher Wert, der den Erfolg (true) oder Fehler (false) der Erstellung darstellt
errors Knoten mit allen Fehlern
item Knoten mit allen Fehlermeldungen
message Eine Fehlermeldung

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Cloud Datastore-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf das gleiche Schema verwiesen wird, z. B. 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: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Cloud Datastore-Aktivität Elemente einfügen schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Cloud Datastore-Aktivitäten Elemente einfügen können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.