Pridobi podatke o članku

V potekih dela, ki zahtevajo podatke o članku v blogu, lahko za pridobivanje informacij o članku iz svoje trgovine Shopify uporabite dejanje Pridobi podatke o članku.

Opomba

To je vrsta dejanja za Pridobivanje podatkov. Če želite razumeti, kako uporabljati to vrsto dejanja s sprožilcem Načrtovani čas in zankami For each, glejte razdelek Urniki, pridobivanje podatkov in poteki dela z zankami v aplikaciji Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o članku vsebuje naslednja polja:

Polja, uporabljena v dejanjih za pridobivanje podatkov.

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 iskalna poizvedba, ki jo izberete. Hkrati se lahko vrne do 100 rezultatov.
Poizvedba	Obvezno. Izberite med pogostimi poizvedbami ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje člankov, objavljenih v preteklem dnevu:

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

Spremenljivka published_at je filter, ki je na voljo v poizvedbi o člankih, in ga lahko uporabite večkrat ali v kombinaciji z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki uporabljajo sprožilec Načrtovani čas. Oznaka Liquid date_minus je posebna oznaka Flow, ki vam omogoča, da od datuma odštejete čas.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov za članke

• Poizvedbe morajo slediti določeni sintaksi

• Vrednosti polj za poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete tako, da si ogledate dokumentacijo API-ja. Druga možnost je, da vrednosti polj pogosto najdete v URL-naslovih v skrbniški plošči, ko filtrirate vsebino. Če želite na primer poiskati nekatere vrednosti za poizvedbo o naročilu, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.

• S pomočjo aplikacije Shopify GraphiQL lahko izvedete ali preskusite poizvedbo v svoji trgovini.

• Bodite pozorni na to, kaj se zgodi, če vaša poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja za Pridobivanje podatkov vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe boste te podatke morda želeli uporabiti na različne načine:

• Če morate vsak element seznama obravnavati posamezno, na primer tako, da za vsakega dodate oznako, lahko uporabite dejanje For each.
• Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanja Count (Štetje) ali Sum (Seštevek).
• Če želite 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 o članku, ki predstavlja seznam člankov. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam člankov lahko na primer pošljete v dejanju Pošiljanje notranje e-pošte, podobnem temu:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Opomba

Če se dejanje Pridobi podatke v enem poteku dela uporabi večkrat, se imenu spremenljivke doda številka. Na primer, v poteku dela, ki dejanje Pridobi podatke o naročilu uporabi dvakrat, je prva spremenljivka za vrnjene podatke getOrderData, druga spremenljivka pa getOrderData1. Tega imena ni mogoče prilagoditi.

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovan čas. V poteku dela, ki uporablja sprožilec Načrtovan čas, se potek dela začne ob času, ki ste ga določili, in ne kot rezultat dogodka. Ker v vaši trgovini ali iz aplikacije ni nobenega posebnega dogodka, ki bi začel potek dela, podatki niso samodejno vključeni.

Referenca za API

Za več informacij o API-ju, uporabljenem v tem dejanju, si oglejte poizvedbo Articles.