Ambil data grup rencana penjualan
Dalam alur kerja yang memerlukan data grup rencana penjualan, Anda dapat menggunakan tindakan Ambil data grup rencana penjualan untuk mengambil informasi pesanan dari toko Anda.
Di halaman ini
Konfigurasi
Kolom
Tindakan Ambil data grup rencana penjualan berisi kolom berikut, yang digunakan untuk membuat kueri:
| 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 diisi. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri. |
String Kueri
Ini adalah contoh kueri untuk mendapatkan grup rencana penjualan yang diperbarui pada hari terakhir:
name='Subscribe & Save'Variabel category adalah filter yang tersedia di kueri Grup rencana penjualan dan dapat digunakan untuk memilih kategori grup rencana penjualan tertentu.
Saat membuat kueri data, ada baiknya Anda mengetahui:
- Daftar filter grup rencana penjualan yang tersedia
- Kueri harus mengikuti sintaksis tertentu
- Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai dapat ditemukan dengan melihat dokumen API. Atau, Anda sering dapat menemukan nilai kolom 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 (bukan tidak sama sekali).
Data yang dikembalikan
Semua tindakan Ambil data akan mengembalikan daftar yang berisi antara 0 dan 100 sumber daya. Bergantung pada kasus penggunaan, Anda mungkin ingin menggunakan data ini dengan berbagai cara:
- Jika Anda perlu menangani setiap item daftar satu per satu, misalnya untuk menambahkan tag untuk setiap item, maka Anda dapat menggunakan tindakan Untuk Setiap.
- Jika Anda perlu mengagregasi data, seperti menghitung berapa banyak hasil yang dikembalikan, maka Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
- Jika Anda perlu menampilkan daftar, misalnya 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 Ambil data grup rencana penjualan, yang merupakan daftar grup rencana penjualan. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar grup rencana penjualan dalam tindakan Kirim email internal seperti ini:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}Contoh
Misalnya, alur kerja dijadwalkan untuk berjalan setiap hari Minggu pukul 09.00. Tindakan Ambil data grup rencana penjualan digunakan untuk mengumpulkan data grup rencana penjualan yang dibuat dalam seminggu terakhir. Jika produk yang terkait dengan grup rencana penjualan adalah produk terlaris Anda, maka posisi grup rencana penjualan dapat meningkat.