Nouda tilaussopimuksen tiedot

Työnkuluissa, jotka käyttävät tilaussopimusten tietoja, voit käyttää Nouda tilaussopimuksen tiedot -toimintoa noutaaksesi tilaussopimusten tietoja kaupastasi.

Tällä sivulla

Määritys

Kentät

Nouda tilaussopimuksen tiedot -toiminto sisältää seuraavat kentät, joita käytetään kyselyn muodostamiseen:

Nouda tiedot -toiminnoissa käytetyt kentät.
Kenttä	Kuvaus
Lajittele tiedot	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 kerrallaan.
Kysely	Pakollinen. Valitse yleisistä kyselyistä tai luo omasi valitsemalla Laajennettu.

Kyselymerkkijono

Tämä on esimerkkikysely, jolla noudetaan tilaussopimukset, joiden tila on ACTIVE:

status: ACTIVE

status-muuttuja on suodatin, joka on käytettävissä Tilaussopimukset-kyselyssä, ja sitä voidaan käyttää useita kertoja.

Kun teet tietokyselyitä, on hyvä tietää:

Luettelo käytettävissä olevista suodattimista
Kyselyiden on noudatettava tiettyä syntaksia
Kyselykenttien arvoja ei ole aina dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumentaatiosta. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun käytät suodattimia. Jos haluat esimerkiksi löytää joitakin tilauskyselyn arvoja, suodata Tilaukset-sivua ohjausnäkymässä 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 (ei yhtään).

Palautetut tiedot

Kaikki Nouda 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ätäksesi tunnisteen jokaiselle, voit käyttää Jokaiselle-toimintoa.
Jos sinun on koottava tietoja, esimerkiksi laskeaksesi palautettujen tulosten määrän, voit käyttää Laske- tai Summa-toimintoja.
Jos sinun on käytettävä luetteloa tulosteena, esimerkiksi lähettääksesi sähköpostin, joka sisältää kaikki tuotteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

Pääset käsiksi palautettuihin tietoihin tätä toimintoa seuraavissa vaiheissa käyttämällä muuttujaa nimeltä Nouda tilaussopimuksen tiedot, joka on luettelo tilaussopimuksista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää luettelon tilauksista Lähetä sisäinen sähköposti -toiminnolla seuraavasti:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Käynnistimet

Voit käyttää tätä toimintoa missä tahansa työnkulussa, myös **Ajastettu aika** -käynnistimessä. Työnkulussa, jossa käytetään **Ajastettu aika** -käynnistintä, työnkulku käynnistyy määrittämänäsi ajankohtana eikä minkään tapahtuman seurauksena. Koska mikään tietty tapahtuma kaupassasi tai sovelluksessa ei käynnistä työnkulkua, siihen ei sisällytetä tietoja automaattisesti.