Hae metaobjektimerkinnät
Hae metaobjektimerkinnät -toiminnolla voit hakea kaupastasi luettelon metaobjektin merkinnöistä valinnaisen kyselyn perusteella. Katso lisätietoja metaobjektidokumentaatiosta.
Tällä sivulla
Määrittäminen
Kentät
Hae metaobjektimerkinnät -toiminto sisältää pudotusvalikon, jossa voi määrittää metaobjektimääritelmän, sekä seuraavat kentät, joilla kysely muodostetaan:
Kenttä | Oikeuksien kuvaus |
---|---|
Tietojen lajitteluperuste | Vaaditaan. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan. |
Tulosten enimmäismäärä | Tarvitaan. Hakukyselyn palauttamien tulosten suurin mahdollinen määrä. Voit palauttaa kerrallaan enintään 100. |
Kysely | Tarvitaan. Valitse yleisistä kyselyistä tai valitse Lisäasetukset luodaksesi oman. |
Kyselyn merkkijono
Tämä on esimerkkikysely metaobjektimerkintöjen hakemiseksi, jos email
-kentän arvo vastaa tilauksen sähköpostiosoitetta:
{{fields.email}}:"{{order.email}}"
Tällä esimerkkikyselyllä voit hakea edellisen päivän aikana päivitetyt metaobjektimerkinnät:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
Esimerkin updated_at
-muuttuja on suodatin, joka on käytettävissä metaobjektikyselyssä ja jota voidaan käyttää useita kertoja tai joka voidaan yhdistää muihin muuttujiin. Esimerkin Liquid-muuttuja scheduledAt
on käytettävissä työnkuluissa, joissa on käytetty Asetettu aika ‑käynnistintä. Esimerkin date_minus
-Liquid-tunniste on erityinen Flow-tunniste, jolla voit vähentää aikaa päivämäärästä.
Seuraavat asiat on hyvä tietää tietokyselyä luotaessa:
- Luettelo käytettävissä olevista metaobjektisuodattimista
- Metaobjektien kysely kentän arvon perusteella edellyttää, että metaobjektissa on käytössä suodatus. Sen voi ottaa käyttöön Shopify Adminin mukautettujen tietojen asetuksissa. - Kyselyjen on noudatettava tiettyä syntaksia
- Kyselykenttien arvoja ei ole aina dokumentoitu. Joissain tapauksissa arvot löytyvät API-dokumenteista. Vaihtoehtoisesti voit usein löytää kentän arvot Adminin URL-osoitteista, kun suodatat. Jos esimerkiksi haluat löytää tilauskyselyn arvoja, suodata Tilaukset-sivu ylläpitäjässä ja tarkista sitten URL-osoite.
- Voit suorittaa tai testata kyselyä kaupassasi Shopify GraphiQL -sovelluksen avulla.
- Ole tietoinen siitä, mitä tapahtuu, jos kysely epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, että se ei palauttaisi yhtään).
Palautetut tiedot
Kaikki Hae tietoja -toiminnot palauttavat luettelon, jonka koko on 0-100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoilla:
- Jos sinun täytyy käsitellä kutakin luettelon kohtaa erikseen, kuten lisätä kullekin tunnisteen, voit käyttää For each-toimintoa.
- Jos sinun täytyy yhdistellä tietoja, kuten laskea, kuinka monta tulosta palautettiin, voit käyttää Laske- tai Summa-toimintoja.
- Jos sinun täytyy tulostaa luettelo, kuten lähettää kaikki kohdat sisältävä sähköpostiviesti, voit käyttää palautettuja tietoja suoraan tätä toimintoa seuraavissa toiminnoissa.
Jos haluat käyttää palautettuja tietoa tätä toimintoa seuraavissa vaiheissa, käytä Hae metaobjektimerkinnät -muuttujaa, joka on luettelo metaobjektimerkinnöistä. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää metaobjektimerkintöjen avain-arvo-parit seuraavalla Lähetä sisäinen sähköposti -toiminnolla:
{% 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 kaikissa työnkuluissa, myös Asetettu aika -käynnistimessä. Työnkulussa, jossa käytetään Asetettu aika -käynnistintä, työnkulku käynnistyy määrittämänäsi aikana eikä jonkin tapahtuman seurauksena. Koska työnkulkua ei käynnistä tietty kaupan tai sovelluksen tapahtuma, siihen ei automaattisesti sisälly tietoja.