Hangi artikli andmed

Töövoogudes, mis nõuavad blogiartikli andmeid, saad kasutada toimingut Hangi artikli andmed, et hankida artikliteavet oma Shopify poest.

Märkus

See on Hangi andmed tüüpi toiming. Teavet selle toimingutüübi kasutamise kohta käivitajaga Ajastatud aeg ja tsüklitega For each leiad jaotisest Ajakavad, andmete hankimine ja tsüklitega töövood Shopify Flow's.

Konfiguratsioon

Väljad

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

Toimingutes „Hangi andmed“ kasutatavad väljad.

Väli	Kirjeldus
Sorteeri andmed	Kohustuslik. Parameetrid, mille järgi otsingupäringuga tagastatud andmeid sorteeritakse.
Maksimaalne tulemuste arv	Kohustuslik. Maksimaalne tulemuste arv, mille valitud otsingupäring saab tagastada. Korraga saab tagastada kuni 100 tulemust.
Päring	Kohustuslik. Vali levinud päringute seast või tee enda oma loomiseks valik Täpsem.

Päringu sõne

See on näidispäring viimase päeva jooksul avaldatud artiklite hankimiseks:

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

Muutuja published_at on filter, mis on saadaval päringus Articles query ning seda saab kasutada mitu korda või kombineerida teiste muutujatega. Liquidi muutuja scheduledAt on saadaval töövoogudes, mis kasutavad käivitajat Ajastatud aeg. Liquidi silt date_minus on spetsiaalne Flow silt, mis võimaldab kuupäevast aega maha arvata.

Andmete päringul on kasulik teada järgmist.

• Saadaolevate artiklifiltrite loend

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

• Päringuvälja väärtused pole alati dokumenteeritud. Mõnikord leiab väärtused API dokumentidest. Teise võimalusena leiad sageli väljaväärtused adminipaneeli URL-idest, kui kasutad filtreid. Näiteks mõne tellimuse päringu väärtuse leidmiseks filtreeri adminipaneelil lehte Tellimused ja seejärel kontrolli URL-i.

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

• Pea meeles, mis juhtub, kui sinu päring ebaõnnestub. Tihti tagastab API (mitte ühegi asemel) kõik tulemused.

Tagastatud andmed

Kõik toimingud Hangi andmed tagastavad loendi 0 kuni 100 ressursiga. Sõltuvalt sinu kasutusjuhust võid soovida neid andmeid kasutada mitmel viisil:

• Kui pead käsitlema iga loendi üksust eraldi, näiteks lisama igale üksusele sildi, saad kasutada toimingut For each.
• Kui pead andmeid koondama, näiteks lugema kokku, mitu tulemust tagastati, saad kasutada toiminguid Count või Sum.
• Kui pead loendi väljastama, näiteks saatma e-kirja kõigi üksustega, saad tagastatud andmeid kasutada otse järgmistes toimingutes.

Sellele toimingule järgnevates etappides tagastatud andmetele juurdepääsemiseks kasuta muutujat nimega Get article data, mis on artiklite loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks võid saata artiklite loendi toimingus Saada ettevõttesisene e-kiri sarnaselt järgnevaga:

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

Märkus

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

Käivitajad

Saad seda toimingut kasutada mis tahes 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 konkreetset sündmust, mis töövoo käivitab, ei kaasata andmeid automaatselt.

API viide

Lisateavet selles toimingus kasutatud API kohta leiad jaotisest Articles query.