การใช้ฟิลด์ API ที่มีอาร์กิวเมนต์ใน Shopify Flow เพื่อสร้างตัวแปร

ตัวแปรบางรายการจำเป็นต้องมีพารามิเตอร์เพิ่มเติมเพื่อให้สามารถทำงานได้อย่างถูกต้องในเวิร์กโฟลว์ของ Shopify Flow พารามิเตอร์เหล่านี้คืออาร์กิวเมนต์ที่คุณต้องประกาศค่าก่อน จึงจะถือว่าตัวแปรนั้นสมบูรณ์และใช้งานโดยเวิร์กโฟลว์ได้

ตัวอย่างเช่น ฟิลด์ product.inCollection จะพิจารณาว่าสินค้าอยู่ในคอลเลกชันที่ระบุหรือไม่ และส่งคืนผลลัพธ์เป็นบูลีน true หรือ false อย่างไรก็ตาม ฟิลด์นี้ต้องระบุอาร์กิวเมนต์ id ของคอลเลกชันด้วย เนื่องจากหากไม่ระบุ ตัวแปรก็จะไม่ทราบว่าจะต้องตรวจสอบคอลเลกชันใดโดยเฉพาะ หากต้องการใช้ฟิลด์อย่างถูกต้อง คุณต้องระบุอาร์กิวเมนต์เป็นส่วนหนึ่งของฟิลด์ ตัวอย่างเช่น การสืบค้น product.inCollection(id: "gid://shopify/Collection/123456") เพื่อให้ Flow สามารถระบุได้ว่าสินค้านั้นอยู่ในคอลเลกชันที่มี ID เป็น 123456 หรือไม่ จากนั้นจึงส่งคืน true หรือ false ตามที่คาดไว้ เมื่อสร้างตัวแปรใน Shopify Flow คุณไม่จำเป็นต้องค้นหาค่าต่างๆ เช่น ID ของสินค้าหรือคอลเลกชัน Flow มีเครื่องมือเลือกทรัพยากรเพื่อให้คุณเลือกค่าที่ต้องการ แล้วระบบจะกรอก ID ให้โดยอัตโนมัติ

เพื่อลดความซับซ้อนในการสืบค้นฟิลด์ด้วยอาร์กิวเมนต์ คุณสามารถกำหนดชื่อตัวแปรใหม่ให้กับตัวแปรที่คุณสร้างจากฟิลด์และอาร์กิวเมนต์ใน Shopify Flow ได้ ตัวอย่างเช่น หากคอลเลกชันที่มี ID เป็น 123456 มีชื่อว่า Summer Bestsellers คุณสามารถตั้งชื่อตัวแปร inCollection(id: "gid://shopify/Collection/123456") ใหม่ให้เข้าใจง่ายขึ้นเป็น inSummerBestsellers ได้ จากนั้นในขั้นตอนต่อๆ ไปทั้งหมดของเวิร์กโฟลว์ คุณสามารถใช้ตัวแปร product.inSummerBestsellers ได้เลย

เนื่องจากอาร์กิวเมนต์จะแตกต่างกันไปตามค่าที่กำหนดให้ คุณจึงสามารถสร้างตัวแปรใหม่ได้หลายตัวจากฟิลด์เดียวที่ต้องมีอาร์กิวเมนต์ ตัวอย่างเช่น คุณสามารถสร้างตัวแปรที่ไม่ซ้ำกัน 3 ตัวจากฟิลด์ product.inCollection ได้ดังนี้

• product.inCollection(id: "gid://shopify/Collection/123456") อาจเป็น product.inSummerBestsellers
• product.inCollection(id: "gid://shopify/Collection/654321") อาจเป็น product.inSwimwear
• product.inCollection(id: "gid://shopify/Collection/112233") อาจเป็น product.inBeachAccessories

ฟิลด์ GraphQL Admin API ที่รองรับใน Shopify Flow

Shopify Flow รองรับฟิลด์ต่อไปนี้ใน GraphQL Admin API โดยจำเป็นต้องมีอาร์กิวเมนต์:

• 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
• ฟิลด์ประเภท translations 20 รายการ เช่น collection.translations และ product.translations

ฟิลด์ GraphQL Admin API ที่ไม่รองรับใน Shopify Flow

Shopify Flow ไม่รองรับฟิลด์ต่อไปนี้:

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

หากต้องการใช้ข้อมูลจากฟิลด์ที่ไม่รองรับเหล่านี้ในเวิร์กโฟลว์ของคุณ จะต้องใช้การดำเนินการส่งคำขอ HTTP

การสร้างตัวแปรจากฟิลด์ที่มีอาร์กิวเมนต์

คุณสามารถสร้างตัวแปรใน Shopify Flow สำหรับฟิลด์ใดๆ ที่รองรับและต้องมีอาร์กิวเมนต์ โดยคุณต้องสร้างตัวแปรเพียงครั้งเดียวในเวิร์กโฟลว์หนึ่งๆ เท่านั้น เนื่องจากตัวแปรนั้นจะยังคงใช้งานเป็นตัวเลือกได้ในทุกขั้นตอนถัดไปของเวิร์กโฟลว์

ตัวแปรที่คุณสร้างจะไม่แชร์กับเวิร์กโฟลว์อื่น ดังนั้นหากต้องการใช้ในเวิร์กโฟลว์อื่น คุณจะต้องเพิ่มตัวแปรนั้นอีกครั้งในเวิร์กโฟลว์ดังกล่าว

ขั้นตอน:

1. ในเวิร์กโฟลว์ของ Shopify Flow ให้คลิก เพิ่มตัวแปร ในการดำเนินการหรือเงื่อนไข
2. เลือกช่องที่ต้องใช้อาร์กิวเมนต์ ช่องเหล่านี้จะแสดงปุ่ม + จากนั้นคลิก + สร้างตัวแปร
3. ในกล่องโต้ตอบ สร้างตัวแปร ให้ทำตามขั้นตอนต่อไปนี้:
   1. กำหนดค่าสำหรับอาร์กิวเมนต์ที่จำเป็นตามช่องที่คุณเลือก
   2. ไม่บังคับ: ในช่อง ชื่อตัวแปรใหม่ ให้ปรับแต่งชื่อที่คุณต้องการเรียกตัวแปรใหม่ ชื่อนี้จะใช้กับเวิร์กโฟลว์ปัจจุบันเท่านั้น
   3. คลิก เพิ่ม เพื่อรีเฟรชแผงการเลือกตัวแปร

หลังจากเพิ่มตัวแปรใหม่ลงในเวิร์กโฟลว์แล้ว ตัวแปรจะยังคงใช้งานได้เป็นตัวเลือกช่อง และคุณสามารถอ้างอิงถึงตัวแปรดังกล่าวได้อย่างรวดเร็วในขั้นตอนถัดไป เมื่อเลือก เพิ่มตัวแปร ตัวแปรดังกล่าวจะแสดงซ้อนอยู่ใต้ตัวเลือกช่องเดิมในรายการช่อง

การสร้างตัวแปรจากเมตาฟิลด์ใน Shopify Flow

เมตาฟิลด์คือประเภทของตัวแปรที่มีช่องที่ต้องใช้อาร์กิวเมนต์ การรับข้อมูลเมตาฟิลด์ในเวิร์กโฟลว์ของ Shopify Flow จะแตกต่างจากการรับข้อมูลช่องมาตรฐานในตัวแปรอื่นๆ เล็กน้อย เนื่องจากคุณเป็นผู้สร้างและกำหนดค่าช่อง namespace และ key ของเมตาฟิลด์ ข้อมูลดังกล่าวจึงเป็นข้อมูลเฉพาะสำหรับร้านค้าของคุณเสมอ

ตัวอย่างเช่น ช่อง product.inCollection จะต้องใช้อาร์กิวเมนต์ id เสมอ ไม่ว่าคุณจะทำงานในร้านค้าใดก็ตาม อย่างไรก็ตาม เนื่องจากคุณกำหนดเนมสเปซและคีย์สำหรับทุกเมตาฟิลด์ที่คุณสร้างในร้านค้าของคุณ อาร์กิวเมนต์ที่จำเป็นจึงเป็นแบบกำหนดเอง ดังนั้นตัวแปรสำหรับเมตาฟิลด์สินค้าที่บันทึกคำแนะนำในการดูแลรักษาสินค้าเสื้อผ้าฤดูร้อนอาจเป็น product.careGuideSummer.value หรือตัวแปรสำหรับเมตาฟิลด์สินค้าที่บันทึก ID ของกลุ่มอายุที่สินค้านั้นผลิตมาเพื่อกลุ่มอายุดังกล่าวอาจเป็น product.ageGroup.value_item.taxonomyReference.id โดยคุณเป็นผู้กำหนดชื่อช่องและอาร์กิวเมนต์ทั้งหมดเอง

ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตาฟิลด์ใน Shopify Flow