Metaobjekt-Einträge abrufen

Du kannst die Aktion Metaobjekt-Einträge abrufen verwenden, um basierend auf der optionalen Abfrage eine Liste von Einträgen für ein Metaobjekt aus deinem Shop abzurufen. Weitere Informationen findest du in der Metaobjekte-Dokumentation.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Metaobjekt-Einträge abrufen enthält ein Dropdown-Menü zur Angabe der Metaobjekt-Definition sowie die folgenden Felder, die zum Erstellen der Abfrage verwendet werden:

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 eine der allgemeinen Abfragen aus oder wähle Erweitert, um eine eigene zu erstellen.

Abfrage-String

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

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

Dies ist eine Beispielabfrage zum Abrufen von Metaobjekteinträgen, 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 Metaobjektabfrage 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.

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

Liste der verfügbaren Metaobjektfilter
Für das Abfragen von Metaobjekten nach Feldwert muss für das Metaobjekt das Filtern aktiviert sein. Dies kann im Shopify-Adminbereich in den Optionen für benutzerdefinierte Daten aktiviert werden.
Abfragen müssen einer bestimmten Syntax folgen
Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen können die Werte in der API-Dokumentation nachgelesen werden. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, 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 (anstatt keine).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten vielleicht auf unterschiedliche Weise verwenden:

Wenn du jeden Artikel in der Liste einzeln bearbeiten musst, um beispielsweise für jeden einen 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 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 den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable namens Metaobjekteinträge abrufen. Dies ist eine Liste von Metaobjekteinträgen. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst beispielsweise die Liste der Schlüssel-Wert-Paare für die Metaobjekteinträge in einer Aktion vom Typ 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 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 eingeschlossen.