Hilfe
Einloggen

Unternehmenssitzdaten abrufen

In Workflows, die Unternehmenssitzdaten verwenden, kannst du die Aktion „Unternehmenssitzdaten abrufen“ nutzen, um Informationen zu Unternehmenssitzen aus deinem Shop abzurufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion „Unternehmenssitzdaten abrufen“ enthält die folgenden Felder, die zur Erstellung der Abfrage verwendet werden:

In den „Daten abrufen“-Aktionen verwendete Felder.
FeldBeschreibung
Daten sortieren nachErforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an ErgebnissenErforderlich. Die maximale Anzahl an Ergebnissen, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 auf einmal zurückgeben lassen.
AbfrageErforderlich. Wähle aus allgemeinen Abfragen aus oder wähle Erweitert aus, um deine eigene Abfrage zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage, um Unternehmenssitze 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 für die Abfrage von Unternehmenssitzen 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 Filter für Unternehmenssitze
  • 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 Abfragewerte für Bestellungen 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 „Daten abrufen“-Aktionen 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 jeden Listenartikel einzeln verarbeiten musst, z. B. um für jeden 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 „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 Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable namens Get company location data, bei der es sich um eine Liste von Unternehmenssitzen handelt. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Zum Beispiel kannst du die Liste der Standorte in einer Aktion „Interne E-Mail senden“ wie folgt senden:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.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 festgelegten 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-Referenz