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:

Polja, uporabljena v dejanjih Pridobi podatke.
PoljeOpis
Razvrsti podatke poObvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatovObvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat je mogoče vrniti do 100 rezultatov.
PoizvedbaObvezno. 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