Obținere intrări metaobiect

Puteți utiliza acțiunea Obținere intrări metaobiect pentru a recupera o listă de intrări pentru un metaobiect din magazinul dvs., pe baza interogării opționale. Consultați documentația metaobiectelor pentru mai multe informații.

Configurare

Câmpuri

Acțiunea Obținere intrări metaobiect conține un meniu vertical pentru specificarea definiției metaobiectului, precum și următoarele câmpuri, care sunt utilizate pentru a construi interogarea:

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea înregistrărilor de metaobiecte dacă valoarea unui câmp email corespunde adresei de e-mail dintr-o comandă:

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

Acesta este un exemplu de interogare pentru obținerea înregistrărilor de metaobiecte care au fost actualizate în ultima zi:

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

Variabila updated_at este un filtru disponibil în interogarea Metaobiecte și poate fi utilizată de mai multe ori sau combinată cu alte variabile. Variabila Liquid scheduledAt este disponibilă în fluxurile de lucru care au utilizat declanșatorul Oră programată. Eticheta Liquid date_minus este o etichetă specială Flow care vă permite să scădeți timp dintr-o dată.

La interogarea datelor, este util să știți:

• Lista filtrelor de metaobiecte disponibile
• Interogarea metaobiectelor după valoarea câmpului necesită ca metaobiectul să aibă filtrarea activată, care poate fi activată în opțiunile pentru date personalizate din panoul de administrare Shopify.
• Interogările trebuie să respecte o anumită sintaxă
• Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, puteți găsi adesea valorile câmpurilor în URL-urile din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi unele valori de interogare pentru Comenzi, filtrați pagina Comenzi din panoul de administrare, apoi verificați URL-ul.
• Puteți executa sau testa o interogare în magazinul dumneavoastră folosind aplicația Shopify GraphiQL.
• Fiți atent la ce se întâmplă dacă interogarea eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile Preluare date returnează o listă de la 0 la 100 de resurse. În funcție de cazul dumneavoastră de utilizare, este posibil să doriți să utilizați aceste date în diverse moduri:

• Dacă trebuie să gestionați fiecare articol din listă individual, cum ar fi adăugarea unei etichete pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
• Dacă trebuie să agregați date, cum ar fi să numărați câte rezultate au fost returnate, atunci puteți utiliza acțiunile Numărare sau Sumă.
• Dacă trebuie să generați lista ca rezultat, cum ar fi să trimiteți un e-mail cu toate articolele, atunci puteți utiliza datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, utilizați variabila denumită Preluare înregistrări metaobiect, care este o listă de înregistrări de metaobiecte. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de perechi cheie-valoare pentru înregistrările de metaobiecte într-o acțiune Trimitere e-mail intern în acest fel:

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

Declanșatori

Puteți utiliza această acțiune în orice flux de lucru, inclusiv în declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru pornește la o oră specificată de dumneavoastră, mai degrabă decât ca urmare a unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau dintr-o aplicație care să pornească fluxul de lucru, nu sunt incluse automat date.

Detalii API

• Resursă metaobiect
• Filtre de interogare metaobiect
• Interogarea metaobiectelor după valoarea câmpului