Hae sivun tiedot

Työnkuluissa, jotka edellyttävät sivun tietoja, voit käyttää Hae sivun tiedot -toimintoa noutaaksesi sivun tietoja kaupastasi. Sivut ovat verkkokauppasi verkkosivuja, jotka sisältävät harvoin muuttuvia tietoja, kuten Tietoja meistä -sivu tai Yhteystiedot-sivu.

Huomautus

Tämä on Hae tiedot -tyyppinen toiminto. Jos haluat ymmärtää, miten tämäntyyppistä toimintoa käytetään Ajoitettu aika -käynnistimen ja Jokaiselle -silmukoiden kanssa, katso lisätietoja kohdasta Aikataulut, tietojen hakeminen ja silmukoita sisältävät työnkulut Shopify Flow'ssa.

Määritys

Kentät

Hae sivun tiedot -toiminto sisältää seuraavat kentät:

Hae tiedot -toiminnoissa käytetyt kentät.

Kenttä	Kuvaus
Tietojen lajitteluperuste	Pakollinen. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan.
Tulosten enimmäismäärä	Pakollinen. Valitsemasi hakukyselyn palauttamien tulosten enimmäismäärä. Voit palauttaa enintään 100 kerralla.
Kysely	Pakollinen. Valitse yleisistä kyselyistä tai luo omasi valitsemalla Edistynyt.

Kyselymerkkijono

Tämä on esimerkkikysely julkaistujen sivujen hakemiseksi:

published_status:published

published_status -muuttuja on suodatin, joka on saatavilla Sivut-kyselyssä, ja sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin.

Tietoja haettaessa on hyvä tietää seuraavaa:

• Luettelo saatavilla olevista sivun suodattimista

• Kyselyjen on noudatettava tiettyä syntaksia

• Kyselykenttien arvoja ei aina ole dokumentoitu. Joissakin tapauksissa arvot löytyvät tarkastelemalla API-dokumentaatiota. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun käytät suodattimia. Jos esimerkiksi haluat löytää tilauksen kyselyarvoja, suodata ohjausnäkymän Tilaukset-sivua ja tarkista sitten URL-osoite.

• Voit suorittaa tai testata kyselyn kaupassasi käyttämällä Shopify GraphiQL -sovellusta.

• Ota huomioon, mitä tapahtuu, jos kyselysi epäonnistuu. Usein API palauttaa kaikki tulokset (eikä tyhjää).

Palautetut tiedot

Kaikki Hae tiedot -toiminnot palauttavat luettelon, jossa on 0–100 resurssia. 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 yhdistettävä tietoja, esimerkiksi laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summa -toimintoja.
• Jos sinun on tuotettava luettelo, esimerkiksi lähetettävä kaikki kohteet sisältävä sähköposti, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä muuttujaa nimeltä Hae sivun tiedot, joka on luettelo sivuista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää luettelon sivuista Lähetä sisäinen sähköposti -toiminnolla seuraavaan tapaan:

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

Huomautus

Jos Hae tiedot -toimintoa käytetään useita kertoja yhdessä työnkulussa, muuttujan nimeen lisätään numero. Jos esimerkiksi työnkulussa käytetään Hae tilauksen tiedot -toimintoa kahdesti, ensimmäinen palautettujen tietojen muuttuja on getOrderData ja toinen muuttuja on getOrderData1. Tätä nimeä ei voi mukauttaa.

Käynnistimet

Voit käyttää tätä toimintoa missä tahansa työnkulussa, mukaan lukien Ajoitettu aika -käynnistimessä. Työnkulussa, joka käyttää Ajoitettu aika -käynnistintä, työnkulku alkaa määrittämänäsi ajankohtana eikä tapahtuman seurauksena. Koska työnkulkua ei käynnistä mikään tietty kaupassasi tai sovelluksessa tapahtunut tapahtuma, tietoja ei sisällytetä automaattisesti.

API-viite

Lisätietoja tässä toiminnossa käytetystä API-rajapinnasta on kohdassa Sivut-kysely.