Dapatkan data pesanan draf
Dalam aliran kerja yang menggunakan data pesanan draf, anda boleh menggunakan tindakan Dapatkan data pesanan draf untuk mengambil maklumat pesanan draf dari kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data pesanan draf mengandungi medan berikut, yang digunakan untuk membina pertanyaan:
| 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-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan pesanan draf yang telah dikemas kini pada hari lepas:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah updated_at ialah penapis yang tersedia pada pertanyaan pesanan Draf dan boleh digunakan berulang kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan Pencetus masa yang dijadualkan. Tag Liquid date_minus ialah tag Flow khas yang membolehkan anda menolak masa daripada tarikh.
Apabila menanyakan data, perkara berikut berguna untuk diketahui:
- Senarai penapis pesanan yang tersedia
- Pertanyaan mesti mengikut sintaks tertentu
- Nilai medan pertanyaan tidak sentiasa didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat dokumen API. Sebagai alternatif, anda juga boleh mencari nilai medan dalam URL dalam Admin apabila anda menapis. Sebagai contoh, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan dalam Admin, kemudian semak URL tersebut.
- Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Ambil perhatian tentang perkara yang berlaku jika pertanyaan anda gagal. API sering kali akan mengembalikan semua hasil (bukan tiada hasil langsung).
Data yang dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai yang mengandungi 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dalam pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara individu, seperti untuk menambahkan tag bagi setiap satu, maka anda boleh menggunakan tindakan Bagi setiap.
- Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda perlu mengoutput senarai tersebut, seperti menghantar e-mel dengan semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data pesanan draf, yang merupakan senarai pesanan draf. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai pesanan draf dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Pencetus
Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa yang dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa yang dijadualkan, aliran kerja bermula pada masa yang anda tetapkan dan bukan sebagai hasil daripada sesuatu acara. Oleh sebab tiada acara khusus di kedai anda atau dari aplikasi yang memulakan aliran kerja, tiada data yang disertakan secara automatik.
Butiran API
Templat
Hantar pemberitahuan harian yang mengandungi semua Pesanan Draf yang terbuka
Dapatkan pesanan draf yang terbuka, kiranya dan hantar mesej Slack setiap hari. Menggunakan pencetus masa yang Dijadualkan, tindakan Dapatkan pesanan draf dan Kira. Lihat templat