Dohvaćanje podataka o skici narudžbe
U tijekovima rada koji upotrebljavaju podatke o skici narudžbe, radnju Dohvaćanje podataka o skici narudžbe možete upotrijebiti za dohvaćanje informacija o skici narudžbe iz svoje trgovine.
Konfiguracija
Polja
Radnja Dohvaćanje podataka o skici narudžbe sadrži sljedeća polja, koja se upotrebljavaju za izradu upita:
| Polje | Opis |
|---|---|
| Razvrstaj podatke po | Obavezno. Parametri prema kojima se razvrstavaju podaci koje je vratio upit za pretraživanje. |
| Maksimalan broj rezultata | Obavezno. Maksimalan broj rezultata koje odabrani upit za pretraživanje može vratiti. Odjednom možete vratiti do 100 rezultata. |
| Upit | Obavezno. Odaberite neki od uobičajenih upita ili odaberite opciju Napredno da biste izradili vlastiti. |
Niz upita
Ovo je primjer upita za dohvaćanje skica narudžbi koje su ažurirane u proteklom danu:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Varijabla updated_at filtar je dostupan za upit skica narudžbi i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada u kojima se upotrebljava pokretač Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za Shopify Flow koja vam omogućuje oduzimanje vremena od datuma.
Pri slanju upita za podatke korisno je znati sljedeće:
- Popis dostupnih filtara za narudžbe
- Upiti moraju slijediti određenu sintaksu
- Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima vrijednosti mogu pronaći pregledom API dokumentacije. Alternativno, vrijednosti polja često možete pronaći u URL-ovima na administratorskoj ploči tijekom filtriranja. Na primjer, da biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe na administratorskoj ploči i zatim provjerite URL.
- Upit u svojoj trgovini možete pokrenuti ili testirati pomoću aplikacije Shopify GraphiQL.
- Pripazite na to što se događa ako vaš upit ne uspije. Često će API vratiti sve rezultate (umjesto nijednog).
Vraćeni podaci
Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možete upotrijebiti na različite načine:
- Ako trebate pojedinačno obraditi svaku stavku na popisu, primjerice, kako biste svakoj dodali oznaku, možete upotrijebiti radnju Za svaki.
- Ako trebate agregirati podatke, primjerice, kako biste prebrojili koliko je rezultata vraćeno, možete upotrijebiti radnje Prebroji ili Zbroji.
- Ako trebate ispisati popis, primjerice, kako biste poslali e-poruku sa svim stavkama, vraćene podatke možete izravno upotrijebiti u sljedećim radnjama.
Za pristup vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu Dohvati podatke o skici narudžbe, koja sadrži popis skica narudžbi. Ovu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis skica narudžbi možete poslati putem radnje Pošalji internu e-poruku ovako:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Pokretači
Ovu radnju možete upotrijebiti u svakom tijeku rada, uključujući onaj s pokretačem Zakazano vrijeme. U tijeku rada koji koristi pokretač Zakazano vrijeme tijek rada započinje u vrijeme koje ste naveli, a ne kao rezultat nekog događaja. Budući da ne postoji određeni događaj u vašoj trgovini ili iz aplikacije koji pokreće tijek rada, podaci se ne uključuju automatski.
Pojedinosti o API-ju
Predlošci
Pošaljite dnevnu obavijest sa svim otvorenim skicama narudžbi
Svaki dan dohvatite otvorene skice narudžbi, prebrojite ih i pošaljite poruku na Slacku. Upotrebljava pokretač Zakazano vrijeme i radnje Dohvati skice narudžbi te Prebroji. Prikaži predložak