استخدام حقول API مع الوسيطات في Shopify Flow لإنشاء متغيرات

تتطلب بعض المتغيرات مُعلمات إضافية لتعمل بشكل صحيح في سير عمل Shopify Flow. هذه المُعلمات هي وسيطات (arguments) يجب أن تحدد قيمها بنفسك قبل أن يُعتبر المتغير مكتملاً وقابلاً للاستخدام في سير العمل.

على سبيل المثال، يحدد الحقل product.inCollection ما إذا كان منتج ما موجوداً في مجموعة محددة أم لا، ويُرجع نتيجة منطقية true أو false. ومع ذلك، يجب تضمين وسيطة id الخاصة بالمجموعة لهذا الحقل، لأنه بخلاف ذلك لن يعرف المتغير المجموعة المحددة التي يجب التحقق منها. لاستخدام الحقل بشكل صحيح، يجب عليك تضمين الوسيطة كجزء من الحقل. على سبيل المثال، الاستعلام عن product.inCollection(id: "gid://shopify/Collection/123456") حتى يتمكن Flow من تحديد ما إذا كان المنتج موجوداً في المجموعة ذات المُعرّف 123456 أم لا، ثم إرجاع true أو false كما هو متوقع. عند إنشاء متغيرات في Shopify Flow، لا تحتاج إلى البحث عن قيم مثل مُعرّفات المنتجات أو المجموعات. يوفر Flow أداة انتقاء موارد لتحديد القيمة التي تريدها، وتتم تعبئة المُعرّف تلقائياً.

لتبسيط تجربة الاستعلام عن الحقول ذات الوسائط، يمكنك تعيين اسم متغير جديد للمتغير الذي تُنشئه من الحقل والوسيطة في Shopify Flow. على سبيل المثال، إذا كان اسم المجموعة التي تحمل المعرّف 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
• 20 حقلًا من نوع translations، مثل 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، أو قد يكون المتغير الخاص بحقل تعريفي لمنتج يسجل معرّف الفئة العمرية المخصص لها المنتج هو product.ageGroup.value_item.taxonomyReference.id. تُحدد أسماء الحقول والوسائط بالكامل بواسطتك.

تعرّف على المزيد حول الحقول التعريفية في Shopify Flow.