Pridobi vnose metaobjektov

Dejanje Pridobi vnose metaobjektov lahko uporabite, če želite na podlagi izbirne poizvedbe iz svoje trgovine pridobiti seznam vnosov za metaobjekt. Za več informacij si oglejte dokumentacijo za metaobjekte.

Konfiguracija

Polja

Dejanje Pridobi vnose metaobjektov vsebuje spustni meni za določanje definicije metaobjekta in naslednja polja, ki se uporabljajo za sestavljanje poizvedbe:

Niz poizvedbe

To je primer poizvedbe za pridobivanje vnosov metaobjektov, če se vrednost polja za email ujema z e-poštnim naslovom na naročilu:

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

To je primer poizvedbe za pridobivanje vnosov metaobjektov, ki so bili posodobljeni v zadnjem dnevu:

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

Spremenljivka updated_at je filter, ki je na voljo v poizvedbi za metaobjekte in se lahko uporabi večkrat ali v kombinaciji z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki so uporabili sprožilec načrtovanega časa. Oznaka Liquid date_minus je posebna oznaka za Flow, ki omogoča odštevanje časa od datuma.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov za metaobjekte
• Poizvedovanje po metaobjektih po vrednosti polja zahteva, da ima metaobjekt omogočeno filtriranje, kar lahko omogočite v skrbniški plošči Shopify pod možnostmi za podatke po meri.
• Poizvedbe morajo upoštevati določeno sintakso
• Vrednosti polj poizvedb niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji za API. Pogosto lahko vrednosti polj najdete tudi v URL-naslovih v skrbniški plošči med filtriranjem. Če želite na primer poiskati nekatere vrednosti poizvedb za naročilo, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
• Poizvedbo lahko zaženete ali preizkusite v svoji trgovini s pomočjo aplikacije Shopify GraphiQL.
• Bodite pozorni na to, kaj se zgodi, če poizvedba ne uspe. Pogosto bo API vrnil vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe boste morda želeli te podatke uporabiti na različne načine:

• Če morate vsak element seznama obravnavati posamezno, na primer tako, da mu dodate oznako, lahko uporabite dejanje Za vsakega.
• Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanje Štetje ali Vsota.
• Če želite izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko uporabite vrnjene podatke neposredno v naslednjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi vnose metaobjektov, ki je seznam vnosov metaobjektov. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam parov ključ-vrednost za vnose metaobjektov lahko na primer pošljete v dejanju Pošlji interno e-pošto takole:

{% 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 %}

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovani čas. V poteku dela, ki uporablja sprožilec Načrtovani čas, se potek dela začne ob času, ki ste ga določili, in ne kot rezultat dogodka. Ker v vaši trgovini ni specifičnega dogodka ali pa ni dogodka iz aplikacije, ki zažene potek dela, podatki niso samodejno vključeni.

Podrobnosti API-ja

• Vir metaobjekta
• Filtri poizvedb za metaobjekt
• Poizvedovanje metaobjektov po vrednosti polja