Dapatkan data halaman

Dalam alur kerja yang memerlukan data halaman, Anda dapat menggunakan tindakan Dapatkan data halaman untuk mengambil informasi halaman dari toko Anda. Halaman adalah halaman web di toko online Anda yang berisi informasi yang jarang berubah, seperti halaman Tentang Kami atau halaman Kontak.

Di halaman ini

Konfigurasi

Bidang

Tindakan Dapatkan data halaman memiliki bidang berikut:

Bidang yang digunakan di tindakan Dapatkan data.
Bidang	Deskripsi
Urutkan data berdasarkan	Wajib. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian.
Jumlah hasil maksimal	Wajib. Jumlah hasil maksimal 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

Ini adalah contoh kueri untuk mendapatkan halaman yang diterbitkan:

published_status:published

Variabel published_status adalah filter yang tersedia di kueri Pages dan dapat digunakan beberapa kali atau dikombinasikan dengan variabel lain.

Saat membuat kueri data, ada baiknya untuk mengetahui:

Daftar filter halaman yang tersedia
Kueri harus mengikuti sintaks tertentu
Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilainya dapat ditemukan dengan melihat dokumen API. Selain itu, Anda juga sering menemukan nilai bidang pada URL di admin saat Anda memfilternya. 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 menggunakan aplikasi Shopify GraphiQL.
Hati-hati dengan apa yang terjadi jika kueri Anda gagal. API sering kali akan mengembalikan semua hasil (bukan tidak ada).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar dengan jumlah 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 secara individual, seperti untuk menambahkan tag pada setiap item, maka Anda dapat menggunakan tindakan Untuk setiap.
Jika Anda perlu mengagregasi data, seperti menghitung berapa banyak hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlah.
Jika Anda perlu menampilkan daftar tersebut, seperti mengirimkan email berisi semua item, Anda dapat menggunakan data yang dikembalikan secara langsung di tindakan selanjutnya.

Untuk mengakses data yang dikembalikan di langkah yang mengikuti tindakan ini, gunakan variabel bernama Dapatkan data halaman, yang merupakan daftar halaman. Anda dapat menggunakan variabel ini di dalam kondisi maupun tindakan. Contohnya, Anda dapat mengirim daftar halaman di tindakan Kirim email internal yang mirip dengan ini:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Pemicu

Anda dapat menggunakan tindakan ini di alur kerja apa pun, termasuk pemicu Waktu terjadwal. Dalam alur kerja yang menggunakan pemicu Waktu terjadwal, alur kerja akan dimulai pada waktu yang Anda tentukan, dan bukan sebagai akibat dari suatu peristiwa. Karena tidak ada peristiwa spesifik di toko atau dari aplikasi Anda 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 Pages.