Seitendaten abrufen

In Workflows, die Seitendaten erfordern, kannst du die Aktion Seitendaten abrufen verwenden, um Seiteninformationen aus deinem Shop abzurufen. Seiten sind die Webseiten in deinem Onlineshop, die Informationen enthalten, die sich selten ändern, wie z. B. eine Seite des Typs „Über uns“ oder eine Kontaktseite.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Seitendaten abrufen enthält die folgenden Felder:

In den „Daten abrufen“-Aktionen 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äufigen Abfragen oder wähle Erweitert aus, um deine eigene zu erstellen.

Query-String

Dies ist eine Beispielabfrage zum Abrufen veröffentlichter Seiten:

published_status:published

Die Variable published_status ist ein Filter, der in der Pages query verfügbar ist und mehrmals verwendet oder mit anderen Variablen kombiniert werden kann.

Beim Abfragen von Daten ist es hilfreich zu wissen:

Liste verfügbarer Seitenfilter
Abfragen müssen einer bestimmten Syntax folgen
Die Werte der Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ kannst du die Feldwerte oft in den URLs im Adminbereich finden, 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 ausführen oder testen, indem du die Shopify GraphiQL-App verwendest.
Achte darauf, 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 von 0 bis 100 Ressourcen zurück. Abhängig von deinem Anwendungsfall möchtest du diese Daten möglicherweise auf verschiedene Weise verwenden:

Wenn du jedes Listenelement einzeln verarbeiten 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, beispielsweise um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in den auf diese Aktion folgenden Schritten auf die zurückgegebenen Daten zuzugreifen, verwendest du die Variable namens Seitendaten abrufen, die eine Liste von Seiten ist. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst beispielsweise die Liste von Seiten in einer Aktion vom Typ Interne E-Mail senden ähnlich wie im Folgenden senden:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% 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 festgelegten Zeit und nicht als Ergebnis eines Ereignisses. Da es kein spezifisches Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch einbezogen.

API-Referenz

Weitere Informationen zu der in dieser Aktion verwendeten API findest du unter Pages query.