Ambil data draf pesanan
Dalam alur kerja yang menggunakan data draf pesanan, Anda dapat menggunakan tindakan Ambil data draf pesanan untuk mengambil kembali informasi draf pesanan dari toko Anda.
Di halaman ini
Konfigurasi
Kolom
Tindakan Ambil data draf pesanan berisi kolom-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 sekaligus. |
| Kueri | Wajib diisi. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri. |
String Kueri
Ini adalah contoh kueri untuk mendapatkan draf pesanan 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 draf pesanan 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 pesanan yang tersedia
- Kueri harus mengikuti sintaksis tertentu
- Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilainya dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai kolom di URL di Admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di Admin, lalu periksa URL-nya.
- Anda dapat menjalankan 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 sama sekali).
Data yang dikembalikan
Semua tindakan Ambil data mengembalikan daftar antara 0 hingga 100 sumber daya. Bergantung 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 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 sebagai output, 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 draf pesanan, yang merupakan daftar draf pesanan. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar draf pesanan dalam tindakan Kirim email internal seperti ini:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% 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 spesifik di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.
Detail API
Templat
Kirim notifikasi harian berisi semua Draf Pesanan yang terbuka
Setiap hari, dapatkan draf pesanan yang terbuka, hitung, dan kirim pesan Slack. Menggunakan pemicu Waktu terjadwal, tindakan Ambil draf pesanan, dan Hitung. Lihat templat