Nouda metaobjektin merkinnät

Voit käyttää Nouda metaobjektin merkinnät -toimintoa noutaaksesi luettelon metaobjektin merkinnöistä kaupastasi valinnaisen kyselyn perusteella. Katso lisätietoja metaobjektien dokumentaatiosta.

Määritys

Kentät

Nouda metaobjektin merkinnät -toiminto sisältää pudotusvalikon metaobjektin määrityksen määrittämistä varten sekä seuraavat kentät, joita käytetään kyselyn muodostamiseen:

Kyselymerkkijono

Tämä on esimerkkikysely metaobjektimerkintöjen noutamiseksi, kun email-kentän arvo vastaa tilauksen sähköpostiosoitetta:

{{fields.email}}:"{{order.email}}"

Tämä on esimerkkikysely sellaisten metaobjektimerkintöjen noutamiseen, jotka on päivitetty viimeisen vuorokauden aikana:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at-muuttuja on suodatin, joka on saatavilla Metaobjektit-kyselyssä. Sitä voidaan käyttää useita kertoja tai yhdistää muihin muuttujiin. scheduledAt-Liquid-muuttuja on käytettävissä työnkuluissa, jotka käyttävät Ajastettu aika -käynnistintä. date_minus-Liquid-tunniste on erityinen Flow-tunniste, jonka avulla voit vähentää aikaa päivämäärästä.

Kun teet datakyselyjä, on hyvä tietää seuraavat asiat:

• Luettelo käytettävissä olevista metaobjektisuodattimista
• Metaobjektien kysely kentän arvon perusteella edellyttää, että metaobjektilla on suodatus käytössä. Sen voi ottaa käyttöön Shopifyn ohjausnäkymän mukautettujen tietojen asetuksissa.
• Kyselyjen 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 suodattimia käytettäessä. Voit esimerkiksi löytää joitakin tilauskyselyn arvoja suodattamalla ohjausnäkymän Tilaukset-sivua ja tarkistamalla sitten URL-osoitteen.
• 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 (eikä yhtään).

Palautetut tiedot

Kaikki Nouda tiedot -toiminnot palauttavat luettelon, jossa on 0–100 resurssia. Käyttötapauksestasi riippuen voit 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ää Jokaiselle-toimintoa.
• Jos sinun on koostettava tietoja, esimerkiksi laskettava palautettujen tulosten määrä, voit käyttää Laske- tai Summa-toimintoja.
• Jos sinun on tulostettava luettelo, esimerkiksi lähettääksesi sähköpostitse kaikki sen alkiot, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.

Voit käyttää tämän toiminnon palauttamia tietoja seuraavissa vaiheissa käyttämällä muuttujaa nimeltä Get metaobject entries, joka on metaobjektimerkintöjen luettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää metaobjektimerkintöjen avain-arvo-parien luettelon Lähetä sisäinen sähköposti -toiminnolla seuraavasti:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% 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 alkaa määrittämänäsi aikana tapahtuman sijaan. Koska mikään tietty tapahtuma kaupassasi tai sovelluksessa ei käynnistä työnkulkua, siihen ei sisälly automaattisesti mitään tietoja.

API-tiedot

• Metaobjektiresurssi
• Metaobjektikyselyn suodattimet
• Metaobjektien kysely kentän arvon perusteella