Hent produktdata
I workflows, der bruger produktdata, kan du bruge handlingen Hent produktdata til at hente produktoplysninger fra din butik.
Konfiguration
Felter
Handlingen Hent produktdata indeholder følgende felter, som bruges til at opbygge forespørgslen:
| Felt | Beskrivelse |
|---|---|
| Sortér data efter | Påkrævet. De parametre, som de data, der returneres af søgeforespørgslen, sorteres efter. |
| Maksimalt antal resultater | Påkrævet. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. 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 til at hente produkter, der blev opdateret den seneste dag:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variablen updated_at er et filter, der er tilgængeligt i produktforespørgslen, og den kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tid. Liquid-tagget date_minus er et særligt Flow-tag, som giver dig mulighed for at trække tid fra en dato.
Når du forespørger på data, er det nyttigt at vide:
- Liste over tilgængelige produktfiltre
- Forespørgsler skal følge en bestemt syntaks
- Værdier for forespørgselsfelter er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle værdier for ordrerforespørgsler, kan 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 din forespørgsel mislykkes. Ofte returnerer API'en alle resultater (i stedet for ingen).
Returnerede data
Alle Hent data-handlinger returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsestilfælde kan du bruge disse data på forskellige måder:
- Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at tilføje et tag til hvert element, kan du bruge handlingen For hvert.
- Hvis du har brug for at samle data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
- Hvis du har brug for at vise listen som output, f.eks. for at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.
Hvis du vil have adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen med navnet Hent produktdata, som er en liste over produkter. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over produkter i en Send intern mail-handling som denne:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}Udløsere
Du kan bruge denne handling i ethvert workflow, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, du har angivet, i stedet for som et resultat af en hændelse. Da der ikke er en specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk nogen data.
API-oplysninger
Skabeloner
Føj produkter med et tag til en kollektion på et senere tidspunkt
På et senere tidspunkt skal du hente alle produkter med et bestemt tag og derefter føje dem til en kollektion. Se skabelon
Slet inaktive produkter
Slet produkter uden lagerbeholdning, der ikke er blevet opdateret i et år. Se skabelon
Udgiv produkter med et bestemt tag på et senere tidspunkt
På en fremtidig dato skal du hente produkter med et bestemt tag og udgive dem. Bruger udløseren Planlagt tidspunkt og handlingen Hent produktdata. Se skabelon
Fjern “nyt”-produkttag 90 dage efter, at produktet blev oprettet
Hver dag hentes op til 100 produkter, der er oprettet for mere end 90 dage siden, og som stadig har tagget “nyt”. Workflowet fjerner derefter disse tags for hvert produkt. Se skabelon
Planlæg, at produkter skal fjernes fra webshoppen på en bestemt dato og et bestemt tidspunkt
På en enkelt fremtidig dato kan du fjerne produkter fra webshoppen efter tag, id eller SKU. Gør brug af udløseren Planlagt tidspunkt, handlingen Hent produktdata og For hvert-loop. Se skabelon
Send dagligt mailresume med produkter, der ikke er på lager
Hver dag hentes alle produkter med 0 i lagerbeholdning, og der sendes et mailresume. Bruger Hent produktdata og udløseren Planlagt tidspunkt. Se skabelon
Send mailnotifikation, når der tilføjes en variant med en duplikeret SKU
Når en ny variant tilføjes, tjekkes det, om andre varianter bruger den samme SKU. Hvis det er tilfældet, sendes der en intern mail med links til de berørte produkter og varianter. Se skabelon
Spor produktvarianter, der er på udsalg, ved hjælp af et produktmetafelt
Angiver et metafelt for et produkt, hvis mindst én af dets varianter er på udsalg. Dette kan være nyttigt til at spore, hvilke produkter der i øjeblikket er på udsalg. Se skabelon