Dapatkan data katalog

Dalam alur kerja yang memerlukan data katalog, Anda dapat menggunakan tindakan Dapatkan data katalog untuk mengambil informasi katalog B2B dari toko Anda. Katalog adalah kelompok produk dengan harga yang disesuaikan untuk pelanggan B2B atau lokasi perusahaan tertentu.

Catatan

Ini adalah jenis tindakan Dapatkan data. Untuk memahami cara menggunakan jenis tindakan ini dengan pemicu Waktu terjadwal dan loop Untuk setiap, lihat Jadwal, dapatkan data, dan alur kerja loop di Shopify Flow.

Konfigurasi

Bidang

Tindakan Dapatkan data katalog berisi bidang-bidang berikut:

Bidang yang digunakan dalam tindakan Dapatkan data.

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

String kueri

Ini adalah contoh kueri untuk mendapatkan semua katalog yang aktif:

status:ACTIVE

Variabel status adalah filter yang tersedia di Kueri katalog dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain.

Saat membuat kueri data, penting untuk mengetahui hal berikut:

• Daftar filter katalog yang tersedia

• Kueri harus mengikuti sintaksis tertentu

• Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai tersebut dapat ditemukan dengan melihat dokumentasi API. Alternatifnya, Anda sering dapat menemukan nilai bidang tersebut pada URL di admin saat menerapkan filter. Misalnya, untuk mencari beberapa nilai kueri Pesanan, filter halaman Pesanan di admin, lalu periksa URL tersebut.

• 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 ada).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar dari 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 bagi masing-masing 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 berisi semua item, maka Anda dapat menggunakan data yang dikembalikan secara langsung pada tindakan selanjutnya.

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Catatan

Jika tindakan Dapatkan data digunakan beberapa kali dalam satu alur kerja, maka angka akan ditambahkan ke nama variabel. Misalnya, dalam alur kerja yang menggunakan tindakan Dapatkan data pesanan dua kali, variabel pertama untuk data yang dikembalikan adalah getOrderData dan variabel kedua adalah getOrderData1. Nama ini tidak dapat disesuaikan.

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 dimulai pada waktu yang telah Anda tentukan, dan bukan sebagai hasil 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 lebih lanjut tentang API yang digunakan dalam tindakan ini, lihat Kueri katalog.