Hent metaobjektposter

Du kan bruge handlingen Hent metaobjektposter til at hente en liste over poster for et metaobjekt fra din butik baseret på den valgfri forespørgsel. Se dokumentationen til metaobjekter for at få flere oplysninger.

Konfiguration

Felter

Handlingen Hent metaobjektposter indeholder en rullemenu, hvor du kan angive definitionen af metaobjektet samt følgende felter, som bruges til at bygge forespørgslen:

Felter, der bruges i handlinger af typen “Hent data”.
FeltBeskrivelse
Sortér data efterPåkrævet. De parametre, som de data der returneres af søgeforespørgslen, sorteres efter.
Det maksimale antal resultaterPåkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan returnere op til 100 ad gangen.
ForespørgselPåkrævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel, der henter metaobjektposter, hvis værdien i et email-felt matcher mailadressen i en ordre:

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

Dette er et eksempel på en forespørgsel, der henter metaobjektposter, som er blevet opdateret inden for det seneste døgn:

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

Variablen updated_at er et filter, der er tilgængeligt i forespørgslen efter metaobjekter, og den kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i arbejdsgange, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, som giver dig mulighed for at trække tid fra en data.

Når du forespørger om data, er det brugbart at vide:

Returnerede data

Alle handlinger af typen Hent data returnerer en liste over 0-100 ressourcer. Du kan bruge disse data på forskellige måder afhængigt af dit brugsscenarie:

  • Hvis du f.eks. skal håndtere hvert listeelement enkeltvis, f.eks. ved at tilføje et tag for hvert element, kan du bruge handlingen For each.
  • Hvis du skal bruge aggregerede data, f.eks. optællinger af returnerede resultater, kan du bruge handlingerne Antal eller Sum.
  • Hvis du skal sende listen ud, f.eks. ved at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

Hvis du vil tilgå de returnerede data i trin, der følger denne handling, skal du bruge variablen med navnet Hent metaobjektposter, som er en liste over metaobjektposter. Du kan både bruge denne variabel i betingelser og handlinger. Du kan f.eks. sende listen med nøgle/værdi-par for metaobjektposterne i handlingen Send intern mail som denne:

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

Triggere

Du kan bruge denne handling alle workflow, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, som du har angivet, i stedet for som følge af et event. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, inkluderes der ikke nogen data automatisk.

API-detaljer

Kan du ikke finde de svar, du leder efter? Vi er her for at hjælpe.