Hae luettelon tiedot

Työnkuluissa, joissa vaaditaan luettelon tietoja, voit noutaa B2B-luettelon tiedot kaupastasi Hae luettelon tiedot -toiminnon avulla. Luettelot ovat tuoteryhmiä, joilla on mukautettu hinnoittelu tietyille B2B-asiakkaille tai yrityksen sijainneille.

Huomaa

Tämä on Hae tietoja -tyyppinen toiminto. Lisätietoja tämän toimintotyypin käyttämisestä Ajoitettu aika -käynnistimen ja Jokaiselle-silmukoiden kanssa on kohdassa Aikataulut, tietojen noutaminen ja silmukkatyönkulut Shopify Flow'ssa.

Määritys

Kentät

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

Hae tietoja -toiminnoissa käytettävät kentät.

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

Kyselymerkkijono

Tämä on esimerkkikysely kaikkien aktiivisten luetteloiden hakemiseen:

status:ACTIVE

Muuttuja status on suodatin, joka on saatavilla Luettelot-kyselyssä. Sitä voidaan käyttää useita kertoja tai se voidaan yhdistää muihin muuttujiin.

Tietoja kyseltäessä on hyvä tietää seuraavat asiat:

• Luettelo saatavilla olevista luettelosuodattimista

• Kyselyjen on noudatettava tiettyä syntaksia

• Kyselyjen kenttien arvoja ei ole aina dokumentoitu. Joissakin tapauksissa arvot löytyvät API-rajapinnan dokumentaatiosta. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun käytät suodatusta. Jos haluat esimerkiksi löytää joitakin tilauskyselyn arvoja, 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 kysely epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, että se ei palauttaisi mitään).

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 tavoin:

• 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, kuten laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summa-toimintoja.
• Jos sinun on tulostettava luettelo, kuten lähetettävä sähköposti, joka sisältää kaikki kohteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Huomaa

Jos Hae tiedot -toimintoa käytetään useita kertoja yhdessä työnkulussa, muuttujan nimeen lisätään numero. Esimerkiksi työnkulussa, jossa 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 tapahtuma kaupassasi tai sovelluksessa, tietoja ei sisällytetä automaattisesti.

API-viite

Lisätietoja tässä toiminnossa käytettävästä API-rajapinnasta on kohdassa Luettelot-kysely.