التحويل إلى Sub-workflow

استخدم التحويل إلى Sub-workflow لإعادة هيكلة سير العمل (refactoring) إلى أجزاء قابلة لإعادة الاستخدام، كجزء من منطق التدفق. تُحدَّث الـ expressions التي تشير إلى نودات أخرى تلقائيًا وتُضاف كمعاملات (parameters) في نود Execute Workflow Trigger.

راجع الـ Sub-workflows لمقدمة عامة عن هذا المفهوم.

تحديد النودات لتحويلها إلى Sub-workflow

لتحويل جزء من سير العمل إلى Sub-workflow، يجب أن تحدّد في الـ Workflow الأصلي النودات التي تريد تحويلها.

يتم ذلك بتحديد مجموعة نودات صالحة. يجب أن يكون التحديد متصلًا (continuous) وأن يرتبط ببقية سير العمل من نود بداية واحد على الأكثر ونود نهاية واحد على الأكثر. ويجب أن يستوفي التحديد الشروط التالية:

• ألا يتضمن نودات بدء (trigger nodes).
• يمكن لنود واحد فقط في التحديد أن تصله وصلات واردة من نودات خارج التحديد.
  • يمكن لهذا النود أن يستقبل عدة وصلات واردة، لكن عبر فرع إدخال واحد فقط (أي لا يمكن أن يكون نود Merge مثلًا).
  • ولا يمكن أن تصله وصلات واردة من نودات أخرى داخل التحديد.
• يمكن لنود واحد فقط في التحديد أن تخرج منه وصلات إلى نودات خارج التحديد.
  • يمكن لهذا النود أن يخرج منه عدة وصلات، لكن عبر فرع إخراج واحد فقط (أي لا يمكن أن يكون نود If مثلًا).
  • ولا يمكن أن تخرج منه وصلات إلى نودات أخرى داخل التحديد.
• يجب أن يتضمن التحديد جميع النودات الواقعة بين نود الإدخال ونود الإخراج.

كيفية تحويل جزء من سير العمل إلى Sub-workflow

حدّد النودات المطلوبة على الـ canvas. انقر بالزر الأيمن على خلفية الـ canvas واختر Convert to sub-workflow.

أمور يجب مراعاتها

تعمل معظم عمليات التحويل إلى Sub-workflow دون مشاكل، لكن هناك بعض التحفظات والقيود التي يجب مراعاتها:

• يجب ضبط قيود الأنواع للمدخلات والمخرجات يدويًا: افتراضيًا، تسمح مدخلات ومخرجات الـ Sub-workflow بجميع الأنواع. ويمكنك تحديد الأنواع المتوقعة في نود Execute Sub-workflow Trigger الخاص بالـ Sub-workflow وفي نود Edit Fields (set) (المسمّى Return، ويُضاف فقط إذا كان للـ Sub-workflow مخرجات).
• دعم محدود لنودات الذكاء الاصطناعي: عند التعامل مع النودات الفرعية (sub-nodes) مثل أدوات الذكاء الاصطناعي، يجب تحديدها كلها، وقد تحتاج إلى تكرار (duplicate) أي نودات مشتركة مع AI Agents أخرى قبل التحويل.

• يستخدم ترتيب التنفيذ v1: تستخدم الـ Workflows الجديدة ترتيب التنفيذ v1 بغض النظر عن إعدادات الـ Workflow الأصل، ويمكنك تغيير ذلك من الإعدادات.

• دوال الوصول مثل first() وlast() وall() تتطلب عناية إضافية: لا تُترجَم الـ expressions التي تستخدم هذه الدوال دائمًا بسلاسة إلى سياق الـ Sub-workflow. قد تُحوّلها n8n لمحاولة الحفاظ على وظيفتها، لكن عليك التحقق من أنها تعمل كما ينبغي في سياقها الجديد.
  

  لواحق معاملات النود الفرعي (Sub-node parameter suffixes)

  تضيف n8n لواحق مثل _firstItem و_lastItem و_allItems إلى أسماء المتغيرات التي تصل إليها هذه الدوال. يساعد ذلك في الحفاظ على معلومات عن الـ expression الأصلي، لأن ترتيب العناصر قد يختلف في سياق الـ Sub-workflow.

• تتطلب الدالة itemMatching فهرسًا ثابتًا: لا يمكنك استخدام expressions لقيمة الفهرس (index) عند استخدام الدالة itemMatching. يجب أن تمرّر لها رقمًا ثابتًا.

مصادر ذات صلة

• منطق التدفق
• التقسيم بالشروط
• دمج البيانات
• التكرار (Loop)
• الانتظار (Wait)
• فهم ترتيب التنفيذ
• تقسيم سير العمل إلى أجزاء أصغر
• التعامل مع الأخطاء بشكل سليم