متغیرات بنانے کے لیے Shopify Flow میں آرگیومنٹس کے ساتھ API فیلڈز کا استعمال

کچھ متغیرات کو Shopify Flow کے ورک فلو میں درست طریقے سے کام کرنے کے لیے اضافی پیرامیٹرز کی ضرورت ہوتی ہے۔ یہ پیرامیٹرز وہ آرگیومنٹس (arguments) ہیں جن کی ویلیوز آپ کو ڈکلیئر کرنی ہوتی ہیں، اس سے پہلے کہ متغیر کو مکمل تصور کیا جائے اور اسے ورک فلو کے ذریعے استعمال کیا جا سکے۔

مثال کے طور پر، product.inCollection فیلڈ یہ تعین کرتی ہے کہ آیا کوئی پروڈکٹ کسی مخصوص کلیکشن میں ہے یا نہیں اور بولین (Boolean) کے طور پر true یا false نتیجہ واپس کرتی ہے۔ تاہم، اس فیلڈ کے لیے کلیکشن کا id آرگیومنٹ شامل کرنا ضروری ہے، کیونکہ بصورت دیگر متغیر کو معلوم نہیں ہو گا کہ کس مخصوص کلیکشن کو چیک کرنا ہے۔ فیلڈ کو درست طریقے سے استعمال کرنے کے لیے، آپ کو آرگیومنٹ کو فیلڈ کے حصے کے طور پر شامل کرنا ہوگا۔ مثال کے طور پر، product.inCollection(id: "gid://shopify/Collection/123456") کووری (querying) کرنا تاکہ Flow یہ تعین کر سکے کہ آیا پروڈکٹ 123456 کی ID والے کلیکشن میں ہے یا نہیں، اور پھر توقع کے مطابق true یا false واپس کرے۔ Shopify Flow میں متغیرات بناتے وقت، آپ کو پروڈکٹ یا کلیکشن IDs جیسی ویلیوز تلاش کرنے کی ضرورت نہیں ہے۔ Flow وہ ویلیو منتخب کرنے کے لیے ایک ریسورس پکر (resource picker) فراہم کرتا ہے جو آپ چاہتے ہیں، اور ID خودکار طور پر پُر ہو جاتی ہے۔

آرگیومنٹ کے ساتھ فیلڈ کو کیوری کرنے کے تجربے کو آسان بنانے کے لیے، آپ اس ویری ایبل کو ایک نیا نام دے سکتے ہیں جسے آپ Shopify Flow میں فیلڈ اور آرگیومنٹ سے بناتے ہیں۔ مثال کے طور پر، اگر 123456 کی ID والی کلیکشن کا نام Summer Bestsellers ہے، تو آپ inCollection(id: "gid://shopify/Collection/123456") ویری ایبل کو inSummerBestsellers کا ایک سادہ نام دے سکتے ہیں۔ پھر، ورک فلو کے بعد کے تمام مراحل میں، آپ آسانی سے ویری ایبل product.inSummerBestsellers استعمال کر سکتے ہیں۔

چونکہ انہیں تفویض کی گئی ویلیو کی بنیاد پر آرگیومنٹ مختلف ہوتے ہیں، لہذا آپ آرگیومنٹ درکار ہونے والی ایک ہی فیلڈ سے متعدد نئے ویری ایبل بنا سکتے ہیں۔ مثال کے طور پر، آپ صرف product.inCollection فیلڈ سے 3 منفرد ویری ایبل بنا سکتے ہیں:

• 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 ہو سکتا ہے۔

Shopify Flow میں معاونت یافتہ GraphQL Admin API فیلڈ

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
• 20 translations قسم کی فیلڈ، جیسے collection.translations اور product.translations

Shopify Flow میں غیر معاونت یافتہ GraphQL Admin API فیلڈ

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 آرگومنٹ درکار ہوتا ہے، قطع نظر اس کے کہ آپ کس سٹور میں کام کر رہے ہیں۔ تاہم، چونکہ آپ اپنے سٹور میں تخلیق کردہ ہر میٹا فیلڈ کے لیے نیم سپیس اور key سیٹ کرتے ہیں، اس لیے مطلوبہ آرگومنٹ کسٹم ہوتے ہیں۔ لہذا، گرمیوں کے کپڑوں کے پروڈکٹ کی دیکھ بھال کی ہدایات کو کیپچر کرنے والے پروڈکٹ میٹا فیلڈ کا ویری ایبل product.careGuideSummer.value ہو سکتا ہے، یا کسی ایسے پروڈکٹ میٹا فیلڈ کا ویری ایبل جو اس عمر کے گروپ کی ID ریکارڈ کرتا ہے جس کے لیے پروڈکٹ بنائی گئی ہے، product.ageGroup.value_item.taxonomyReference.id ہو سکتا ہے۔ فیلڈ کے نام اور آرگومنٹ کا تعین مکمل طور پر آپ کے ذریعے کیا جاتا ہے۔

Shopify Flow میں میٹا فیلڈ کے بارے میں مزید جانیں۔