تم تحديث المنتج

يبدأ المُشغِّل تم تحديث المنتج سير عمل عند تغيّر حقل واحد أو أكثر في منتج أو في نُسخه داخل متجرك. أنت تختار حقول المنتج والنسخة المهمة بالنسبة لك، ولن يتم تشغيل سير العمل إلا عند تغيّر أحد هذه الحقول، مثل عند إضافة وسم أو تغيّر السعر.

لبدء سير عمل عند إضافة منتج، استخدم المُشغِّل تم إنشاء المنتج. لبدء سير عمل عند تغيّر كمية مخزون نسخة، استخدم المُشغِّل تم تغيير كمية مخزون نسخة المنتج.

الحقول المتاحة للمراقبة

يتطلب المُشغِّل تم تحديث المنتج تحديد حقل واحد على الأقل لمراقبته. يمكنك تحديد ما يصل إلى خمسة حقول. عند تغيّر أي من الحقول المحددة، يتم تشغيل سير العمل. لا تؤدي التغييرات في الحقول التي لم تقم بتحديدها إلى بدء سير العمل.

راجع الجدول التالي لمعرفة المزيد حول الحقول التي يمكنك مراقبتها.

الحقول التي يمكنك مراقبتها باستخدام المُشغِّل "تم تحديث المنتج".
نوع الحقلالحقول
المنتجcategory, combinedListingRole, descriptionHtml, giftCardTemplateSuffix, handle, metafield.value, productType, requiresSellingPlan, status, tags, templateSuffix, title, vendor
الوسائطmedia
الخياراتoptions، options.linkedMetafield، options.linkedMetafield.key، options.linkedMetafield.namespace، options.name، options.optionValues، options.optionValues.linkedMetafieldValue، options.optionValues.name، options.optionValues.swatch، options.optionValues.swatch.color، options.optionValues.swatch.image، options.position
النسخvariants.barcode, variants.barcodes, variants.compareAtPrice, variants.inventoryPolicy, variants.media, variants.metafield.value, variants.position, variants.price, variants.productVariantComponents, variants.productVariantComponents.quantity, variants.requiresComponents, variants.showUnitPrice, variants.taxable, variants.title
الحزمbundleComponents، bundleComponents.quantity، bundleComponents.quantityOption
القوائم المجمعةcombinedListing، combinedListing.combinedListingChildren، combinedListing.combinedListingChildren.parentVariant، combinedListing.combinedListingChildren.product

لمراقبة حقل وصفي لمنتج أو حقل وصفي لنسخة، حدِّد الحقل metafield.value أو الحقل variants.metafield.value، ثم اختر الحقل الوصفي. يمكنك تحديد أحد تعريفات الحقول الوصفية لمتجرك، أو إدخال مساحة اسم لمراقبة كل حقل وصفي في مساحة الاسم تلك، بما في ذلك الحقول الوصفية التي ليس لها تعريف. يُحسَب كل تعريف حقل وصفي أو مساحة اسم تُحددها كواحد من حقولك الخمسة.

بناءً على الحقول التي تراقبها، يمكن أن تؤدي إضافة منتج إلى بدء سير العمل هذا. إن تعيين حقول المنتج، مثل title أو tags، عند إضافة منتج لا يؤدي إلى بدء سير العمل. ومع ذلك، تُعد النسخ، والخيارات، والوسائط، ومكونات الحزمة، ومنتجات القائمة المجمعة التي تتم إضافتها مع المنتج بمثابة تغييرات على ذلك المنتج. إذا كنت تراقب حقلاً في مجموعة الوسائط، أو الخيارات، أو النسخ، أو الحزم، أو القوائم المجمعة، فإن إضافة منتج يتضمن هذه العناصر يؤدي إلى بدء سير العمل. على سبيل المثال، يمتلك كل منتج نسخة واحدة على الأقل، لذا يتم تشغيل سير العمل الذي يراقب variants.price عند إضافة منتج.

تحديد الحقول التي تبدأ سير العمل

حدد الحقول التي تبدأ سير العمل عند تغييرها.

الخطوات:

  1. في مُحرِّر سير العمل، انقر على المُشغِّل تم تحديث المنتج.
  2. في قسم تحديد حقول المنتج، انقر على تحديد الحقول.
  3. في مربع الحوار إضافة حقل للمراقبة، ابحث عن الحقل الذي تريد مراقبته أو تصفّحه، ثم حدّده.
  4. إذا حدّدت metafield.value أو variants.metafield.value، فاختر الحقول الوصفية التي تريد مراقبتها:
    • لمراقبة حقل وصفي واحد، انقر على تحديد حقل وصفي، وحدِّد تعريف حقل وصفي، ثم انقر على إضافة حقل.
    • لمراقبة كل حقل وصفي في مساحة اسم، انقر على تحديد حقل وصفي، ثم انقر على استخدام مساحة الاسم فقط، وأدخِل مساحة الاسم، ثم انقر على إضافة حقل.
  5. اختياري: كرر الخطوات من 2 إلى 4 لمراقبة ما يصل إلى خمسة حقول.

الحقول

يحتوي المُشغِّل تم تحديث المنتج على الحقول التالية، والتي يمكن استخدامها في الشروط والإجراءات، وللحصول على البيانات في سير العمل. حقلا المنتج والمتجر متاحان دائمًا. وتتوفر الحقول الأخرى فقط عند مراقبة حقل ذي صلة. على سبيل المثال، يتوفر حقل نسخة المنتج عندما تراقب حقل نسخة، مثل variants.price.

الحقول في المُشغِّل "تم تحديث المنتج".
الحقلالوصف
المنتجالمنتج الذي تم تحديثه.
المتجرالمتجر الذي تم تحديث المنتج فيه.
نسخة المنتجنسخة المنتج التي تغيّرت. متاح عند مراقبة حقل نسخة.
خيار المنتجخيار المنتج الذي تغيّر. متاح عند مراقبة حقل خيار.
الوسائطالوسائط التي تغيّرت. متاح عند مراقبة وسائط المنتج.
منتج القائمة المجمعةالمنتج الفرعي التابع للقائمة المجمعة والذي تغيّر. متاح عند مراقبة المنتجات في قائمة مجمعة.

إذا كنت تراقب حقولاً من أنواع مختلفة، فيمكن أن تكون الحقول نسخة المنتج، وخيار المنتج، والوسائط، ومنتج القائمة المجمعة فارغة عند تشغيل سير العمل. على سبيل المثال، إذا كنت تراقب كلاً من tags وvariants.price، فسيكون حقل نسخة المنتج فارغًا عندما تتغير الوسوم فقط. وقبل استخدام أحد هذه الحقول في إجراء، أضف شرطًا يتحقق من وجود قيمة في الحقل.

يوفّر المُشغِّل تحديث منتج القيم الحالية للمنتج ونسخه وخياراته ووسائطه فقط. القيم السابقة للحقول التي تغيّرت غير متاحة في سير العمل. على سبيل المثال، إذا راقبت الحقل variants.price، فيمكنك استخدام السعر الجديد في شرط أو إجراء، ولكن لا يمكنك استخدام السعر قبل التغيير.

اختبار مُشغِّل تحديث المنتج

لاختبار سير عمل يبدأ بهذا المُشغِّل، شغّل سير العمل، ثم عدِّل منتجًا في لوحة إدارة متجر Shopify لتغيير أحد الحقول التي يراقبها سير العمل.

تفاصيل واجهة برمجة التطبيقات

يُتيح مُشغِّل تحديث المنتج اتخاذ إجراءات باستخدام كائن واجهة GraphQL API للمنتج. يتوافق هذا المُشغِّل مع إجراء update لـ موضوع المنتج في مرجع Shopify Events، مع تصفيته حسب الحقول التي تختار مراقبتها.