Katalogdaten abrufen

In Workflows, die Katalogdaten erfordern, kannst du die Aktion Katalogdaten abrufen verwenden, um B2B-Kataloginformationen aus deinem Shop abzurufen. Kataloge sind Gruppen von Produkten mit individueller Preisgestaltung für bestimmte B2B-Kund:innen oder Unternehmenssitze.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Katalogdaten abrufen enthält die folgenden Felder:

Felder, die in den Aktionen vom Typ „Daten abrufen“ 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 Ergebnisse gleichzeitig zurückgeben.
Abfrage	Erforderlich. Wähle aus gängigen Abfragen oder wähle Erweitert, um eine eigene zu erstellen.

Query-String

Dies ist ein Beispiel für eine Abfrage, um alle aktiven Kataloge abzurufen:

status:ACTIVE

Die Variable status ist ein Filter, der in der Kataloge-Abfrage verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann.

Beim Abfragen von Daten ist Folgendes hilfreich zu wissen:

Liste der verfügbaren Katalogfilter
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 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.
Denke daran, 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 Arten nutzen:

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, 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 auf diese Aktion folgenden Schritten auf die zurückgegebenen Daten zuzugreifen, verwendest du die Variable Katalogdaten abrufen, die eine Liste von Katalogen darstellt. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. So kannst du beispielsweise die Liste der Kataloge in einer Aktion Interne E-Mail senden senden, die etwa so aussieht:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% 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 bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, sind keine Daten automatisch enthalten.

API-Referenz

Weitere Informationen über die in dieser Aktion verwendete API findest du in der Kataloge-Abfrage.