Hae varastokohteen tiedot

Työnkuluissa, jotka edellyttävät varastokohteen tietoja, voit käyttää Hae varastokohteen tiedot -toimintoa varastokohteen tietojen noutamiseen kaupastasi. Varastokohteet edustavat todellisia varastoyksiköitä, joita seurataan tuoteversioiden osalta.

Määritys

Kentät

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

Kyselymerkkijono

Tämä on esimerkkikysely sellaisten varastokohteiden hakemiseen, joita seurataan:

tracked:true

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

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

• Luettelo saatavilla olevista varastokohteen suodattimista

• 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 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 varastokohteen tiedot, joka on luettelo varastokohteista. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää luettelon varastokohteista Lähetä sisäinen sähköposti -toiminnolla seuraavaan tapaan:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

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 Varastokohteet-kysely.