Zum Inhalt springen

Cloud Datastore Query Items-Aktivität in Jitterbit Studio

Einführung

Eine Cloud Datastore Query Items-Aktivität verwendet ihre Cloud Datastore-Verbindung, um Daten aus einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore zu lesen. Sie dient als Quelle, um Daten in einen Vorgang 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. Die Query Items-Aktivität gibt beispielsweise die id des Speichers und der Speicherelemente zurück, die erforderlich sind, um mit Elementen in einer Update Items-Aktivität zu interagieren.

Eine Cloud Datastore Query Items-Aktivität erstellen

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

Zum Erstellen einer Aktivitätsinstanz ziehen Sie den Aktivitätstyp auf die Designleinwand oder kopieren den Aktivitätstyp und fügen ihn auf der Designleinwand ein. Weitere Informationen finden Sie unter Eine Aktivitätsinstanz erstellen in Komponenten wiederverwenden.

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

Eine 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 festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und legen Sie den Speicher fest. Alle Benutzeroberflächenelemente dieses Schritts werden unten beschrieben.

Die Schnittstelle, die in diesem Konfigurationsschritt einer Query Items-Aktivität verwendet wird, hängt von der ausgewählten Option Speicher auswählen ab:

Vorhandenen Speicher auswählen

Wenn für Speicher auswählen die Option Vorhandenen Speicher auswählen ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

  • Endpoint-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird ein Menü oben auf dem Bildschirm 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 Mauszeiger über den Namen des aktuellen Endpunkts halten. 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 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: In diesem Abschnitt werden die für die Umgebung verfügbaren Cloud Datastore-Speicher angezeigt.

    • 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. Die Suche ist nicht case-sensitiv. Wenn Speicher bereits in der Tabelle angezeigt werden, werden die Tabellenresultate mit jedem Tastendruck in Echtzeit gefiltert. Um Speicher vom Endpunkt beim Suchen 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 zu laden. Dies kann hilfreich 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 verfügbaren Informationen für jeden Speicher werden vom Cloud Datastore-Endpunkt abgerufen:

      • Name: Der Name des Speichers.

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

      • Beschreibung: Die während der Speichererstellung bereitgestellte Beschreibung des Speichers.

  • 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 der letzten Stufe auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht 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 Oberfläche angezeigt.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder damit, eine öffnende eckige Klammer [ in das Feld einzugeben, 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, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern unter Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen halten. 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 abfragen eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Speicher: Geben Sie den Namen des Speichers ein, mit dem interagiert werden soll.

  • 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 der letzten Stufe auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht 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 benachbarten 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:

    Speicherknotenschlüssel oder -feld anfragen Beschreibung
    json Knoten mit dem JSON-Anfrageschema
    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 Abfragefiltierkriterien
    item Knoten für eine einzelne Filterbedingung
    key Der Feldname aus dem Schlüsselspeicher zur Abfrage (Groß-/Kleinschreibung beachten). Es werden nur Key oder AlternativeKey unterstützt. Die Filterung nach einem benutzerdefinierten Feldnamen wird nicht unterstützt und gibt einen Fehler zurück.
    value Der Wert zum Filtern nach dem angegebenen Feld

    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 nicht dasselbe Feld mehrmals angeben, und es können nicht mehrere Bedingungen oder Operatoren auf dasselbe Feld angewendet werden.

    Speicherknotenschlüssel oder -feld antworten Beschreibung
    json Knoten mit dem JSON-Anfrageschema
    pagination Knoten mit Informationen zur Paginierung der Antwort
    totalItems Die Anzahl der Elemente im Speicher
    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
    Value Der Primärwert der zum Schlüssel gehört im Schlüssel-Wert-Paar. Dieses Feld entspricht der Spalte Wert im Schlüsselspeicher.
    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
    Key Der Primäridentifikator für das Element im Schlüssel-Wert-Paar. Dieses Feld entspricht der Spalte Schlüssel im Schlüsselspeicher und ist groß-/kleinschreibungsempfindlich.
    AlternativeKey Ein alternativer Bezeichner, der verwendet werden kann, um dasselbe Element nachzuschlagen. Dieses Feld entspricht der Spalte Alternativer Schlüssel im Schlüsselspeicher und ist groß-/kleinschreibungsempfindlich.
    errors Knoten mit Fehlern
    item Knoten mit Daten für ein Speicherelement
    context Jeglicher relevanter Kontext für den Fehler
    id Die ID des Speicherelements
    message Die Fehlermeldung
Statussspeicheranforderungsknoten oder -feld Beschreibung
json Knoten mit dem JSON-Anforderungsschema
page Die Anzahl der zurückzugebenden Seiten
limit Die Anzahl der pro Seite zurückgegebenen Elemente
Statussspeicherantwortknoten oder -feld Beschreibung
json Knoten mit dem JSON-Anforderungsschema
pagination Knoten mit Informationen zur Paginierung der Antwort
totalItems Die Anzahl der Elemente im Speicher
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
Status Der [Aktualisierungsstatus] des Elements
RetryPolicyRetryCount (Nur für interne Verwendung)
createdDate Das Datum, an dem der Speicher erstellt wurde
RetryPolicyLastRetryDate (Nur für interne Verwendung)
expiresDate Das Datum, an dem der Speicher ablaufen wird (Statussspeicher laufen 90 Tage nach der Erstellung ab)
DuplicationControl (Nur für interne Verwendung)
id Die ID des Speichers
updatedDate Das Datum, an dem der Speicher zuletzt aktualisiert wurde
RetryPolicyNextRetryDate (Nur für interne Verwendung)
Key Der vom Benutzer bereitgestellte Elementschlüssel, der bei der Elementerstellung mit einer Insert Items-Aktivität festgelegt wurde (Groß-/Kleinschreibung beachten)
StatusMessage Nachricht mit Informationen zum Status des Elements
MessageBody Alle BigText-Daten für das Element
errors Knoten mit Fehlern
item Knoten mit Fehlermeldungen
context Alle relevanten Informationen zum Fehler
id Die ID des Speicherelements
message Eine Fehlermeldung 
[user-defined]: /de/management-console/cloud-datastore/#add-a-key-storage
[update status]: /de/management-console/cloud-datastore/#view-status-storage-data

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder 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, z. B. in einer benachbarten 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: Nach dem Vornehmen von Änderungen klicken Sie, 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 dem Konfigurieren einer Cloud Datastore-Aktivität Query Items 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. 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 Skriptingfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptingfunktion.

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.