Menggunakan medan API dengan argumen dalam Shopify Flow untuk mencipta pemboleh ubah

Sesetengah pemboleh ubah memerlukan parameter tambahan untuk berfungsi dengan betul dalam aliran kerja Shopify Flow. Parameter ini merupakan argumen yang nilainya mesti diisytiharkan oleh anda sebelum pemboleh ubah dianggap lengkap dan boleh digunakan oleh aliran kerja.

Sebagai contoh, medan product.inCollection menentukan sama ada produk berada dalam koleksi yang ditentukan atau tidak serta memulangkan hasil Boolean true atau false. Walau bagaimanapun, argumen id koleksi mestilah disertakan untuk medan ini, jika tidak, pemboleh ubah tidak akan mengetahui koleksi khusus yang perlu disemak. Untuk menggunakan medan dengan betul, anda perlu menyertakan argumen sebagai sebahagian daripada medan. Sebagai contoh, menanyakan product.inCollection(id: "gid://shopify/Collection/123456") agar Flow boleh menentukan sama ada produk tersebut berada dalam koleksi berserta ID 123456 ataupun tidak, lalu memulangkan true atau false seperti yang dijangkakan. Apabila mencipta pemboleh ubah dalam Shopify Flow, anda tidak perlu mencari nilai seperti ID produk atau koleksi. Flow menyediakan pemetik sumber untuk memilih nilai yang anda mahukan dan ID diisikan secara automatik.

Untuk mempermudah pengalaman menanyakan medan dengan argumen, anda boleh mengumpukkan nama pemboleh ubah baharu pada pemboleh ubah yang dicipta daripada medan dan argumen dalam Shopify Flow. Sebagai contoh, jika nama koleksi yang mempunyai ID 123456 ialah Summer Bestsellers, maka anda boleh mengumpukkan nama yang lebih ringkas kepada pemboleh ubah inCollection(id: "gid://shopify/Collection/123456"), iaitu inSummerBestsellers. Kemudian, dalam semua langkah aliran kerja seterusnya, anda hanya perlu menggunakan pemboleh ubah product.inSummerBestsellers.

Oleh sebab argumen berbeza bergantung pada nilai yang diumpukkan pada argumen tersebut, anda boleh mencipta berbilang pemboleh ubah baharu daripada satu medan yang memerlukan argumen. Sebagai contoh, anda boleh mencipta 3 pemboleh ubah unik hanya daripada medan product.inCollection:

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

Medan GraphQL Admin API yang disokong dalam Shopify Flow

Shopify Flow menyokong medan berikut dalam GraphQL Admin API 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 medan jenis translations, seperti collection.translations dan product.translations

Medan GraphQL Admin API yang tidak disokong dalam Shopify Flow

Shopify Flow tidak menyokong medan berikut:

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

Untuk menggunakan data daripada medan yang tidak disokong ini dalam aliran kerja anda, anda mesti menggunakan tindakan Hantar permintaan HTTP.

Mencipta pemboleh ubah daripada medan dengan argumen

Anda boleh mencipta pemboleh ubah dalam Shopify Flow untuk sebarang medan yang disokong yang memerlukan argumen. Anda hanya perlu mencipta pemboleh ubah satu kali dalam satu aliran kerja, kerana pemboleh ubah itu akan kekal tersedia sebagai pilihan dalam semua langkah aliran kerja seterusnya.

Pemboleh ubah yang anda cipta tidak dikongsi dengan mana-mana aliran kerja yang lain, oleh itu untuk menggunakannya dalam aliran kerja yang lain, anda mesti menambahkannya semula dalam aliran kerja tersebut.

Langkah-langkah:

1. Dalam aliran kerja Shopify Flow, klik Tambah pemboleh ubah dalam tindakan atau syarat.
2. Pilih medan yang memerlukan argumen. Medan ini memaparkan butang +. Kemudian, klik + Cipta pemboleh ubah.
3. Dalam dialog Cipta pemboleh ubah , lakukan langkah-langkah berikut:
   1. Berdasarkan medan yang anda pilih, tetapkan nilai untuk argumen yang diperlukan.
   2. Pilihan: Dalam medan Nama pemboleh ubah baharu, sesuaikan nama yang anda inginkan untuk pemboleh ubah baharu tersebut. Nama ini hanya terpakai kepada aliran kerja semasa.
   3. Klik Tambah untuk menyegarkan panel pemilihan pemboleh ubah.

Selepas menambahkan pemboleh ubah baharu pada aliran kerja, pemboleh ubah tersebut akan kekal tersedia sebagai pilihan medan dan anda boleh merujuknya dengan pantas dalam langkah-langkah yang seterusnya. Apabila memilih untuk Tambah pemboleh ubah, pemboleh ubah tersebut dipaparkan secara bersarang di bawah pilihan medan asal dalam senarai medan.

Mencipta pemboleh ubah daripada medan meta dalam Shopify Flow

Medan meta ialah sejenis pemboleh ubah dengan medan yang memerlukan argumen. Mendapatkan data medan meta dalam aliran kerja Shopify Flow sedikit berbeza daripada mendapatkan data medan standard dalam pemboleh ubah lain kerana anda mencipta dan mentakrifkan nilai medan namespace dan key bagi medan meta, jadi nilai ini sentiasa unik untuk kedai anda.

Sebagai contoh, medan product.inCollection sentiasa memerlukan argumen id, tanpa mengira kedai yang anda sedang gunakan. Walau bagaimanapun, memandangkan anda menetapkan ruang nama dan kunci bagi setiap medan meta yang anda cipta di kedai anda, argumen yang diperlukan adalah tersuai. Oleh itu, pemboleh ubah bagi medan meta produk yang merakam arahan penjagaan untuk produk pakaian musim panas mungkin ialah product.careGuideSummer.value, atau pemboleh ubah bagi medan meta produk yang merekodkan ID kumpulan umur produk tersebut mungkin ialah product.ageGroup.value_item.taxonomyReference.id. Nama medan dan argumen ditentukan sepenuhnya oleh anda.

Ketahui lebih lanjut tentang medan meta dalam Shopify Flow.