Produktdaten abrufen
In Workflows, die Produktdaten verwenden, kannst du die Aktion „Produktdaten abrufen“ verwenden, um Produktinformationen aus deinem Shop abzurufen.
Auf dieser Seite
Konfiguration
Felder
Die Aktion „Produktdaten abrufen“ enthält die folgenden Felder, die zur Erstellung der Abfrage verwendet werden:
| Feld | Beschreibung |
|---|---|
| Daten sortieren nach | Erforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden. |
| Maximale Anzahl an Ergebnissen | Erforderlich. Die maximale Anzahl der Ergebnisse, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 auf einmal zurückgeben lassen. |
| Abfrage | Erforderlich. Wähle aus allgemeinen Abfragen aus oder wähle „Erweitert“ aus, um deine eigene Abfrage zu erstellen. |
Abfrage-String
Dies ist eine Beispielabfrage, um Produkte abzurufen, die am letzten Tag aktualisiert wurden:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Die Variable updated_at ist ein Filter, der in der Produktabfrage verfügbar ist und mehrmals verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist in Workflows verfügbar, die den Trigger „Geplante Zeit“ verwenden. Der Liquid-Tag date_minus ist ein spezieller Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.
Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:
- Liste der verfügbaren Produktfilter
- Abfragen müssen einer bestimmten Syntax folgen
- Werte von Abfragefeldern sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um beispielsweise einige Werte für die Bestellabfrage zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
- Du kannst eine Abfrage in deinem Shop mit der Shopify GraphiQL-App ausführen oder testen.
- Achte darauf, was passiert, wenn deine Abfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstelle von keinen).
Zurückgegebene Daten
Alle Aktionen vom Typ „Daten abrufen“ geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten möglicherweise auf verschiedene Weisen verwenden:
- Wenn du jedes Listenelement einzeln bearbeiten musst, z. B. um für jedes ein Tag hinzuzufügen, kannst du die Aktion „Für jedes“ verwenden.
- Wenn du Daten aggregieren musst, z. B. die Anzahl der zurückgegebenen Ergebnisse zählen, kannst du die Aktionen „Zählen“ oder „Summieren“ verwenden.
- Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.
Um in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable mit dem Namen „Produktdaten abrufen“. Dabei handelt es sich um eine Liste von Produkten. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst die Produktliste zum Beispiel wie folgt in einer Aktion vom Typ „Interne E-Mail senden“ senden:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}Trigger
Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers „Geplante Zeit“. In einem Workflow, der den Trigger „Geplante Zeit“ verwendet, startet der Workflow zu einer von dir angegebenen Zeit und nicht als Ergebnis eines Ereignisses. Da kein bestimmtes Ereignis in deinem Shop oder von einer App den Workflow startet, werden keine Daten automatisch einbezogen.
API-Details
Vorlagen
Produkte mit einem Tag zukünftig zu einer Kollektion hinzufügen
Ruft zu einem zukünftigen Zeitpunkt alle Produkte mit einem bestimmten Tag ab und fügt sie dann einer Kollektion hinzu. Vorlage ansehen
Inaktive Produkte löschen
Löscht Produkte ohne Inventar, die seit einem Jahr nicht mehr aktualisiert wurden. Vorlage ansehen
Produkte mit einem bestimmten Tag zukünftig veröffentlichen
Ruft an einem zukünftigen Datum Produkte mit einem bestimmten Tag ab und veröffentlicht sie. Verwendet den Trigger „Geplante Zeit“ und die Aktion „Produktdaten abrufen“. Vorlage ansehen
Produkt-Tag „neu“ 90 Tage nach Erstellung des Produkts entfernen
Ruft täglich bis zu 100 Produkte ab, die vor mehr als 90 Tagen erstellt wurden und noch immer den Tag „neu“ haben. Der Workflow entfernt diese Tags dann für jedes Produkt. Vorlage ansehen
Entfernen von Produkten aus dem Onlineshop zu einem bestimmten Datum und einer bestimmten Uhrzeit planen
Entfernt zu einem einzigen zukünftigen Datum Produkte aus dem Onlineshop nach Tag, ID oder SKU. Verwendet den Trigger „Geplante Zeit“, die Aktion „Produktdaten abrufen“ und die For-Each-Schleife. Vorlage ansehen
Tägliche E-Mail-Übersicht mit nicht vorrätigen Produkten senden
Ruft täglich alle Produkte mit einem Inventar von 0 ab und sendet eine E-Mail-Übersicht. Verwendet „Produktdaten abrufen“ und den Trigger „Geplante Zeit“. Vorlage ansehen
E-Mail-Benachrichtigung senden, wenn eine Variante mit doppelter SKU hinzugefügt wird
Wenn eine neue Variante hinzugefügt wird, wird geprüft, ob andere Varianten dieselbe SKU verwenden. Wenn ja, wird eine interne E-Mail mit Links zu den betroffenen Produkten und Varianten gesendet. Vorlage ansehen
Im Sale befindliche Produktvarianten mithilfe eines Produkt-Metafelds nachverfolgen
Legt ein Metafeld für ein Produkt fest, wenn mindestens eine seiner Varianten im Sale ist. Dies kann nützlich sein, um nachzuverfolgen, welche Produkte sich aktuell im Sale befinden. Vorlage ansehen