Hämta metaobjektposter

Du kan använda åtgärden Hämta metaobjektposter för att hämta en lista med poster för ett metaobjekt från din butik baserat på den valfria frågan. Se metaobjektdokumentationen för mer information.

Konfiguration

Fält

Åtgärden Hämta metaobjektposter innehåller en rullgardinsmeny för att ange metaobjektdefinitionen samt följande fält, som används för att skapa frågan:

Frågesträng

Det här är en exempelsökfråga för att hämta metaobjektposter om värdet i ett e-postfält matchar e-postadressen i en order:

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

Det här är en exempelsökfråga för att hämta metaobjektposter som uppdaterades under det senaste dygnet:

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

Variabeln updated_at är ett filter som är tillgängligt för metaobjektsökfrågan och kan användas flera gånger eller kombineras med andra variabler. Liquid-variabeln scheduledAt är tillgänglig i arbetsflöden som använder utlösaren Schemalagd tid. Liquid-taggen date_minus är en särskild Flow-tagg som gör att du kan subtrahera tid från ett datum.

När du gör sökfrågor för data kan det vara bra att veta följande:

• Lista över tillgängliga metaobjektfilter
• Sökning av metaobjekt efter fältvärde kräver att metaobjektet har filtrering aktiverad, vilket kan aktiveras i alternativen för anpassade data i Shopify admin.
• Sökfrågor måste följa en viss syntax
• Fältvärden för sökfrågor är inte alltid dokumenterade. I vissa fall kan värdena hittas i API-dokumentationen. Alternativt kan du ofta hitta fältvärdena i URL:erna i adminpanelen när du filtrerar. Om du till exempel vill hitta några sökfrågevärden för ordrar kan du filtrera sidan Ordrar i adminpanelen och sedan kontrollera URL:en.
• Du kan köra eller testa en sökfråga i din butik med hjälp av Shopify GraphiQL-appen.
• Tänk på vad som händer om din sökfråga misslyckas. Ofta returnerar API:et alla resultat (i stället för inga alls).

Returnerade data

Alla åtgärder för att hämta data returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kanske du vill använda dessa data på olika sätt:

• Om du behöver hantera varje artikel i listan individuellt, till exempel för att lägga till en tagg för varje, kan du använda åtgärden För varje.
• Om du behöver aggregera data, till exempel räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
• Om du behöver mata ut listan, till exempel skicka ett e-postmeddelande med alla artiklar, kan du använda returnerad data direkt i efterföljande åtgärder.

För att komma åt returnerade data i steg som följer efter den här åtgärden använder du variabeln Hämta metaobjektposter, som är en lista med metaobjektposter. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över nyckel-värdepar för metaobjektposterna i en Skicka internt e-postmeddelande-åtgärd så här:

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

Utlösare

Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren Schemalagd tid. I ett arbetsflöde som använder utlösaren Schemalagd tid startar arbetsflödet vid en tidpunkt som du har angett, i stället för som ett resultat av en händelse. Eftersom det inte finns någon specifik händelse i din butik eller från en app som startar arbetsflödet inkluderas inga data automatiskt.

API-uppgifter

• Metaobjektresurs
• Sökfrågefilter för metaobjekt
• Söka i metaobjekt efter fältvärde