Shopify Delete-Aktivität in Jitterbit Studio
Einführung
Eine Shopify Delete-Aktivität verwendet ihre Shopify-Verbindung und löscht Objektdaten aus Shopify. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
Ratenlimits
Die Shopify REST Admin API erzwingt ein Ratenlimit von 40 Anfragen pro App pro Store pro Minute. Dieses Kontingent wird mit einer Rate von 2 Anfragen pro Sekunde aufgefüllt. Das Ratenlimit ist für Shopify Plus Stores erhöht. Weitere Informationen zum Ratenlimit finden Sie unter Shopify REST Admin API-Ratenlimits.
Erstellen einer Shopify Delete-Aktivität
Eine Instanz einer Shopify Delete-Aktivität wird aus einer Shopify-Verbindung mit ihrem Delete-Aktivitätstyp erstellt.
Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.
Eine vorhandene Shopify Delete-Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
- Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Registerkarte „Komponenten" des Projektbereichs).
Konfigurieren einer Shopify Delete-Aktivität
Führen Sie diese Schritte aus, um eine Shopify Delete-Aktivität zu konfigurieren:
-
Schritt 1: Namen eingeben und Objekt auswählen
Geben Sie einen Namen für die Aktivität ein und wählen Sie das Objekt aus, das die zu löschenden Daten enthält. -
Schritt 2: Unterobjekt auswählen
Wählen Sie ein Unterobjekt aus. -
Schritt 3: Datenschemas überprüfen
Alle vom Endpunkt generierten Anfrage- oder Antwortschemas werden angezeigt.
Schritt 1: Namen eingeben und Objekt auswählen
Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie das Objekt aus, das die zu löschenden Daten enthält. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
-
Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, 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 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.
-
Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, 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 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 Shopify Delete-Aktivität eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. -
Objekt auswählen: Dieser Bereich zeigt die im Shopify-Endpunkt verfügbaren Objekte an.
-
Ausgewähltes Objekt: Nach der Auswahl eines Objekts wird es hier aufgelistet.
-
Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Objektliste zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen 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 Objekte vom Shopify-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Objekte zu Shopify hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.
-
Ein Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die für jedes Objekt verfügbaren Informationen werden vom Shopify-Endpunkt abgerufen:
-
Name: Der Name des Shopify-Objekts.
-
Beschreibung: Die Beschreibung des Shopify-Objekts.
-
Tipp
Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die Shopify-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.
-
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.
Schritt 2: Ein Unterobjekt auswählen
Wählen Sie in diesem Schritt das Unterobjekt aus, das die zu löschenden Daten enthält. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.
-
Ein Objekt auswählen: Dieser Bereich zeigt Unterobjekte an, die im Shopify-Endpunkt verfügbar sind.
-
Ausgewähltes Objekt: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.
-
Ausgewähltes Unterobjekt: Nach der Auswahl eines Unterobjekts wird es hier aufgelistet.
-
Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Unterobjekte zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Unterobjekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Unterobjekte vom Endpunkt beim Suchen 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 Unterobjekte vom Shopify-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Unterobjekte zu Shopify hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Unterobjekttabelle verwendet werden.
-
Ein Unterobjekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Unterobjekt auszuwählen. Es kann nur ein Unterobjekt ausgewählt werden. Die für jedes Unterobjekt verfügbaren Informationen werden vom Shopify-Endpunkt abgerufen:
-
Name: Der Name des Shopify-Unterobjekts.
-
Beschreibung: Die Beschreibung des Shopify-Unterobjekts.
-
-
Tipp
Wenn die Tabelle nicht mit verfügbaren Unterobjekten gefüllt wird, ist die Shopify-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.
-
Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
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: 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 3: Datenschemas überprüfen
Alle aus dem Endpunkt generierten Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
-
Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Datenzuordnung von Transformationen angezeigt.
Hinweis
Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.
Der Shopify-Connector verwendet die Shopify REST Admin API in der Version, die in einer Shopify-Verbindung ausgewählt wurde. Je nach den von Shopify in der verwendeten API-Version unterstützten Endpunkten können die verfügbaren Objekte und Unterobjekte variieren. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.
Wichtig
Shopify veröffentlicht alle drei Monate eine neue API-Version und verwaltet jede Releaseversion mindestens zwölf Monate lang. Sobald eine API-Version veraltet ist, verwaltet Shopify diese Version nicht mehr, und alle API-Aufrufe, die diese Version anfordern, werden automatisch zur ältesten derzeit unterstützten stabilen Version weitergeleitet.
Shopify kann bestimmte Endpunkte als veraltet kennzeichnen, wenn eine neue API-Version eingeführt wird. Daher müssen Sie möglicherweise Ihre Apps und Aktivitätskonfigurationen aufgrund von geänderten oder eingestellten Funktionen ändern.
Veraltete API-Versionen und Endpunkte werden im Shopify-Änderungsprotokoll angekündigt, wo weitere Details und relevante Migrationsinformationen verfügbar sind.
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Shopify-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 angrenzenden Transformation.
-
Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie hier, 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 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.
Nächste Schritte
Nach der Konfiguration einer Shopify-Aktivität Löschen 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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.
Shopify-Aktivitäten Löschen können als Ziel mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Zwei-Transformations-Muster (als erstes oder zweites Ziel)
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.
Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.