Artikeldaten abrufen

In Workflows, die Daten für Blog-Artikel erfordern, kannst du die Aktion Artikeldaten abrufen verwenden, um Artikelinformationen aus deinem Shopify-Shop abzurufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Artikeldaten abrufen enthält die folgenden Felder:

In den Aktionen vom Typ „Daten abrufen“ verwendete Felder.
Feld	Beschreibung
Daten sortieren nach	Erforderlich. Die Parameter, nach denen die durch die Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an Ergebnissen	Erforderlich. Die maximale Anzahl von Ergebnissen, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 Ergebnisse auf einmal zurückgeben.
Abfrage	Erforderlich. Wähle aus häufig verwendeten Abfragen aus oder wähle Erweitert, um eine eigene Abfrage zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage für den Abruf von Artikeln, die am letzten Tag veröffentlicht wurden:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Die Variable published_at ist ein Filter, der in der Abfrage von Artikeln verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist in Workflows verfügbar, die den Trigger Geplante Zeit verwenden. Das Liquid-Tag date_minus ist ein spezielles Flow-Tag, mit dem du eine Zeitspanne von einem Datum subtrahieren kannst.

Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:

Liste der verfügbaren Artikelfilter
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 kannst du die Feldwerte häufig in den URLs im Adminbereich finden, wenn du filterst. Um beispielsweise einige Werte für Bestellabfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
Mit der Shopify GraphiQL-App kannst du eine Abfrage in deinem Shop ausführen oder testen.
Beachte, was passiert, wenn deine Abfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstatt keine).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten vielleicht auf verschiedene Weise nutzen:

Wenn du jedes Listenelement einzeln behandeln musst, z. B., um für jedes ein Tag hinzuzufügen, kannst du die Aktion For each verwenden.
Wenn du Daten aggregieren musst, z. B., um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Zählen oder Summieren verwenden.
Wenn du die Liste ausgeben musst, z. B., um eine E-Mail mit allen Elementen 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 Artikeldaten abrufen, die eine Liste von Artikeln ist. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. So kannst du beispielsweise die Liste der Artikel in einer Aktion Interne E-Mail senden senden, die in etwa so aussieht:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, auch beim Trigger Geplante Zeit. In einem Workflow, der den Trigger Geplante Zeit verwendet, startet der Workflow zu einem von dir festgelegten Zeitpunkt und nicht als Ergebnis eines Ereignisses. Da es in deinem Shop oder durch eine App kein bestimmtes Ereignis gibt, das den Workflow startet, sind keine Daten automatisch enthalten.

API-Referenz

Weitere Informationen zur in dieser Aktion verwendeten API findest du unter Abfrage von Artikeln.