Ambil data lokasi

Di alur kerja yang memerlukan data lokasi, Anda dapat menggunakan tindakan Ambil data lokasi untuk mengambil informasi lokasi dari toko Shopify Anda. Lokasi adalah tempat mana pun tempat Anda menyimpan inventaris, menjual produk, atau mengirimkan atau memenuhi pesanan.

Catatan

Ini adalah jenis tindakan Ambil data. Untuk memahami cara menggunakan jenis tindakan ini dengan pemicu Waktu terjadwal dan loop Untuk setiap, lihat Alur kerja Penjadwalan, pengambilan data, dan perulangan di Shopify Flow.

Konfigurasi

Kolom

Tindakan Ambil data lokasi berisi kolom berikut.

Kolom yang digunakan dalam tindakan Ambil data.

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

String kueri

Ini adalah contoh kueri untuk mendapatkan lokasi yang mengaktifkan pengambilan di toko:

pickup_in_store:enabled

Variabel pickup_in_store adalah filter yang tersedia di kueri Lokasi dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain.

Saat membuat kueri data, ada baiknya Anda mengetahui:

• Daftar filter lokasi yang tersedia

• Kueri harus mengikuti sintaksis tertentu

• Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai tersebut dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai kolom di URL pada panel admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL.

• Anda dapat menjalankan atau menguji kueri di toko Anda dengan menggunakan aplikasi Shopify GraphiQL.

• Berhati-hatilah dengan apa yang terjadi jika kueri Anda gagal. Sering kali API akan mengembalikan semua hasil (bukan tidak sama sekali).

Data yang dikembalikan

Semua tindakan Ambil data akan mengembalikan daftar yang berisi 0 hingga 100 sumber daya. Tergantung 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 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 Jumlahkan.
• Jika Anda perlu menampilkan daftar sebagai output, misalnya mengirim email berisi semua item, maka Anda dapat menggunakan data yang dikembalikan secara langsung dalam tindakan berikutnya.

Untuk mengakses data yang dikembalikan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Ambil data lokasi, yang merupakan daftar lokasi. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar lokasi dalam tindakan Kirim email internal seperti ini:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Catatan

Jika tindakan Ambil data digunakan beberapa kali dalam satu alur kerja, maka angka akan ditambahkan ke nama variabel. Misalnya, dalam alur kerja yang menggunakan tindakan Ambil 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, 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 Lokasi.