Metaobjectvermeldingen ophalen

Met de actie Metaobjectitems ophalen kun je een lijst met items voor een metaobject uit je winkel ophalen op basis van de optionele query. Zie de metaobjectendocumentatie voor meer informatie.

Configuratie

Velden

De actie Metaobjectitems ophalen bevat een vervolgkeuzelijst voor het opgeven van de metaobjectdefinitie en de volgende velden, die worden gebruikt om de query op te bouwen:

Velden die worden gebruikt in de acties Gegevens ophalen.
VeldBeschrijving
Gegevens sorteren opVereist. De parameters die bepalen hoe de gegevens die door de zoekquery zijn opgehaald gesorteerd worden.
Maximaal aantal resultatenVereist. Het maximumaantal resultaten dat kan worden geretourneerd door de zoekquery die je selecteert. Je kunt er maximaal 100 tegelijk retourneren.
QueryVereist. Kies uit veelgebruikte query's of selecteer Geavanceerd om een eigen query te maken.

Tekenreeks query

Dit is een voorbeeldquery voor het ophalen van metaobjectvermeldingen als de waarde van een email -veld overeenkomt met het e-mailadres op een bestelling:

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

Dit is een voorbeeldquery voor het ophalen van metaobjectvermeldingen die de afgelopen dag zijn bijgewerkt:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

De variabele updated_at is een filter dat beschikbaar is in de query metaobjecten. Je kunt deze variabele meerdere keren gebruiken of combineren met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar in workflows die de trigger Gepland tijdstip gebruiken. De Liquid-tag date_minus is een speciale Flow-tag waarmee je tijd van een datum kunt aftrekken.

Bij het opvragen van gegevens is het volgende handig om te weten:

Geretourneerde gegevens

Alle acties Gegevens ophalen retourneren een lijst met tussen de 0 en 100 bronnen. Afhankelijk van waarvoor de lijst bedoeld is, kun je deze gegevens op verschillende manieren gebruiken:

  • Als je elk artikel in de lijst afzonderlijk wilt verwerken, bijvoorbeeld om een tag voor elk toe te voegen, kun je de actie Voor elk gebruiken.
  • Als je gegevens wilt verzamelen, zoals het aantal geretourneerde resultaten, kun je de actie Aantal of Som gebruiken.
  • Als je de lijst wilt exporteren, bijvoorbeeld voor het verzenden van een e-mail met alle artikelen, kun je geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die volgen op deze actie, gebruik je de variabele Metaobjectvermeldingen ophalen. Dit is een lijst met metaobjectvermeldingen. Je kunt deze variabele zowel in voorwaarden als in acties gebruiken. Je kunt bijvoorbeeld de lijst met sleutelwaardeparen voor de metaobjectvermeldingen in de actie Stuur interne e-mail als volgt verzenden:

{% 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 %}

Triggers

Je kunt deze actie in elke workflow gebruiken, waaronder de trigger*Geplande tijd. In een workflow met de trigger **Geplande tijd* begint de workflow op een tijd die je hebt opgegeven in plaats van als reactie op een gebeurtenis. Gegevens worden niet automatisch opgenomen omdat er geen specifieke gebeurtenis in je winkel of een app is waardoor de workflow start.

API-gegevens

Zat het antwoord dat je zocht er niet bij? Wij helpen je graag verder.