Hilfe
Einloggen

Unternehmensdaten abrufen

In Workflows, die Unternehmensdaten verwenden, kannst du die Aktion Unternehmensdaten abrufen verwenden, um Unternehmensinformationen aus deinem Shop abzurufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Unternehmensdaten abrufen enthält die folgenden Felder, die zum Erstellen der Abfrage verwendet werden:

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

Abfrage-String

Dies ist eine Beispielabfrage, um Unternehmen 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 Unternehmensabfrage 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. Das Liquid-Tagdate_minus ist ein spezielles Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.

Bei der Abfrage von Daten ist es hilfreich, Folgendes zu wissen:

  • Liste der verfügbaren Filter für Unternehmen
  • 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 die Bestellungsabfrage 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 (statt gar keiner).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen 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 jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes Element ein Tag hinzuzufügen, kannst du die Aktion Für jedes Element verwenden.
  • Wenn du Daten zusammenfassen musst, beispielsweise um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Count oder Sum verwenden.
  • Wenn du die Liste ausgeben musst, zum Beispiel um eine E-Mail mit allen Artikeln 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 mit dem Namen Get company data. Dies ist eine Liste von Unternehmen. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst zum Beispiel die Liste der Unternehmen in einer Send internal email-Aktion wie folgt senden:

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers Scheduled time. In einem Workflow, der den Trigger Scheduled time 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