Hangi lehe andmed

Töövoogudes, mis nõuavad lehe andmeid, saad kasutada toimingut Hangi lehe andmed, et hankida oma poest lehe teavet. Lehed on e-poe veebilehed, mis sisaldavad harva muutuvat teavet, nagu leht Meist või Kontakt.

Märkus

See on Hangi andmed tüüpi toiming. Et mõista, kuidas seda tüüpi toimingut kasutada käivitajaga Ajastatud aeg ja tsüklitega For each, vaata jaotist Ajastused, andmete hankimine ja tsüklitega töövood lahenduses Shopify Flow.

Konfiguratsioon

Väljad

Toiming Hangi lehe andmed sisaldab järgmisi välju:

Toimingutes Hangi andmed kasutatavad väljad.

Väli	Kirjeldus
Sordi andmed:	Nõutav. Parameetrid, mille järgi otsingupäringu tagastatud andmeid sorditakse.
Tulemuste maksimaalne arv	Nõutav. Maksimaalne tulemuste arv, mida valitud otsingupäring saab tagastada. Korraga saab tagastada kuni 100 tulemust.
Päring	Nõutav. Vali levinud päringute hulgast või vali oma päringu loomiseks Täpsem.

Päringusõne

See on näidispäring avaldatud lehtede hankimiseks:

published_status:published

Muutuja published_status on filter, mis on saadaval lehtede päringus ja seda saab kasutada mitu korda või kombineerida teiste muutujatega.

Andmete pärimisel on kasulik teada järgmist.

• Saadaolevate lehefiltrite loend

• Päringud peavad järgima kindlat süntaksit

• Päringuväljade väärtused ei ole alati dokumenteeritud. Mõnel juhul leiab väärtused, kui vaadata API dokumentatsiooni. Alternatiivina leiad sageli väljaväärtused admini URL-idest, kui kasutad filtreid. Näiteks, et leida mõningaid tellimuse päringu väärtusi, filtreeri adminis lehte Tellimused ja kontrolli seejärel URL-i.

• Päringut saad oma poes käivitada või testida, kasutades rakendust Shopify GraphiQL.

• Pane tähele, mis juhtub, kui sinu päring ebaõnnestub. Sageli tagastab API (mitte ühegi tulemuse asemel) kõik tulemused.

Tagastatud andmed

Kõik toimingud Hangi andmed tagastavad loendi, mis sisaldab 0 kuni 100 ressurssi. Olenevalt kasutusjuhust võid neid andmeid kasutada mitmel viisil:

• Kui pead iga loendiüksust eraldi töötlema, näiteks lisama igaühele sildi, saad kasutada toimingut For each.
• Kui pead andmeid koondama, näiteks lugema kokku, mitu tulemust tagastati, saad kasutada toiminguid Loe kokku või Summeeri.
• Kui pead loendi väljastama, näiteks saatma e-kirja kõigi üksustega, saad kasutada tagastatud andmeid otse järgnevates toimingutes.

Sellele toimingule järgnevates sammudes tagastatud andmetele juurdepääsemiseks kasuta muutujat nimega Hangi lehe andmed, mis on lehtede loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks saad lehtede loendi saata toiminguga Saada asutusesisene e-kiri sarnaselt sellele:

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

Märkus

Kui toimingut Hangi andmed kasutatakse ühes töövoos mitu korda, lisatakse muutuja nimele number. Näiteks töövoos, kus kasutatakse toimingut Hangi tellimuse andmed kaks korda, on tagastatud andmete esimene muutuja getOrderData ja teine muutuja getOrderData1. Seda nime ei saa kohandada.

Käivitajad

Saad seda toimingut kasutada igas töövoos, sealhulgas käivitajaga Ajastatud aeg. Töövoos, mis kasutab käivitajat Ajastatud aeg, algab töövoog sinu määratud ajal, mitte sündmuse tulemusel. Kuna sinu poes või rakenduses pole kindlat sündmust, mis töövoo käivitab, ei kaasata andmeid automaatselt.

API viide

Lisateavet selles toimingus kasutatud API kohta vaata lehtede päringust.