Zum Inhalt springen

Cloud Datastore Query Items (Veraltet) Aktivität in Jitterbit Studio

Warnung

Die Aktivität Query Items (Veraltet) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in der Version 11.47 durch die neu gestaltete Query Items Aktivität ersetzt, deren abgeflachte Antwortstruktur dafür sorgt, dass die einzelnen Felder, die Sie auf der Seite Cloud Datastore in der Management Console definieren, direkt auf der obersten Ebene der Antwort zurückgegeben werden.

Einführung

Eine Cloud Datastore Query Items Aktivität liest mithilfe ihrer Cloud Datastore Verbindung Daten aus einem Statuspeicher oder Schlüsselspeicher innerhalb von Cloud Datastore aus und ist dazu gedacht, als Quelle verwendet zu werden, um Daten in einer Verarbeitung bereitzustellen.

Die von dieser Aktivität zurückgegebenen Daten können in einer Transformation verwendet werden, um Daten dem Anforderungsschema einer anderen Cloud Datastore Aktivität zuzuordnen. Beispielsweise gibt die Aktivität Query Items die id des Speichers und der Speicherelemente zurück, was erforderlich ist, um mit Elementen in einer Update Items Aktivität zu interagieren.

Cloud Datastore Query Items Aktivität erstellen

Eine Instanz einer Cloud Datastore Query Items Aktivität wird aus einer Cloud Datastore Verbindung mit dem Aktivitätstyp Query 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. Details finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Cloud Datastore Query Items Aktivität kann an folgenden Orten bearbeitet werden:

Cloud Datastore Query Items Aktivität konfigurieren

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

Schritt 1: Namen eingeben und Einstellungen angeben

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 Query 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.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem Namen des aktuellen Endpunkts angezeigt. 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 Namen des aktuellen Endpunkts überfahren. 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 Query Items-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Speicher wählen: Wählen Sie die Option Bestehenden Speicher wählen, um einen vorhandenen Speicher aus einer ausgefüllten Liste auszuwählen.

  • Speicher wählen: In diesem Bereich werden die für die Umgebung verfügbaren Cloud Datastore-Speicher angezeigt.

    • Gewählter Speicher: Nachdem ein Speicher ausgewählt wurde, wird dieser hier aufgelistet.

    • Suche: Geben Sie einen beliebigen Spaltenwert 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 Durchsuchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten 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 angezeigten Speichertabelle in der Konfiguration verwendet werden.

    • Speicher wä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 verfügbaren Informationen für jeden Speicher werden vom Cloud Datastore-Endpunkt abgerufen:

      • Name: Der Name des Speichers.

      • Typ: Der Speichertyp, entweder Lookup by Key (Schlüsselspeicher) oder Lookup by Status (Statusspeicher).

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

  • 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 gehen. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

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

Speichernamen manuell angeben

Wenn Speichernamen manuell angeben für Speicher wä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 verfügbaren Variablen anzuzeigen.

  • Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts 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 Namen des aktuellen Endpunkts überfahren. 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 Query Items-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

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

  • 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 gehen. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie hier, 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.

Schritt 2: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts ist 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 Request- und Response-Datenschemas bestehen aus diesen Knoten und Feldern:

    Schlüsselspeicher-Request-Knoten oder -Feld Beschreibung
    json Knoten mit dem JSON-Request-Schema
    page Die Anzahl der zurückzugebenden Seiten
    limit Die Anzahl der pro Seite zurückgegebenen Elemente
    sortBy Das zu sortierende Feld
    sortDir Die Sortierrichtung, entweder asc (aufsteigend) oder desc (absteigend)
    fields Knoten mit Abfragefilterkriterien
    item Knoten, der eine einzelne Filterbedingung darstellt

    Hinweis

    Jede Filterbedingung unterstützt einen dieser Operatoren: =, >, >=, <, <=, != und =@. Mehrere Filterbedingungen (mehrere item-Knoten) können nur kombiniert werden, wenn jede Bedingung ein anderes Feld angibt. Ein Filter kann dasselbe Feld nicht mehrmals angeben, und es können nicht mehrere Bedingungen oder Operatoren auf dasselbe Feld angewendet werden.

    Statusspeicher-Request-Knoten oder -Feld Beschreibung
    json Knoten mit dem JSON-Request-Schema
    page Die Anzahl der zurückzugebenden Seiten
    limit Die Anzahl der pro Seite zurückgegebenen Elemente
    Schlüssel- und Statusspeicher-Response-Knoten oder -Feld Beschreibung
    json Knoten mit dem JSON-Request-Schema
    pagination Knoten mit Informationen zur Paginierung der Response
    totalItems Die Anzahl der gelöschten Elemente
    limit Die Anzahl der pro Seite zurückgegebenen Elemente
    totalPages Die Anzahl der zurückgegebenen Seiten
    sortBy Das sortierte Feld
    page Die Anzahl der zurückgegebenen Seiten
    sortDir Die Sortierrichtung, entweder asc (aufsteigend) oder desc (absteigend)
    data Knoten mit Informationen zum Speicher
    item Knoten mit einem Speicher
    createdDate Das Datum, an dem der Speicher erstellt wurde
    expiresDate Das Datum, an dem der Speicher abläuft (Statuspeicher laufen 90 Tage nach der Erstellung ab)
    id Die ID des Speichers
    updatedDate Das Datum, an dem der Speicher zuletzt aktualisiert wurde
    fields Knoten mit Feldern (variiert je nach Speichertyp und Einstellungen)
    default Knoten mit Standardfeldern (variiert je nach Speichertyp)
    custom Knoten mit benutzerdefinierten Feldern (variiert je nach den Einstellungen des Speichers)
    errors Knoten mit allen Fehlern
    item Knoten mit Daten für ein Speicherelement
    context Jeder relevante Kontext für den Fehler
    id Die ID des Speicherelements
    message Die Fehlermeldung

Wichtig

Daten, die von dieser Aktivität zurückgegeben werden, können in einer Transformation verwendet werden, um Daten dem Request-Schema einer anderen Cloud Datastore-Aktivität zuzuordnen. Beispielsweise gibt die Aktivität Query Items die id des Speichers und der Speicherelemente zurück, die für die Interaktion mit Elementen in einer Update Items-Aktivität erforderlich sind.

  • 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 dasselbe Schema verwiesen wird, beispielsweise 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 in 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 Query Items schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Tools als Schritte des Vorgangs 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 erreichbar. Details finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Cloud Datastore-Aktivitäten Query Items können als Quelle 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 dann diesen temporären Speicherort in der Scripting-Funktion.

Wenn alles fertig ist, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle prüfen.