Metaobjekteinträge abrufen

Mit der Aktion Metaobjekteinträge abrufen kannst du basierend auf der optionalen Abfrage eine Liste mit Einträgen für ein Metaobjekt aus deinem Shop abrufen. Weitere Informationen findest du in der Dokumentation zu Metaobjekten .

Konfiguration

Felder

Die Aktion Metaobjekteinträge abrufen enthält eine Dropdown-Liste zum Angeben der Metaobjekt-Definition sowie die folgenden Felder, die zum Erstellen der Abfrage verwendet werden:

Felder, die in Aktionen vom Typ "Daten abrufen" verwendet werden
FeldBeschreibung
Daten sortieren nachErforderlich. Der Parameter, gemäß dem die von der Suchabfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl von ErgebnissenErforderlich. Die maximale Anzahl an Ergebnissen, die von der von dir ausgewählten Suchabfrage zurückgegeben werden können. Du kannst bis zu 100 Ergebnisse gleichzeitig zurückgeben.
AbfrageErforderlich. Wähle eine der üblichen Abfragen oder Erweitert aus, um deine eigene Abfrage zu erstellen.

Abfrage-String

Es folgt eine Beispielabfrage zum Abrufen von Metaobjekteinträgen, wenn der Wert eines email-Felds mit der E-Mail-Adresse einer Bestellung übereinstimmt:

{{fields.email}}:"{{order.email}}"

Es folgt eine Beispielabfrage zum Abrufen von Metaobjekteinträgen, die innerhalb des letzten Tages 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 Metaobjekten verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist für Workflows mit dem Trigger Geplanter Zeitpunkt verfügbar. Das Liquid-Tag date_minus ist ein spezielles Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.

Bei der Abfrage von Daten ist Folgendes hilfreich:

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf verschiedene Weise nutzen:

  • Wenn du jedes Listenelement einzeln bearbeiten musst, z. B. um jedem Element ein Tag hinzuzufügen, kannst du die Aktion Für jeden verwenden.
  • Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst die Aktionen Anzahl oder Summe 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 den nachfolgenden Aktionen verwenden.

Verwende die Variable mit der Bezeichnung Metaobjekteinträge abrufen, um in den darauf folgenden Schritten auf die zurückgegebenen Daten zuzugreifen. Bei der Variable handelt es sich um eine Liste der Metaobjekteinträge. Du kannst diese Variable sowohl in Bedingungen als auch für Aktionen verwenden. Beispielsweise kannst du die Liste der Schlüssel-Wert-Paare für die Metaobjekteinträge mit der Aktion Interne E-Mail senden wie folgt senden:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

Trigger

Du kannst diese Aktion in jedem beliebigen Workflow mit dem Trigger Geplanter Zeitpunkt verwenden. In einem Workflow, der den Trigger Geplanter Zeitpunkt verwendet, wird der Workflow nicht als Ergebnis eines Ereignisses gestartet, sondern zu einem von dir angegebenen Zeitpunkt. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, enthält dieser nicht automatisch Daten.

API-Details

Du hast die gesuchten Antworten nicht gefunden? Wir helfen dir gerne weiter.