Hae tuotetiedot
Työnkuluissa, jotka käyttävät tuotetietoja, voit käyttää Hae tuotetiedot -toimintoa noutaaksesi tuotetietoja kaupastasi.
Määritys
Kentät
Hae tuotetiedot -toiminto sisältää seuraavat kentät, joiden avulla rakennetaan kysely:
| 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 tulosta kerrallaan. |
| Kysely | Pakollinen. Valitse yleisistä kyselyistä tai luo omasi valitsemalla Laajennettu. |
Kyselymerkkijono
Tässä on esimerkkikysely tuotteiden hakemiseksi, jotka on päivitetty viimeisen päivän aikana:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at-muuttuja on suodatin, joka on käytettävissä Tuotteet-kyselyssä. Sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin. scheduledAt-Liquid-muuttuja on käytettävissä työnkuluissa, joissa käytetään Ajastettu käynnistin -toimintoa. date_minus-Liquid-tunniste on erityinen Flow-tunniste, jonka avulla voit vähentää aikaa päivämäärästä.
Kun teet tietokyselyitä, on hyvä tietää seuraavat asiat:
- Luettelo käytettävissä olevista tuotesuodattimista
- Kyselyiden on noudatettava tiettyä syntaksia
- Kyselykenttien arvoja ei ole aina dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumentaatiosta. Vaihtoehtoisesti kenttien arvot löytyvät usein ohjausnäkymän URL-osoitteista, kun käytät suodattimia. Jos haluat esimerkiksi löytää Tilaus-kyselyn 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 sen sijaan, ettei se 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ä jokainen luettelon kohde erikseen, esimerkiksi lisätäksesi tunnisteen jokaiselle, voit käyttää For each -toimintoa.
- Jos sinun on koottava tietoja, esimerkiksi laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summa-toimintoja.
- Jos sinun on välitettävä luettelo eteenpäin, esimerkiksi lähettämällä sähköposti, joka sisältää kaikki tuotteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.
Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä muuttujaa nimeltä Hae tuotetiedot, joka on tuoteluettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää tuoteluettelon Lähetä sisäinen sähköposti -toiminnolla seuraavasti:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}Käynnistimet
Voit käyttää tätä toimintoa missä tahansa työnkulussa, mukaan lukien Ajastettu käynnistin -toiminto. Työnkulussa, jossa käytetään Ajastettu käynnistin -toimintoa, työnkulku käynnistyy määrittämänäsi ajankohtana tapahtuman seurauksen sijaan. Koska mikään tietty tapahtuma kaupassasi tai sovelluksessa ei käynnistä työnkulkua, siihen ei sisällytetä tietoja automaattisesti.
API-tiedot
Mallit
Lisää tunnisteella varustetut tuotteet kokoelmaan tulevaisuudessa
Nouda tulevana ajankohtana kaikki tuotteet, joilla on tietty tunniste, ja lisää ne sitten kokoelmaan. Näytä malli
Poista passiiviset tuotteet
Poista tuotteet, joiden varasto on loppu ja joita ei ole päivitetty vuoteen. Näytä malli
Julkaise tietyllä tunnisteella varustetut tuotteet tulevaisuudessa
Nouda tulevana päivänä tuotteet, joilla on tietty tunniste, ja julkaise ne. Käyttää Ajastettu aika -käynnistintä ja Nouda tuotetiedot -toimintoa. Näytä malli
Poista ”uusi”-tunniste 90 päivää tuotteen luomisen jälkeen
Noutaa joka päivä enintään 100 tuotetta, jotka on luotu yli 90 päivää sitten ja joilla on yhä ”uusi”-tunniste. Sen jälkeen työnkulku poistaa kyseiset tunnisteet kustakin tuotteesta. Näytä malli
Ajasta tuotteiden poistaminen Verkkokaupasta määritettynä päivänä ja aikana
Poista yhtenä tulevana ajankohtana tuotteita verkkokaupasta tunnisteen, tunnuksen tai SKU-koodin perusteella. Hyödyntää Ajastettu aika -käynnistintä, Nouda tuotetiedot -toimintoa ja For each -silmukkaa. Näytä malli
Lähetä päivittäinen sähköpostiyhteenveto varastosta loppuneista tuotteista
Noutaa joka päivä kaikki tuotteet, joiden varastosaldo on 0, ja lähettää sähköpostiyhteenvedon. Käyttää Nouda tuotetiedot -toimintoa ja Ajastettu aika -käynnistintä. Näytä malli
Lähetä sähköposti-ilmoitus, kun tuoteversio lisätään päällekkäisellä SKU-koodilla
Kun uusi versio lisätään, työnkulku tarkistaa, käyttävätkö muut versiot samaa SKU-koodia. Jos näin on, se lähettää sisäisen sähköpostiviestin, jossa on linkit kyseisiin tuotteisiin ja versioihin. Näytä malli
Seuraa alennusmyynnissä olevia tuoteversioita tuotteen metakentän avulla
Asettaa tuotteelle metakentän, jos vähintään yksi sen versioista on alennusmyynnissä. Tämä voi olla hyödyllistä, kun haluat seurata, mitkä tuotteet ovat parhaillaan alennusmyynnissä. Näytä malli