Menggunakan bidang API dengan argumen di Shopify Flow untuk membuat variabel

Beberapa variabel memerlukan parameter tambahan agar dapat berfungsi dengan baik dalam alur kerja Shopify Flow. Parameter ini merupakan argumen yang nilainya harus Anda nyatakan sebelum variabel tersebut dianggap lengkap dan dapat digunakan oleh alur kerja.

Misalnya, bidang product.inCollection menentukan apakah suatu produk ada di dalam koleksi yang ditentukan atau tidak dan mengembalikan hasil Boolean true atau false. Namun, argumen id koleksi harus disertakan untuk bidang ini, karena jika tidak, variabel tidak akan tahu koleksi khusus mana yang harus diperiksa. Untuk menggunakan bidang dengan benar, Anda harus menyertakan argumen sebagai bagian dari bidang tersebut. Misalnya, kueri product.inCollection(id: "gid://shopify/Collection/123456") agar Flow dapat menentukan apakah produk tersebut ada di dalam koleksi dengan ID 123456, lalu mengembalikan true atau false sesuai harapan. Saat membuat variabel di Shopify Flow, Anda tidak perlu mencari nilai seperti ID produk atau koleksi. Flow menyediakan pemilih sumber daya untuk memilih nilai yang Anda inginkan, dan ID tersebut akan diisi secara otomatis.

Untuk mempermudah pengalaman mengkueri bidang dengan argumen, Anda dapat menetapkan nama variabel baru ke variabel yang Anda buat dari bidang dan argumen di Shopify Flow. Misalnya, jika nama koleksi dengan ID 123456 adalah Summer Bestsellers, maka Anda dapat menetapkan nama yang lebih sederhana inSummerBestsellers pada variabel inCollection(id: "gid://shopify/Collection/123456"). Kemudian, di semua langkah alur kerja berikutnya, Anda cukup menggunakan variabel product.inSummerBestsellers.

Karena argumennya berbeda bergantung pada nilai yang ditetapkan padanya, Anda dapat membuat beberapa variabel baru dari satu bidang yang memerlukan argumen. Misalnya, Anda dapat membuat 3 variabel unik hanya dari bidang product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") dapat menjadi product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") dapat menjadi product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") dapat menjadi product.inBeachAccessories.

Bidang GraphQL Admin API yang didukung di Shopify Flow

Shopify Flow mendukung bidang GraphQL Admin API berikut dengan argumen yang diperlukan:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 bidang jenis translations, seperti collection.translations dan product.translations

Bidang GraphQL Admin API yang tidak didukung di Shopify Flow

Shopify Flow tidak mendukung bidang berikut:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Untuk menggunakan data dari bidang yang tidak didukung ini dalam alur kerja Anda, Anda harus menggunakan tindakan Kirim permintaan HTTP.

Membuat variabel dari bidang dengan argumen

Anda dapat membuat variabel di Shopify Flow untuk setiap bidang yang didukung yang memerlukan argumen. Anda hanya perlu membuat variabel ini satu kali dalam satu alur kerja, karena variabel tersebut tetap tersedia sebagai opsi pada semua langkah alur kerja berikutnya.

Variabel yang Anda buat tidak dibagikan dengan alur kerja lainnya, jadi untuk menggunakannya di alur kerja lain, Anda harus menambahkannya lagi di alur kerja tersebut.

Langkah-langkah:

1. Di alur kerja Shopify Flow, klik Tambahkan variabel di tindakan atau kondisi.
2. Pilih bidang yang memerlukan argumen. Bidang ini menampilkan tombol +. Kemudian, klik + Buat variabel.
3. Pada dialog Buat variabel , lakukan langkah-langkah berikut:
   1. Berdasarkan bidang yang Anda pilih, tetapkan nilai untuk argumen yang diperlukan.
   2. Opsional: Di bidang Nama variabel baru, sesuaikan nama variabel baru yang Anda inginkan. Nama ini hanya berlaku untuk alur kerja saat ini.
   3. Klik Tambahkan untuk menyegarkan panel pemilihan variabel.

Setelah menambahkan variabel baru ke alur kerja, variabel tersebut tetap tersedia sebagai opsi bidang dan Anda dapat mereferensikannya dengan cepat di langkah-langkah berikutnya. Saat memilih Tambahkan variabel, variabel ini ditampilkan bertingkat di bawah opsi bidang asli dalam daftar bidang.

Membuat variabel dari metafield di Shopify Flow

Metafield adalah jenis variabel dengan bidang yang memerlukan argumen. Mendapatkan data metafield di alur kerja Shopify Flow sedikit berbeda dengan mendapatkan data bidang standar di variabel lain karena Anda membuat dan menentukan nilai bidang namespace dan key metafield, sehingga nilainya selalu unik untuk toko Anda.

Misalnya, bidang product.inCollection selalu memerlukan argumen id, terlepas dari toko mana yang sedang Anda kerjakan. Namun, karena Anda menetapkan ruang nama dan kunci untuk setiap metafield yang dibuat di toko Anda, argumen yang diperlukan bersifat khusus. Jadi, variabel untuk metafield produk yang menangkap instruksi perawatan untuk produk pakaian musim panas mungkin adalah product.careGuideSummer.value, atau variabel untuk metafield produk yang mencatat ID kelompok umur produk tersebut mungkin adalah product.ageGroup.value_item.taxonomyReference.id. Nama bidang dan argumen ditentukan sepenuhnya oleh Anda.

Pelajari selengkapnya tentang metafield di Shopify Flow.