Pridobi podatke o strani

V potekih dela, ki zahtevajo podatke o strani, lahko uporabite dejanje Pridobi podatke o strani, da pridobite informacije o strani iz svoje trgovine. Strani so spletne strani v vaši spletni trgovini, ki vsebujejo informacije, ki se redko spreminjajo, kot sta stran »O nas« ali stran za stik.

Opomba

To je vrsta dejanja Pridobi podatke. Da bi razumeli, kako uporabiti to vrsto dejanja s sprožilcem Načrtovan čas in zankami Za vsakega, si oglejte Urniki, pridobivanje podatkov in zanke v potekih dela v aplikaciji Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o strani vsebuje naslednja polja:

Polja, uporabljena v dejanjih »Pridobi podatke«.

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 lahko vrnete do 100 rezultatov.
Poizvedba	Obvezno. Izbirajte med pogostimi poizvedbami ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje objavljenih strani:

published_status:published

Spremenljivka published_status je filter, ki je na voljo v poizvedbi o straneh, in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov strani

• Poizvedbe morajo slediti določeni sintaksi

• Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji za API. Pogosto lahko vrednosti polj najdete tudi v URL-naslovih v skrbniški plošči, ko uporabite filtre. Če želite na primer poiskati nekatere vrednosti poizvedb za naročilo, filtrirajte stran »Naročila« v skrbniški plošči in nato preverite URL-naslov.

• Poizvedbo v svoji trgovini lahko zaženete ali preizkusite z aplikacijo Shopify GraphiQL.

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

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam z od 0 do 100 viri. Odvisno od vašega primera uporabe boste morda želeli te podatke uporabiti na različne načine:

• Če morate vsak element seznama obravnavati posamezno, na primer za dodajanje oznake za vsakega posebej, lahko uporabite dejanje Za vsakega.
• Če morate združiti podatke, na primer prešteti število vrnjenih rezultatov, lahko uporabite dejanje Preštej ali Seštej.
• Če morate izpisati seznam, na primer poslati e-pošto z vsemi kosi, lahko vrnjene podatke uporabite neposredno v nadaljnjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Get page data, ki predstavlja seznam strani. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Na primer, seznam strani lahko pošljete v dejanju Send internal email, ki je podobno temu:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Opomba

Če je dejanje Pridobi podatke v enem poteku dela uporabljeno večkrat, se imenu spremenljivke doda številka. V poteku dela, ki na primer dvakrat uporabi dejanje Pridobi podatke o naročilu, 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 določenega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.

Referenca za API

Za več informacij o API-ju, uporabljenem v tem dejanju, glejte poizvedbo o straneh.