Standortdaten abrufen

In Workflows, die Standortdaten erfordern, kannst du die Aktion Standortdaten abrufen verwenden, um Standortinformationen aus deinem Shopify-Shop abzurufen. Standorte sind alle Orte, an denen du Inventar lagerst, Produkte verkaufst oder Bestellungen versendest oder ausführst.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Standortdaten 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 von der 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 auf einmal zurückgeben lassen.
Abfrage	Erforderlich. Wähle aus allgemeinen Abfragen aus oder wähle Erweitert, um deine eigene zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage, um Standorte abzurufen, für die die Abholung im Geschäft aktiviert ist:

pickup_in_store:enabled

Die Variable pickup_in_store ist ein Filter, der in der Standortabfrage verfügbar ist. Er kann mehrmals verwendet oder mit anderen Variablen kombiniert werden.

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

Liste der verfügbaren Standortfilter
Abfragen müssen einer bestimmten Syntax folgen
Die Werte für Abfragefelder 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 Bestellabfragen 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. Abhängig von deinem Anwendungsfall möchtest du diese Daten möglicherweise auf verschiedene Weisen verwenden:

Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes einen Tag hinzuzufügen, kannst du die Aktion Für jede verwenden.
Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Anzahl oder Summe 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 Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable mit dem Namen Standortdaten abrufen, die eine Liste von Standorten ist. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst beispielsweise die Liste der Standorte in einer Aktion vom Typ Interne E-Mail senden wie folgt senden:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% 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 es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch einbezogen.

API-Referenz

Weitere Informationen über die in dieser Aktion verwendete API findest du in der Standortabfrage.