Memahami kondisi di Shopify Flow

Kondisi adalah langkah dalam alur kerja yang menentukan tindakan selanjutnya berdasarkan terpenuhi atau tidaknya serangkaian kriteria. Setiap langkah kondisi memiliki 2 kemungkinan: Benar, saat kriteria terpenuhi, dan Salah, saat kriteria tidak terpenuhi. Jika Anda tidak menentukan langkah berikutnya untuk salah satu kemungkinan dengan memilih kondisi atau tindakan lain, eksekusi alur kerja akan berhenti.

Misalnya, jika alur kerja Anda dipicu saat pesanan dibuat, maka suatu kondisi dapat memeriksa apakah kode diskon AFFILIATE10 tertentu digunakan pada pesanan tersebut. Jika ya, maka opsi Benar dapat mengarah ke tindakan yang mengirim email ke afiliasi untuk memberi tahu mereka bahwa kodenya telah digunakan. Jika tidak, maka opsi Salah dapat dikosongkan, yang menunjukkan bahwa tidak ada tindakan lebih lanjut yang terjadi dan eksekusi alur kerja berakhir.

Alur kerja dapat memiliki sejumlah kondisi, tergantung pada kerumitan alur kerja Anda. Kondisi juga dapat terhubung ke kondisi atau tindakan lain, tergantung pada apa yang Anda inginkan untuk dilakukan alur kerja. Kondisi dapat diatur untuk terhubung secara berurutan (misalnya, jika kondisi A benar, periksa kondisi B; jika A salah, periksa C), atau Anda dapat mengaturnya agar terjadi secara bersamaan sebagai bagian dari langkah yang sama (misalnya, periksa apakah A atau B atau C benar).

Membuat kondisi untuk alur kerja Anda

Berbeda dengan pemicu atau tindakan, yang dapat Anda pilih dari daftar opsi yang telah ditetapkan di Shopify Flow, kondisi dibuat dari awal dengan memilih variabel, operator logis, dan nilai untuk membuat pernyataan bersyarat:

• Variabel adalah placeholder yang menentukan data yang digunakan oleh kondisi. Misalnya, jika suatu kondisi ingin memeriksa kode diskon tertentu pada pesanan, maka variabelnya adalah order.discountCode. Variabel menggunakan notasi titik GraphQL Admin API.
• ​ Operator logis menunjukkan cara alur kerja harus menentukan apakah kondisi terpenuhi. Operator logis dapat berlaku di tingkat variabel, atau saat beberapa variabel disertakan sebagai bagian dari kriteria kondisi secara keseluruhan:
  • Opsi tingkat variabel mencakup operator tingkat kolom seperti Lebih besar dari atau Dimulai dengan, atau operator daftar seperti Setidaknya salah satu dari atau Semua dari.
  • Opsi tingkat kondisi mencakup DAN, yang berarti semua variabel harus benar agar kondisi dianggap benar secara keseluruhan, atau ATAU, yang berarti setidaknya 1 variabel harus benar agar kondisi dianggap benar secara keseluruhan.
• Nilai adalah informasi aktual yang dicari oleh variabel. Misalnya, jika order.discountCode spesifik yang ingin Anda periksa dalam alur kerja adalah AFFILIATE10, maka itulah nilai yang harus disertakan sebagai bagian dari kondisi.

Saat Anda memilih variabel dan operator, langkah kondisi di kanvas Shopify Flow akan diperbarui untuk mencerminkan pernyataan bersyarat Anda dalam bahasa sederhana, sehingga Anda dapat memeriksa kembali apakah kondisi yang Anda buat diformat dengan benar. Anda dapat mengeklik Tambahkan deskripsi untuk menimpa pernyataan bersyarat default dengan deskripsi tulisan Anda sendiri.

Pelajari informasi yang lebih mendetail tentang elemen kondisi di Shopify Flow.

Memahami variabel dalam kondisi

Saat membuat langkah kondisi dalam alur kerja, langkah pertama yang diminta untuk Anda lakukan adalah Menambahkan variabel. Namun, apa itu variabel?

Di Shopify Flow, variabel adalah placeholder yang menunjukkan data yang digunakan oleh kondisi dalam alur kerja. Saat suatu kondisi berbunyi "Jika A lebih besar dari 10...", bagian A adalah variabelnya. Memilih variabel untuk suatu kondisi pada dasarnya memberi tahu kondisi tersebut data spesifik apa yang harus dievaluasi.

Variabel diformat menggunakan notasi titik GraphQL Admin API. Anda tidak perlu mahir dengan API untuk membuat alur kerja dengan aplikasi Flow, tetapi pemahaman dasar tentang nama variabel dan definisinya dapat membantu Anda membangun logika alur kerja spesifik yang Anda inginkan.

Untuk memahami data apa yang diwakili oleh variabel, pertimbangkan informasi berikut tentang variabel:

• Cara membaca notasi titik variabel.
• Memahami persyaratan data untuk variabel.
• Menemukan variabel yang benar selama pencarian.

Tips: Dapatkan bantuan terkait variabel dari Dev Docs Assistant

Jika Anda tidak yakin variabel mana yang akan dipilih saat membuat kondisi, pertimbangkan untuk meminta saran dari Shopify Dev Docs Assistant. Dev Docs Assistant memiliki akses ke semua dokumentasi mengenai GraphQL Admin API, dan dapat menawarkan saran tentang cara memformat kondisi di Shopify Flow:

1. Buka Shopify Dev Docs.
2. Klik Tanya Asisten untuk membuka panel obrolan.
3. Di kolom pesan, masukkan permintaan Anda, seperti "Variabel mana yang harus saya gunakan di Shopify Flow jika ingin mengakses data tag pelanggan saat pemicu saya dimulai dengan "Pesanan dibuat"?".
4. Tekan Enter atau klik .

Membaca notasi titik variabel

Saat memilih variabel, Anda akan melihat bahwa variabel diformat sebagai kata kunci yang dipisahkan oleh titik, seperti order.customer.tag. Format ini menunjukkan langkah-langkah yang diambil API untuk mendapatkan data yang ingin Anda gunakan. Setiap 'langkah' variabel dipisahkan oleh titik, dan jalur ke data dibaca dari kiri ke kanan. Panjang variabel dapat berbeda-beda, tergantung pada tempat data disimpan di API dan jalur yang ditempuh alur kerja untuk sampai ke sana.

Contoh:

• order.email: Memeriksa alamat email yang terkait dengan pelanggan untuk pesanan tersebut. Ini mirip dengan cara Anda mengeklik pesanan, lalu memeriksa alamat email pada detail pesanan.
• refunds_item.staffMember.name: Memeriksa pesanan untuk pengembalian dana item, membuka informasi staf yang terkait dengan pengembalian dana tersebut, dan memeriksa nama lengkap staf tersebut.

Saat memilih variabel, pertimbangkan cara Anda menavigasi admin Shopify untuk menemukan informasi yang Anda inginkan. Kemungkinan besar, API perlu mengambil jalur yang serupa, yang dapat membantu Anda menentukan format variabel.

Misalnya, jika Anda meninjau pesanan baru dan ingin tahu pelanggan yang terkait dengan pesanan tersebut berada di grup RFM mana, Anda mungkin akan mengeklik nama pelanggan pada pesanan untuk diarahkan ke halaman detail pelanggan di admin Shopify. Selanjutnya, Anda dapat memeriksa ringkasan analitik pelanggan untuk membaca nilai yang ditampilkan di kolom grup RFM.

Variabel yang akan Anda gunakan untuk menampilkan data yang sama di Shopify Flow akan menggunakan jalur yang serupa: order.customer.statistics.rfmGroup.

Persyaratan data untuk variabel

Variabel memerlukan data. Jika data yang tepat tidak tersedia untuk variabel, kondisi tidak akan berfungsi dan alur kerja akan gagal. Berdasarkan pemicu yang Anda pilih sebagai awal alur kerja, opsi variabel untuk ditambahkan ke kondisi Anda akan berubah guna mencerminkan opsi yang memungkinkan berdasarkan data yang tersedia.

Misalnya, jika alur kerja Anda dimulai dengan pemicu Produk dibuat, kondisi yang Anda buat dari pemicu tersebut terbatas pada variabel yang tersedia dari himpunan data produk. Oleh karena itu, variabel seperti product.category.name, product.vendor, dan variants_item.displayName semuanya tersedia untuk digunakan sebagai bagian dari kondisi. Sebaliknya, variabel seperti customer.verifiedEmail atau subscriptionContracts_item.status tidak akan ditampilkan sebagai opsi karena tidak terkait dengan himpunan data produk.

Namun, ini tidak berarti bahwa data yang terdapat dalam himpunan data lain sama sekali tidak dapat diakses. Beberapa data dapat diakses dari beberapa jalur di API, sama seperti cara Anda mengeklik tautan yang berbeda untuk membuka halaman yang sama di admin Shopify. Dalam praktiknya, ini berarti pemicu yang berbeda memerlukan notasi variabel yang berbeda untuk menampilkan informasi yang sama.

Misalnya, Anda ingin alur kerja memeriksa tag di profil pelanggan. Jika alur kerja dimulai dengan pemicu Pesanan dibuat, variabelnya akan menjadi order.customer.tags karena alur kerja dimulai dengan data pesanan, lalu memeriksa informasi pelanggan dalam pesanan, kemudian memeriksa tag pada pelanggan tersebut. Jika alur kerja dimulai dengan pemicu Pelanggan dibuat, variabelnya hanya akan menjadi customer.tags karena alur kerja dimulai dengan data pelanggan, sehingga dapat langsung memeriksa tag di profil pelanggan.

Periksa jalur variabel saat mencari berdasarkan kata kunci

Karena gaya notasi titik di Shopify Flow, pencarian variabel untuk digunakan dalam suatu kondisi berdasarkan kata kunci dapat menampilkan beberapa hasil. Penting untuk memahami apa yang ditunjukkan oleh jalur variabel saat menentukan variabel mana yang akan dipilih ketika Anda membuat kondisi.

Misalnya, alur kerja Anda menggunakan pemicu Pesanan dibuat, dan Anda mencari variabel menggunakan kata kunci tags. Pencarian Anda dapat menampilkan hasil berikut, yang memeriksa berbagai informasi dalam pesanan:

• order.tags: Tag yang diterapkan pada pesanan itu sendiri. Misalnya, #pesanan_cepat atau #hadiah.
• order.customer.tags: Tag yang diterapkan pada pelanggan yang membuat pesanan. Misalnya, #VIP atau #afiliasi.
• order.lineItems.product.tags: Tag yang diterapkan pada produk yang dibeli dalam pesanan. Misalnya, #mudah_pecah atau #perlu_ID.

Berdasarkan jenis tag yang ingin diperiksa oleh alur kerja, Anda perlu memilih variabel yang benar agar kondisi berfungsi seperti yang diharapkan.

Memahami operator logika dalam kondisi

Operator logika menentukan cara kondisi Anda diterapkan dan menghasilkan pernyataan yang benar atau salah. Saat suatu kondisi berbunyi "Jika A lebih besar dari 10...", bagian lebih besar dari adalah operator logikanya. Memilih operator logika untuk suatu kondisi pada dasarnya memberitahu kondisi cara mengevaluasi variabel.

Di alur kerja Shopify Flow, ada 3 jenis operator logika:

• Operator tingkat bidang, seperti Lebih besar dari atau Dimulai dengan.
• Operator daftar, seperti Setidaknya salah satu dari atau Semua dari.
• Operator tingkat kondisi, seperti DAN atau ATAU.

Operator tingkat bidang dan operator daftar berlaku di tingkat variabel, dan operator tingkat kondisi berlaku untuk keseluruhan kondisi serta dapat digunakan untuk menggabungkan beberapa variabel menjadi satu kondisi.

Operator tingkat bidang adalah jenis operator yang paling umum, yang digunakan di setiap jenis pernyataan variabel. Dengan operator tingkat bidang, Anda dapat membuat pernyataan kondisional seperti "Jika A lebih besar dari 10, maka lakukan X" atau "Jika B berisi 'VIP', maka lakukan X" agar memiliki kontrol yang lebih besar atas nilai variabel mana yang akan menghasilkan hasil benar. Sama dengan adalah operator logika default.

Operator daftar hanya dapat berlaku untuk variabel yang dapat menampilkan daftar hasil. Misalnya, variabel lineItems_item.variant.price menampilkan harga untuk varian produk dalam pesanan, yang dapat menampilkan daftar hasil saat pelanggan membeli beberapa produk dalam pesanan yang sama. Artinya, Anda dapat menerapkan operator daftar seperti Setidaknya salah satu dari ketika Anda ingin pernyataan kondisional seperti "lineItems_item.variant.price lebih besar dari $10" menjadi benar ketika setidaknya ada 1 varian produk dalam pesanan yang harganya lebih dari $10. Sebaliknya, operator daftar tidak ditampilkan untuk variabel yang hanya dapat menampilkan 1 hasil pada satu waktu. Misalnya, hanya ada 1 nilai yang mungkin untuk variabel seperti order.createdAt karena pesanan hanya dapat dibuat satu kali, sehingga operator daftar tidak ditampilkan sebagai opsi untuk mengubah pernyataan yang berisi variabel tersebut.

Operator level kondisi seperti AND dan OR memungkinkan Anda menyertakan beberapa variabel dalam kondisi yang sama. Misalnya, alih-alih pernyataan kondisional sederhana seperti "Jika A sama dengan 5, maka lakukan X", Anda dapat membuat kondisi yang lebih kompleks seperti "Jika A sama dengan 5 dan B lebih besar dari 10, maka lakukan X" yang mengharuskan variabel A dan B bernilai benar, atau "Jika A sama dengan 5 atau B lebih besar dari 10 atau C lebih kecil dari 1, maka lakukan X" yang hanya mengharuskan 1 dari variabel A, B, atau C bernilai benar. Gunakan AND saat semua yang ada dalam alur kerja harus bernilai benar; gunakan OR saat salah satu kriteria yang terpenuhi sudah cukup agar kondisi bernilai benar.

Mengapa ini penting: Memahami cara kerja operator logika dalam kondisi memungkinkan Anda membuat alur kerja yang memeriksa kriteria yang Anda inginkan dengan tepat. Dengan 3 jenis operator logika, Anda dapat menyusun pernyataan kondisional yang mendetail dan kompleks untuk membuat alur kerja yang memeriksa kondisi yang sangat spesifik.

Pelajari informasi lebih mendetail tentang operator logika dalam kondisi.