Zeitpläne anwenden, Daten abrufen und Schleifen durchlaufen
In den meisten Fällen kannst du einen Workflow erstellen, indem du mehrere Bedingungen und Aktionen mit einem Trigger verknüpfst, der beim Eintritt eines Ereignisses ausgeführt wird. In einigen Anwendungsfällen gibt es u. U. keinen Trigger für die Aktion, die du ausführen möchtest. Es kann auch vorkommen, dass du die Aktion zu einem bestimmten Zeitpunkt ausführen oder mit einer Liste von Daten arbeiten musst.
Nehmen wir zum Beispiel an, du möchtest eine tägliche Übersicht der nicht ausgeführten Bestellungen erhalten. Mit dieser Gruppe von Funktionen kannst du einen Workflow verwenden, der jeden Tag zu einer bestimmten Zeit ausgeführt wird, um die Bestellungen abzurufen und anschließend eine Übersicht der Bestellungen an dich zu senden.
In dieser Dokumentation erfährst du mehr über den Trigger "Geplanter Zeitpunkt", über die Aktionen vom Typ "Daten abrufen" sowie über die Aktion "Für jeden". Wenn du dir nicht sicher bist, wie du diese Funktionen am besten einsetzt, kannst du weitere Beispiele und Vorlagen zurate ziehen, die diese Trigger und Aktionen verwenden, oder dieses Erklärungsvideo wiedergeben.
Auf dieser Seite
Trigger "Geplanter Zeitpunkt"
Anstatt aufgrund eines Ereignisses einen Workflow zu starten, startet der Trigger Geplanter Zeitpunkt einen Workflow zu einer von dir angegebenen Uhrzeit an einem bestimmten Datum. Du kannst den Workflow auch so planen, dass er stündlich, täglich, wöchentlich oder monatlich ausgeführt wird. Wenn du einen Zeitplan verwendest, musst du zur Verwendung von Daten wie Kunden, Bestellungen oder Produkten eine Aktion verwenden, die diese Daten abruft. Dies ist möglich, indem du Aktionen vom Typ Daten abrufen verwendest.
Aktionen vom Typ "Daten abrufen"
Die meisten Aktionen ändern etwas in deinem Shop (z. B. wird einem Kunden ein Tag hinzugefügt) oder senden einen Befehl an eine App (z. B. wird eine App angewiesen, eine Push-Benachrichtigung an einen Kunden zu senden).
Datenabrufaktionen entnehmen Daten aus deinem Shop, um sie in Flow zu verwenden. Diese Aktionen lösen eine Abfrage mit einer Reihe von Filtern aus, um beispielsweise nur Daten zu Elementen zu erhalten, die innerhalb des letzten Tages aktualisiert wurden. Die Aktion gibt eine Liste mit Daten zurück, die mit diesen Daten übereinstimmen. Die Aktion Bestelldaten abrufen ruft beispielsweise die Abfrage für Bestellungen in der Admin API auf und gibt eine Liste von Bestellungen zurück, die deiner Abfrage entsprechen.
Die folgenden Aktionen rufen Informationen aus deinem Shop ab, damit du diese Daten in deinem Workflow verwenden kannst. Überprüfe jede Aktion daraufhin, wie du Daten filtern kannst und welche Daten zurückgegeben werden:
- Kategoriedaten abrufen
- Kundendaten abrufen
- Bestellentwurfsdaten abrufen
- Fulfillment-Bestelldaten abrufen
- Bestelldaten abrufen
- Produktdaten abrufen
- Produktvariantendaten abrufen
- Abonnementvertragsdaten abrufen
Liquid-Tags
Wenn du eine Aktion vom Typ Daten abrufen mit Datumsangaben verwendest, kannst du die Liquid-Tags date_minus und date_plus verwenden, um die Datumsangaben in deiner Abfrage zu ändern. Um beispielsweise ein Datum zu berechnen, das 5 Tage vor der geplanten Ausführungszeit eines Workflows liegt, kannst du den folgenden Liquid-Code verwenden:
{{ scheduledAt | date_minus: "5 days" }}Weitere Informationen zur Verwendung dieser Tags findest du in der Dokumentation zu den Liquid-Variablen.
Schleifen
Wenn du eine Aktion vom Typ Daten abrufen verwendest, erhältst du eine Liste mit Daten, die deiner Abfrage entsprechen. Du kannst die Aktion Für jeden verwenden, um diese Liste in einer Schleife zu durchlaufen. In einer Für-jeden-Schleife kannst du Bedingungen und Aktionen verwenden, die nur für dieses Element gelten.
Du kannst beispielsweise einen Workflow erstellen, der die Aktion Bestelldaten abrufen enthält. Du kannst die Aktion Für jeden dann nutzen, um jeder Bestellung ein Tag hinzuzufügen.
Aggregationsaktionen
Wenn du mit Listen arbeitest, möchtest du möglicherweise die Anzahl der Elemente zählen, um sie später in Bedingungen und Aktionen zu verwenden. Eventuell möchtest du vor dem Senden einer E-Mail überprüfen, ob mehr als 0 Ergebnisse vorhanden sind. Flow stellt die folgenden Aktionen bereit, um Berechnungen mit Listendaten in einem Workflow durchzuführen:
- Zählen – gibt die Anzahl der Einträge in einer Liste zurück
- Summieren – addiert die Werte von Einträgen in einer Liste
Bekannte Einschränkungen
- Aktionen vom Typ "Daten abrufen" und "Für jeden" können nur auf Listen mit bis zu 100 Elementen angewendet werden.