Pridobi podatke o osnutku naročila
V potekih dela, ki uporabljajo podatke o osnutku naročila, lahko z dejanjem Pridobi podatke o osnutku naročila iz trgovine pridobite informacije o osnutku naročila.
Konfiguracija
Polja
Dejanje Pridobi podatke o osnutku naročila vsebuje naslednja polja, ki se uporabljajo za ustvarjanje poizvedbe:
| Polje | Opis |
|---|---|
| Razvrsti podatke po | Obvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba. |
| Največje število rezultatov | Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat je mogoče vrniti do 100 rezultatov. |
| Poizvedba | Obvezno. Izberite med pogostimi poizvedbami ali pa izberite Napredno, da ustvarite svojo. |
Niz poizvedbe
To je primer poizvedbe za pridobivanje osnutkov naročil, ki so bili posodobljeni v zadnjem dnevu:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Spremenljivka updated_at je filter, ki je na voljo v poizvedbi za osnutke naročil, in se lahko uporabi večkrat ali kombinira z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki so uporabili sprožilec Razporejen čas. Oznaka Liquid date_minus je posebna oznaka za Flow, ki omogoča odštevanje časa od datuma.
Pri poizvedovanju po podatkih je dobro vedeti:
- Seznam razpoložljivih filtrov za naročila
- Poizvedbe morajo upoštevati določeno sintakso
- Vrednosti polj poizvedb niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji API-ja. Poleg tega lahko vrednosti polj pogosto najdete v URL-naslovih v skrbniški plošči, ko filtrirate vsebino. Da bi na primer našli nekatere vrednosti poizvedbe za Naročila, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
- Poizvedbo v trgovini lahko zaženete ali preizkusite z aplikacijo Shopify GraphiQL.
- Bodite pozorni na to, kaj se zgodi, če poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).
Vrnjeni podatki
Vsa dejanja Pridobi podatke vrnejo seznam od 0 do 100 virov. Odvisno od primera uporabe lahko te podatke uporabite na različne načine:
- Če morate obravnavati vsak element seznama posamično, na primer tako, da vsakemu dodate oznako, lahko uporabite dejanje Za vsakega.
- Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanja Preštej ali Seštej.
- Če morate izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko uporabite vrnjene podatke neposredno v naslednjih dejanjih.
Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko Pridobi podatke osnutka naročila, ki predstavlja seznam osnutkov naročil. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam osnutkov naročil lahko na primer pošljete v dejanju Pošlji interno e-pošto na naslednji način:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Sprožilci
To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Razporejen čas. V poteku dela, ki uporablja sprožilec Razporejen čas, se potek dela začne ob času, ki ste ga določili, in ne kot rezultat dogodka. Ker v vaši trgovini ali aplikaciji ni specifičnega dogodka, ki bi zagnal potek dela, se podatki ne vključijo samodejno.
Podrobnosti API-ja
Predloge
Pošiljanje dnevnega obvestila z vsemi odprtimi osnutki naročil
Vsak dan pridobi odprte osnutke naročil, jih prešteje in pošlje sporočilo v Slack. Uporablja sprožilec Razporejen čas ter dejanji Pridobi osnutke naročil in Preštej. Prikaži predlogo