Dapatkan data koleksi
Dalam aliran kerja yang memerlukan data koleksi, anda boleh menggunakan tindakan Dapatkan data koleksi untuk mengambil maklumat koleksi daripada kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data koleksi mengandungi medan berikut.
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian. |
| Bilangan maksimum hasil | Diperlukan. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 hasil pada satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan koleksi yang dikemas kini pada hari sebelumnya:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah updated_at ialah penapis yang tersedia pada Pertanyaan koleksi dan boleh digunakan beberapa kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan Pencetus masa dijadualkan. Tag Liquid date_minus ialah tag Flow khusus yang membolehkan anda menolak masa daripada tarikh.
Apabila menanya data, maklumat berikut perlu diketahui:
- Senarai penapis koleksi yang tersedia
- Pertanyaan mestilah mengikut sintaks tertentu
- Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah keadaan, nilai boleh ditemukan dengan melihat dokumen API. Sebagai alternatif, anda sering kali boleh menemukan nilai medan tersebut dalam URL di bahagian Pentadbir apabila anda membuat penapisan. Contohnya, untuk menemukan beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam Pentadbir dan kemudian semak URL.
- Anda boleh menjalankan atau menguji pertanyaan dalam kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Ambil perhatian tentang apa yang berlaku jika pertanyaan anda gagal. Selalunya, API akan mengembalikan semua hasil (bukannya tiada).
Data dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai yang mempunyai antara 0 dan 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin ingin menggunakan data ini dalam pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara individu seperti menambah tag pada setiap item tersebut, maka anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda perlu mengeluarkan senarai seperti menghantar e-mel dengan semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data koleksi, iaitu senarai koleksi. Anda boleh menggunakan pemboleh ubah ini dalam keadaan serta tindakan. Contohnya, anda boleh menghantar senarai koleksi dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% 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 telah anda tetapkan, bukannya sebagai hasil daripada peristiwa. Oleh sebab tiada peristiwa khusus di kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data yang disertakan secara automatik.