Ambil data koleksi
Dalam alur kerja yang memerlukan data koleksi, Anda dapat menggunakan tindakan Ambil data koleksi untuk mengambil informasi koleksi dari toko Anda.
Di halaman ini
Konfigurasi
Kolom
Tindakan Ambil data koleksi berisi kolom-kolom berikut.
| Kolom | Deskripsi |
|---|---|
| Urutkan data menurut | Wajib diisi. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian. |
| Jumlah hasil maksimum | Wajib diisi. Jumlah hasil maksimum yang dapat dikembalikan oleh kueri pencarian yang Anda pilih. Anda dapat mengembalikan hingga 100 hasil sekaligus. |
| Kueri | Wajib. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri. |
String kueri
Berikut adalah contoh kueri untuk mendapatkan koleksi yang diperbarui pada hari terakhir:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabel updated_at adalah filter yang tersedia di kueri Koleksi 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, ada baiknya Anda mengetahui:
- Daftar filter koleksi yang tersedia
- Kueri harus mengikuti sintaksis tertentu
- Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai tersebut dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai bidang di URL pada panel admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL-nya.
- Anda dapat menjalankan atau menguji kueri di toko Anda menggunakan aplikasi Shopify GraphiQL.
- Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali, API akan mengembalikan semua hasil (alih-alih tidak ada).
Data yang dikembalikan
Semua tindakan Dapatkan data mengembalikan daftar yang 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, misalnya untuk menambahkan tag pada setiap item, Anda dapat menggunakan tindakan Untuk setiap.
- Jika Anda perlu mengagregasi data, misalnya menghitung berapa banyak hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
- Jika Anda perlu menampilkan daftar sebagai output, misalnya untuk mengirim email berisi semua item, Anda dapat menggunakan data yang dikembalikan secara langsung di tindakan berikutnya.
Untuk mengakses data yang dikembalikan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Dapatkan data koleksi, yang merupakan daftar koleksi. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar koleksi dalam tindakan Kirim email internal seperti ini:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Pemicu
Anda dapat menggunakan tindakan ini di alur kerja apa pun, termasuk pemicu Waktu terjadwal. Dalam alur kerja yang menggunakan pemicu Waktu terjadwal, alur kerja dimulai pada waktu yang telah Anda tentukan, bukan sebagai hasil dari suatu peristiwa. Karena tidak ada peristiwa spesifik di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.