Hae artikkelin tiedot
Työnkuluissa, jotka edellyttävät blogiartikkelin tietoja, voit noutaa artikkelin tiedot Shopify-kaupastasi Hae artikkelin tiedot -toiminnolla.
Tällä sivulla
Määritys
Kentät
Hae artikkelin tiedot -toiminto sisältää seuraavat kentät:
| Kenttä | Kuvaus |
|---|---|
| Tietojen lajitteluperuste | Pakollinen. Parametrit, joiden perusteella hakukyselyn palauttamat tiedot lajitellaan. |
| Tulosten enimmäismäärä | Pakollinen. Valitsemasi hakukyselyn palauttamien tulosten enimmäismäärä. Voit palauttaa enintään 100 tulosta kerrallaan. |
| Kysely | Pakollinen. Valitse jokin yleisistä kyselyistä tai valitse Edistynyt luodaksesi oman. |
Kyselymerkkijono
Tässä on esimerkkikysely edellisen päivän aikana julkaistujen artikkelien hakemiseen:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'published_at-muuttuja on suodatin, joka on käytettävissä artikkelikyselyssä, ja sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin. scheduledAt-liquid-muuttuja on saatavilla työnkuluissa, jotka käyttävät Ajoitettu aika -käynnistintä. date_minus-liquid-tunniste on erityinen Flow-tunniste, jonka avulla voit vähentää aikaa päivämäärästä.
Tietoja kyseltäessä on hyödyllistä tietää seuraavat asiat:
Kyselyjen on noudatettava tiettyä syntaksia
Kyselykenttien arvoja ei aina ole dokumentoitu. Joissakin tapauksissa arvot löytyvät tarkastelemalla API-dokumentaatiota. Vaihtoehtoisesti löydät kenttien arvot usein ohjausnäkymän URL-osoitteista, kun käytät suodattimia. Voit esimerkiksi etsiä joitakin tilauskyselyn arvoja suodattamalla Tilaukset-sivua ohjausnäkymässä ja tarkistamalla sitten URL-osoitteen.
Voit suorittaa tai testata kyselyn kaupassasi käyttämällä Shopify GraphiQL -sovellusta.
Huomioi, mitä tapahtuu, jos kyselysi epäonnistuu. Usein API palauttaa kaikki tulokset (eikä nollaa tulosta).
Palautetut tiedot
Kaikki Hae tiedot -toiminnot palauttavat 0–100 resurssin luettelon. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoilla:
- Jos sinun on käsiteltävä jokaista luettelon kohdetta erikseen, esimerkiksi lisättävä tunniste jokaiselle, voit käyttää Jokaiselle-toimintoa.
- Jos sinun on koottava tietoja yhteen, esimerkiksi laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summaa-toimintoja.
- Jos sinun on tulostettava luettelo, esimerkiksi lähetettävä sähköpostiviesti, joka sisältää kaikki kohteet, voit käyttää palautettuja tietoja suoraan myöhemmissä toiminnoissa.
Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä muuttujaa nimeltä Hae artikkelin tiedot, joka on luettelo artikkeleista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää artikkeliluettelon Lähetä sisäinen sähköposti -toiminnolla seuraavaan tapaan:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}Käynnistimet
Voit käyttää tätä toimintoa missä tahansa työnkulussa, mukaan lukien Ajoitettu aika -käynnistin. Työnkulussa, joka käyttää Ajoitettu aika -käynnistintä, työnkulku käynnistyy määrittämänäsi ajankohtana eikä tapahtuman seurauksena. Koska työnkulkua ei käynnistä mikään tietty kaupassasi tai sovelluksessa tapahtuva tapahtuma, tietoja ei sisällytetä automaattisesti.
API-viite
Lisätietoja tässä toiminnossa käytetystä API-rajapinnasta on kohdassa Artikkelikysely.