Dapatkan entri metaobjek

Anda boleh menggunakan tindakan Dapatkan entri metaobjek untuk mengambil semula senarai entri bagi metaobjek dari kedai anda berdasarkan pertanyaan pilihan. Lihat dokumentasi metaobjek untuk maklumat lanjut.

Konfigurasi

Medan

Tindakan Dapatkan entri metaobjek mengandungi lungsur untuk menentukan definisi metaobjek serta medan berikut yang digunakan untuk membina pertanyaan:

Rentetan pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan entri metaobjek jika nilai medan email sepadan dengan alamat e-mel pada pesanan:

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

Ini ialah contoh pertanyaan untuk mendapatkan entri metaobjek yang telah dikemas kini dalam tempoh sehari yang lalu:

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

Pemboleh ubah updated_at ialah penapis yang tersedia pada Pertanyaan Metaobjects dan boleh digunakan berbilang kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan pencetus Masa yang dijadualkan. Tag Liquid date_minus ialah tag Flow khas yang membolehkan anda menolak masa daripada sesuatu tarikh.

Apabila membuat pertanyaan data, perkara berikut amat berguna untuk diketahui:

• Senarai penapis metaobjek yang tersedia
• Membuat pertanyaan metaobjek mengikut nilai medan memerlukan metaobjek tersebut mempunyai penapisan didayakan, yang boleh didayakan dalam pilihan untuk data tersuai dalam pentadbir Shopify.
• Pertanyaan mesti mengikut sintaks tertentu
• Nilai medan pertanyaan tidak sentiasa didokumenkan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat pada dokumen API. Sebagai alternatif, anda juga sering kali boleh mencari nilai medan dalam URL di panel pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan di panel pentadbir, dan kemudian semak URL tersebut.
• Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
• Ambil perhatian terhadap perkara yang berlaku jika pertanyaan anda gagal. API sering kali akan mengembalikan semua hasil (bukannya tiada).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai yang mengandungi antara 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dalam pelbagai cara:

• Jika anda perlu mengendalikan setiap item senarai secara individu, seperti menambah tag untuk setiap item, anda boleh menggunakan tindakan Untuk setiap.
• Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang dikembalikan, anda boleh menggunakan tindakan Kira atau Jumlah.
• Jika anda perlu mengeluarkan senarai, seperti menghantar e-mel yang mengandungi semua item, anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.

Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah yang dinamakan Dapatkan entri metaobjek, iaitu senarai entri metaobjek. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Contohnya, anda boleh menghantar senarai pasangan nilai kunci untuk entri metaobjek dalam tindakan Hantar e-mel dalaman seperti ini:

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

Pencetus

Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa dijadualkan, aliran kerja bermula pada masa yang anda tetapkan, dan bukan sebagai hasil daripada satu acara. Oleh sebab tiada acara khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data disertakan secara automatik.

Butiran API

• Sumber metaobjek
• Penapis pertanyaan metaobjek
• Menanyakan metaobjek mengikut nilai medan