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.
På denne side
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:
Felt | Beskrivelse |
---|---|
Sortér data efter | Påkrævet. De parametre, som de data der returneres af søgeforespørgslen, sorteres efter. |
Det maksimale antal resultater | Påkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan returnere op til 100 ad gangen. |
Forespørgsel | På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:
- Liste over tilgængelige metaobjektfiltre.
- Hvis du laver en forespørgsel efter metaobjekter med en feltværdi, skal filtrering være aktiveret for metaobjekter. Dette kan du aktivere i Shopify- administratorindstillingerne for tilpassede data. - Forespørgsler skal følge en bestemt syntaks
- Værdierne for forespørgselsfeltet er ikke altid dokumenteret. I nogle tilfælde kan du finde værdierne ved at kigge i API-dokumenterne. Du kan ofte også finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. gerne vil finde værdier for ordreforespørgsler, skal du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.
- Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
- Vær opmærksom på, hvad der sker, hvis forespørgslen mislykkes. API’en returnerer ofte alle resultater (i stedet for ingen).
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.