Bantuan
Log masuk

Memahami syarat dalam Shopify Flow

Syarat ialah langkah dalam aliran kerja yang mana suatu keputusan dibuat tentang cara untuk meneruskan tindakan berdasarkan sama ada set kriteria telah dipenuhi atau tidak. Setiap langkah syarat mempunyai 2 kemungkinan: Benar, apabila kriteria telah dipenuhi, dan Palsu, apabila kriteria belum dipenuhi. Jika anda tidak mentakrifkan langkah seterusnya untuk mana-mana kemungkinan tersebut dengan memilih syarat atau tindakan lain, maka aliran kerja akan berhenti dijalankan.

Sebagai contoh, jika aliran kerja anda dicetuskan apabila pesanan dicipta, maka syarat boleh menyemak sama ada kod diskaun AFFILIATE10 yang khusus digunakan pada pesanan tersebut. Jika ya, maka pilihan Benar boleh membawa kepada tindakan yang menghantar e-mel kepada ahli afiliasi untuk memberitahu mereka bahawa kod mereka telah digunakan. Jika tidak, maka pilihan Palsu boleh dikosongkan, menunjukkan tiada apa-apa lagi yang berlaku dan jalankan aliran kerja berakhir.

Aliran kerja boleh mempunyai sebarang bilangan syarat, bergantung pada kerumitan aliran kerja anda. Syarat juga boleh bersambung dengan syarat atau tindakan lain bergantung pada perkara yang anda mahu aliran kerja lakukan. Syarat boleh disiagakan untuk bersambung mengikut urutan (sebagai contoh, jika syarat A ialah benar, maka semak syarat B; jika A ialah palsu, maka semak C), atau anda boleh menyediakannya untuk berlaku secara serentak sebagai sebahagian daripada langkah yang sama (sebagai contoh, semak sama ada A atau B atau C adalah benar).

Pada halaman ini

Membentuk syarat untuk aliran kerja anda

Tidak seperti pencetus atau tindakan yang boleh anda pilih daripada senarai pilihan tersedia pratetap dalam Shopify Flow, syarat dibentuk dari mula dengan memilih pemboleh ubah, pengendali logik dan nilai untuk mencipta penyata bersyarat:

  • Pemboleh ubah ialah ruang letak yang mentakrifkan data yang digunakan oleh syarat. Sebagai contoh, jika syarat mahu menyemak kod diskaun khusus pada pesanan, maka pemboleh ubah akan menjadi order.discountCode. Pemboleh ubah menggunakan tatatanda titik GraphQL Admin API.
  • Satu pengendali logik menunjukkan cara aliran kerja patut menentukan sama ada syarat dipenuhi. Pengendali logik boleh digunakan pada peringkat pemboleh ubah atau apabila berbilang pemboleh ubah disertakan sebagai sebahagian daripada kriteria syarat keseluruhan:
    • Pilihan pada peringkat pemboleh ubah termasuk pengendali peringkat medan seperti Lebih besar daripada atau Bermula dengan, atau pengendali senarai seperti Sekurang-kurangnya satu daripada atau Semua daripada.
    • Pilihan peringkat syarat termasuk AND (DAN), bermaksud semua pemboleh ubah mestilah benar supaya syarat tersebut dianggap benar secara keseluruhan, atau OR (ATAU), bermaksud sekurang-kurangnya 1 pemboleh ubah mestilah benar supaya syarat tersebut dianggap benar secara keseluruhan.
  • Nilai ialah maklumat sebenar yang dicari oleh pemboleh ubah. Sebagai contoh, jika order.discountCode khusus yang anda mahu aliran kerja semak ialah AFFILIATE10, maka itu merupakan nilai untuk disertakan sebagai sebahagian daripada syarat.

Semasa anda memilih pemboleh ubah dan pengendali anda, langkah syarat dalam kanvas Shopify Flow dikemas kini untuk mencerminkan penyata bersyarat anda dalam bahasa biasa, supaya anda boleh menyemak semula sama ada syarat yang anda sedang bina telah diformat dengan betul. Anda boleh mengklik Tambah perihalan untuk menulis ganti penyata bersyarat lalai dengan perihalan bertulis anda sendiri.

Ketahui maklumat yang lebih terperinci tentang elemen syarat dalam Shopify Flow.

Memahami pemboleh ubah dalam syarat

Semasa membentuk langkah syarat dalam aliran kerja, langkah pertama yang anda digesa untuk ambil ialah Tambah pemboleh ubah. Tetapi, apakah itu pemboleh ubah?

Dalam Shopify Flow, pemboleh ubah ialah ruang letak yang menunjukkan data yang digunakan oleh syarat dalam aliran kerja. Apabila syarat berbunyi "Jika A lebih besar daripada 10...", bahagian A ialah pemboleh ubah. Memilih pemboleh ubah bagi sesuatu syarat pada asasnya adalah untuk memberitahu syarat secara khusus tentang data untuk dinilai.

Pemboleh ubah diformatkan menggunakan tatatanda titik GraphQL Admin API. Anda tidak perlu mahir dengan API untuk mencipta aliran kerja dengan aplikasi Flow, tetapi pemahaman asas tentang nama pemboleh ubah dan takrifannya boleh membantu anda membina logik aliran kerja khusus yang anda mahukan.

Untuk memahami data yang diwakili oleh pemboleh ubah, pertimbangkan maklumat yang berikut tentang pemboleh ubah:

Petua: Dapatkan bantuan dengan pemboleh ubah daripada Pembantu Dev Docs

Jika anda tidak pasti pemboleh ubah yang perlu dipilih semasa membina syarat anda, maka pertimbangkan untuk meminta nasihat Pembantu Dev Docs Shopify. Pembantu Dev Docs mempunyai akses kepada semua dokumentasi berkenaan GraphQL Admin API dan boleh menawarkan cadangan untuk cara memformatkan syarat dalam Shopify Flow:

  1. Pergi ke Shopify Dev Docs.
  2. Klik Tanya Pembantu untuk membuka panel sembang.
  3. Dalam medan mesej, masukkan permintaan anda, seperti "Pemboleh ubah manakah yang patut saya gunakan dalam Shopify Flow jika saya mahu mengakses data tag pelanggan apabila pencetus saya bermula dengan "Pesanan dicipta"?".
  4. Tekan Enter atau klik Hantar.

Membaca tatatanda titik pemboleh ubah

Semasa memilih pemboleh ubah, anda akan mendapati ia diformatkan sebagai kata kunci yang dipisahkan oleh titik, seperti order.customer.tag. Format ini menunjukkan langkah yang diambil oleh API untuk mendapatkan data yang anda mahu gunakan. Setiap 'langkah' pemboleh ubah dipisahkan oleh titik dan laluan ke data tersebut dibaca dari kiri ke kanan. Pemboleh ubah boleh berbeza dari segi panjangnya bergantung pada tempat data disimpan dalam API dan laluan yang diambil oleh aliran kerja untuk ke tempat itu.

Sebagai contoh:

  • order.email: Menyemak alamat e-mel yang dikaitkan dengan pelanggan untuk pesanan tersebut. Tindakan ini serupa dengan cara anda mungkin mengklik pesanan dan kemudian menyemak alamat e-mel pada butiran pesanan.
  • refunds_item.staffMember.name: Menyemak pesanan untuk bayaran balik item, pergi ke maklumat kakitangan yang dikaitkan dengan bayaran balik tersebut dan menyemak nama penuh kakitangan tersebut.

Semasa memilih pemboleh ubah, pertimbangkan cara anda mungkin menavigasi pentadbir Shopify untuk mencari maklumat yang anda mahukan. API berkemungkinan mungkin perlu mengambil laluan yang serupa, yang boleh membantu anda menentukan cara pemboleh ubah anda mungkin diformatkan.

Sebagai contoh, jika anda menyemak pesanan baharu dan mahu mengetahui tentang kumpulan RFM yang mengandungi pelanggan yang dikaitkan dengan pesanan itu, maka anda mungkin mahu mengklik nama pelanggan pada pesanan tersebut untuk dialihkan ke halaman butiran pelanggan dalam pentadbir Shopify, dan kemudian anda mungkin menyemak ringkasan analisis pelanggan untuk membaca nilai yang dipaparkan dalam lajur Kumpulan RFM.

Pemboleh ubah yang akan anda gunakan untuk mengembalikan data yang sama dalam Shopify Flow akan menggunakan laluan yang serupa: order.customer.statistics.rfmGroup.

Keperluan data untuk pemboleh ubah

Pemboleh ubah memerlukan data. Jika data yang betul tidak tersedia untuk pemboleh ubah, maka syarat tidak akan berfungsi dan aliran kerja gagal. Berdasarkan pencetus yang anda pilih sebagai permulaan aliran kerja anda, pilihan bagi pemboleh ubah yang perlu ditambah pada syarat anda berubah untuk mencerminkan pilihan yang berkemungkinan berdasarkan data yang tersedia.

Sebagai contoh, jika aliran kerja anda bermula dengan pencetus Produk dicipta, maka syarat yang anda cipta daripada pencetus itu terhad kepada pemboleh ubah yang tersedia daripada set data produk. Oleh itu, pemboleh ubah seperti product.category.name, product.vendor dan variants_item.displayName semuanya tersedia untuk digunakan sebagai sebahagian daripada syarat. Sebaliknya, pemboleh ubah seperti customer.verifiedEmail atau subscriptionContracts_item.status tidak akan dipaparkan sebagai pilihan, kerana ini tidak dikaitkan dengan set data produk.

Walau bagaimanapun, ini tidak semestinya bermakna data yang terkandung dalam set data yang lain tidak boleh diakses sepenuhnya. Sesetengah data boleh diakses daripada berbilang laluan dalam API, sama seperti anda mengklik pelbagai pautan yang berbeza untuk pergi ke halaman yang sama dalam pentadbir Shopify. Secara amalnya, ini bermaksud bahawa pencetus yang berbeza memerlukan tatatanda pemboleh ubah yang berbeza untuk mengembalikan maklumat yang sama.

Sebagai contoh, anda mahu aliran kerja anda menyemak tag pada profil pelanggan. Jika aliran kerja anda bermula dengan pencetus Pesanan dicipta, maka pemboleh ubahnya ialah order.customer.tags kerana aliran kerja bermula dengan data pesanan, kemudian menyemak maklumat pelanggan dalam pesanan, barulah ia menyemak tag pada pelanggan tersebut. Jika aliran kerja anda bermula dengan pencetus Pelanggan dicipta, maka pemboleh ubahnya hanyalah customer.tags kerana aliran kerja bermula dengan data pelanggan, supaya ia boleh terus menyemak tag pada profil pelanggan.

Disebabkan gaya tatatanda titik dalam Shopify Flow, pencarian pemboleh ubah untuk digunakan dalam syarat berdasarkan kata kunci boleh mengembalikan berbilang hasil. Memahami maksud laluan pemboleh ubah adalah penting apabila menentukan pemboleh ubah untuk dipilih semasa membina syarat anda.

Sebagai contoh, aliran kerja anda menggunakan pencetus Pesanan dicipta dan anda mencari pemboleh ubah menggunakan kata kunci tags. Carian anda mungkin mengembalikan hasil berikut yang menyemak maklumat berbeza dalam pesanan:

  • order.tags: Tag yang digunakan pada pesanan itu sendiri. Sebagai contoh, #rush order atau #gift.
  • order.customer.tags: Tag yang digunakan pada pelanggan yang membuat pesanan. Sebagai contoh, #VIP atau #affiliate.
  • order.lineItems.product.tags: Tag yang digunakan pada produk yang dibeli dalam pesanan. Sebagai contoh, #fragile atau #requiresID.

Berdasarkan jenis tag yang ingin disemak oleh aliran kerja, anda perlu memilih pemboleh ubah yang betul supaya syarat anda berfungsi seperti yang dijangkakan.

Memahami pengendali logik dalam syarat

Pengendali logik mentakrifkan cara syarat anda digunakan dan menyebabkan penyataan menjadi benar atau salah. Apabila syarat berbunyi "Jika A lebih besar daripada 10...", bahagian is greater than ialah pengendali logik. Memilih pengendali logik untuk suatu syarat secara asasnya memberitahu syarat tersebut cara untuk menilai pemboleh ubah.

Dalam aliran kerja Shopify Flow, terdapat 3 jenis pengendali logik:

  • Pengendali peringkat medan, seperti Lebih besar daripada atau Bermula dengan.
  • Pengendali senarai, seperti Sekurang-kurangnya satu daripada atau Semua.
  • Pengendali peringkat syarat, seperti AND atau OR.

Pengendali peringkat medan dan pengendali senarai digunakan pada peringkat pemboleh ubah, manakala pengendali peringkat syarat digunakan pada keseluruhan syarat serta boleh digunakan untuk menggabungkan berbilang pemboleh ubah menjadi syarat tunggal.

Pengendali peringkat medan ialah jenis pengendali yang paling biasa, digunakan dalam setiap jenis penyataan pemboleh ubah. Dengan pengendali peringkat medan, anda boleh mencipta penyataan bersyarat seperti "Jika A lebih besar daripada 10, maka lakukan X" atau "Jika B mengandungi 'VIP', maka lakukan X" untuk mempunyai tahap kawalan yang lebih besar terhadap nilai pemboleh ubah yang mengembalikan hasil yang benar. Sama dengan ialah pengendali logik lalai.

Pengendali senarai hanya boleh digunakan pada pemboleh ubah yang boleh mengembalikan senarai hasil. Sebagai contoh, pemboleh ubah lineItems_item.variant.price mengembalikan harga untuk varian produk dalam pesanan yang boleh mengembalikan senarai hasil apabila pelanggan membeli berbilang produk dalam pesanan yang sama. Ini bermakna anda boleh menggunakan pengendali senarai seperti Sekurang-kurangnya satu daripada apabila anda mahu penyataan bersyarat seperti "lineItems_item.variant.price adalah lebih besar daripada $10" menjadi benar apabila terdapat sekurang-kurangnya 1 varian produk dalam pesanan yang melebihi $10. Sebaliknya, pengendali senarai tidak dipaparkan untuk pemboleh ubah yang boleh mengembalikan 1 hasil sahaja pada satu masa. Sebagai contoh, terdapat hanya 1 nilai yang mungkin untuk pemboleh ubah seperti order.createdAt kerana pesanan boleh dicipta hanya sekali, jadi pengendali senarai tidak dipaparkan sebagai pilihan untuk mengubah suai penyataan yang mengandungi pemboleh ubah tersebut.

Pengendali peringkat syarat seperti AND dan OR membolehkan anda menyertakan berbilang pemboleh ubah dalam syarat yang sama. Sebagai contoh, berbanding menggunakan penyataan bersyarat yang ringkas seperti "Jika A sama dengan 5, maka lakukan X", anda boleh membina syarat yang lebih kompleks seperti "Jika A sama dengan 5 dan B lebih besar daripada 10, maka lakukan X" yang memerlukan kedua-dua pemboleh ubah A dan B untuk menjadi benar, atau "Jika A sama dengan 5 atau B lebih besar daripada 10 atau C kurang daripada 1, maka lakukan X" yang memerlukan hanya 1 daripada A, B, atau C untuk menjadi benar. Gunakan AND apabila segala-galanya dalam aliran kerja mestilah benar; gunakan OR apabila mana-mana 1 kriteria yang dipenuhi sudah memadai untuk syarat itu menjadi benar.

Sebab perkara ini penting: Memahami cara pengendali logik berfungsi dalam syarat membolehkan anda membina aliran kerja yang menyemak kriteria yang anda inginkan dengan tepat. Dengan 3 jenis pengendali logik, anda boleh merangka penyataan bersyarat yang terperinci dan kompleks untuk mencipta aliran kerja yang menyemak syarat yang sangat khusus.

Ketahui maklumat yang lebih terperinci tentang pengendali logik dalam syarat.