Dapatkan data artikel

Dalam alur kerja yang memerlukan data artikel blog, Anda dapat menggunakan tindakan Dapatkan data artikel untuk mengambil informasi artikel dari toko Shopify Anda.

Di halaman ini

Konfigurasi

Bidang

Tindakan Dapatkan data artikel berisi bidang berikut:

Bidang yang digunakan dalam tindakan Dapatkan data.
Bidang	Deskripsi
Urutkan data berdasarkan	Wajib. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian.
Jumlah hasil maksimum	Wajib. Jumlah hasil maksimum yang dapat dikembalikan oleh kueri pencarian yang Anda pilih. Anda dapat mengembalikan hingga 100 sekaligus.
Kueri	Wajib. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri.

String kueri

Berikut adalah contoh kueri untuk mendapatkan artikel yang diterbitkan dalam satu hari terakhir:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabel published_at adalah filter yang tersedia pada Kueri artikel 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 khusus Flow yang memungkinkan Anda mengurangi waktu dari suatu tanggal.

Saat membuat kueri data, Anda perlu mengetahui:

Daftar filter artikel yang tersedia
Kueri harus mengikuti sintaks tertentu
Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilainya dapat ditemukan dengan melihat dokumen API. Sebagai alternatif, Anda sering kali dapat menemukan nilai bidang dalam URL di admin saat melakukan pemfilteran. 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 (alih-alih tidak ada hasil sama sekali).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar antara 0 dan 100 sumber daya. Tergantung pada kasus penggunaan Anda, Anda mungkin ingin menggunakan data ini dengan berbagai cara:

Jika Anda perlu menangani setiap item daftar secara terpisah, seperti 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 Jumlah.
Jika Anda perlu menampilkan daftar, seperti mengirim email yang berisi semua item, maka Anda dapat menggunakan data yang dikembalikan secara langsung pada tindakan selanjutnya.

Untuk mengakses data yang dikembalikan pada langkah-langkah yang mengikuti tindakan ini, gunakan variabel bernama Dapatkan data artikel, yang merupakan daftar artikel. Anda dapat menggunakan variabel ini di kondisi maupun tindakan. Misalnya, Anda dapat mengirim daftar artikel dalam tindakan Kirim email internal seperti ini:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Pemicu

Anda dapat menggunakan tindakan ini dalam 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 akibat dari suatu peristiwa. Karena tidak ada peristiwa khusus di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.

Referensi API

Untuk informasi selengkapnya tentang API yang digunakan dalam tindakan ini, lihat Kueri artikel.