Dapatkan data item inventaris

Dalam alur kerja yang memerlukan data item inventaris, Anda dapat menggunakan tindakan Dapatkan data item inventaris untuk mengambil informasi item inventaris dari toko Anda. Item Inventaris mewakili unit stok sebenarnya yang dilacak untuk varian produk.

Di halaman ini

Konfigurasi

Bidang

Tindakan Dapatkan data item inventaris memuat beberapa 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 maksimum hasil	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 item inventaris yang dilacak:

tracked:true

Variabel tracked adalah filter yang tersedia di Kueri item inventaris dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain.

Saat membuat kueri data, penting untuk mengetahui hal berikut:

Daftar filter item inventaris 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 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 item inventaris, yang merupakan daftar item inventaris. Anda dapat menggunakan variabel ini di dalam kondisi maupun tindakan. Contohnya, Anda dapat mengirim daftar item inventaris di tindakan Kirim email internal yang mirip dengan ini:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% 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 Inventory items.