Bantuan
Masuk

Dapatkan data perusahaan

Dalam alur kerja yang menggunakan data perusahaan, Anda dapat menggunakan tindakan Dapatkan data perusahaan untuk mengambil informasi perusahaan dari toko Anda.

Di halaman ini

Konfigurasi

Bidang

Tindakan Dapatkan data perusahaan berisi bidang-bidang berikut, yang digunakan untuk membuat kueri:

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

String kueri

Berikut adalah contoh kueri untuk mendapatkan perusahaan yang diperbarui pada hari terakhir:

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

Variabel updated_at adalah filter yang tersedia di kueri Perusahaan 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 Flow khusus yang memungkinkan Anda mengurangi waktu dari tanggal.

Saat membuat kueri data, ada baiknya Anda mengetahui:

  • Daftar filter perusahaan yang tersedia
  • Kueri harus mengikuti sintaksis tertentu
  • Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai tersebut dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai bidang di URL pada panel admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL-nya.
  • Anda dapat menjalankan atau menguji kueri di toko Anda menggunakan aplikasi Shopify GraphiQL.
  • Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali, API akan mengembalikan semua hasil (alih-alih tidak ada).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar yang berisi antara 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 pada setiap item, Anda dapat menggunakan tindakan Untuk setiap.
  • Jika perlu mengagregasi data, seperti menghitung jumlah hasil yang ditampilkan, Anda dapat menggunakan tindakan Count atau Sum.
  • Jika Anda perlu menampilkan daftar, seperti mengirim email berisi semua item, Anda dapat menggunakan data yang ditampilkan secara langsung dalam tindakan berikutnya.

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

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% 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 dimulai pada waktu yang telah Anda tentukan, bukan sebagai hasil dari suatu peristiwa. Karena tidak ada peristiwa spesifik di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.

Referensi API