Ambil entri metaobjek

Anda dapat menggunakan tindakan Ambil entri metaobjek untuk mengambil daftar entri untuk metaobjek dari toko Anda berdasarkan kueri opsional. Lihat dokumentasi metaobjek untuk informasi selengkapnya.

Konfigurasi

Kolom

Tindakan Ambil entri metaobjek berisi menu drop-down untuk menentukan definisi metaobjek serta kolom berikut, yang digunakan untuk membuat kueri:

String kueri

Ini adalah contoh kueri untuk mendapatkan entri metaobjek jika nilai kolom email cocok dengan alamat email pada pesanan:

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

Ini adalah contoh kueri untuk mendapatkan entri metaobjek yang diperbarui dalam satu hari terakhir:

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

Variabel updated_at adalah filter yang tersedia di kueri Metaobjek dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain. Variabel Liquid scheduledAt tersedia di alur kerja yang menggunakan pemicu Waktu terjadwal. Tag Liquid date_minus adalah tag Flow khusus yang memungkinkan Anda mengurangi waktu dari tanggal.

Saat membuat kueri data, sebaiknya ketahui:

• Daftar filter metaobjek yang tersedia
• Membuat kueri metaobjek berdasarkan nilai kolom mengharuskan metaobjek mengaktifkan pemfilteran, yang dapat diaktifkan di opsi untuk data kustom admin Shopify.
• Kueri harus mengikuti sintaks tertentu
• Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai kolom di URL pada Admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di Admin, lalu periksa URL.
• Anda dapat mengeksekusi atau menguji kueri di toko Anda dengan menggunakan aplikasi Shopify GraphiQL.
• Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali API akan mengembalikan semua hasil (bukan tidak ada sama sekali).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar berisi antara 0 hingga 100 sumber daya. Tergantung pada kasus penggunaan Anda, Anda mungkin ingin menggunakan data ini dengan berbagai cara:

• Jika Anda perlu menangani setiap item daftar satu per satu, seperti untuk menambahkan tag untuk setiap item, maka Anda dapat menggunakan tindakan Untuk setiap.
• Jika Anda perlu menggabungkan data, seperti menghitung berapa banyak hasil yang dikembalikan, maka Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
• Jika Anda perlu menampilkan daftar, seperti mengirim email berisi semua item, maka Anda dapat menggunakan data yang dikembalikan secara langsung dalam tindakan berikutnya.

Untuk mengakses data yang dikembalikan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Dapatkan entri metaobjek, yang merupakan daftar entri metaobjek. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar pasangan kunci-nilai untuk entri metaobjek dalam tindakan Kirim email internal 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 %}

Pemicu

Anda dapat menggunakan tindakan ini di alur kerja mana pun, termasuk pemicu Waktu terjadwal. Dalam alur kerja yang menggunakan pemicu Waktu terjadwal, alur kerja dimulai pada waktu yang telah Anda tentukan, bukan sebagai akibat dari suatu peristiwa. Karena tidak ada peristiwa tertentu di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.

Detail API

• Sumber daya metaobjek
• Filter kueri metaobjek
• Membuat kueri metaobjek berdasarkan nilai kolom