التعامل مع النودات

النودات (Nodes)¹ هي اللبنات الأساسية لسير العمل (Workflow)². وتنفّذ مجموعة من الأعمال، منها:

• بدء الـ Workflow.
• جلب البيانات وإرسالها.
• معالجة البيانات والتعديل عليها.

توفّر n8n مجموعة من النودات الجاهزة، كما تتيح لك إنشاء نودات خاصة بك. راجع:

• التكاملات الجاهزة (Built-in integrations) لتصفّح مكتبة النودات.
• Community nodes لإرشادات العثور على النودات التي أنشأها المجتمع وتثبيتها.
• إنشاء النودات للبدء في بناء نودات خاصة بك.

إضافة نود إلى الـ Workflow

إضافة نود إلى Workflow فارغ

1. اضغط على Add first step. ستفتح n8n لوحة النودات، حيث يمكنك البحث في نودات البدء (trigger nodes)³ أو تصفّحها.

2. اختر الـ trigger الذي تريد استخدامه.
   

   اختر حدث التطبيق (App Event) المناسب

   إذا اخترت On App Event، فستعرض n8n قائمة بجميع الخدمات المدعومة. استخدم هذه القائمة لتصفّح تكاملات n8n وتشغيل Workflow استجابةً لحدث في الخدمة التي اخترتها. ليست لكل التكاملات triggers. لمعرفة التكاملات التي يمكنك استخدامها كـ trigger، اختر النود. وإذا كان هناك trigger متاح، فستجده في أعلى قائمة العمليات المتاحة.

   مثلًا، هذا هو الـ trigger الخاص بـ Asana:

   

إضافة نود إلى Workflow موجود

اضغط على موصّل Add node . ستفتح n8n لوحة النودات، حيث يمكنك البحث في جميع النودات أو تصفّحها.

أدوات التحكم في النود

لعرض أدوات التحكم في النود، مرّر المؤشر فوقه على الـ canvas:

• Execute step : تشغيل النود.
• Deactivate : تعطيل النود.
• Delete : حذف النود.
• Node context menu : اختيار إجراءات النود. الإجراءات المتاحة:
  • Open node
  • Execute step
  • Rename node
  • Deactivate node
  • Pin node
  • Copy node
  • Duplicate node
  • Tidy up workflow
  • Convert node to sub-workflow
  • Select all
  • Clear selection
  • Delete node

إعدادات النود

تتيح لك إعدادات النود في تبويب Settings التحكم في سلوك النود وإضافة ملاحظات عليه.

عند تفعيلها أو تحديدها، تؤدي الوظائف التالية:

• Always Output Data: يُرجع النود عنصرًا فارغًا حتى لو لم يُرجع بيانات أثناء التنفيذ. احذر عند تفعيل هذا الإعداد على نودات IF، فقد يتسبب في حلقة لا نهائية (infinite loop).
• Execute Once: ينفَّذ النود مرة واحدة، ببيانات أول عنصر يستقبله، ولا يعالج أي عناصر إضافية.
• Retry On Fail: عند فشل التنفيذ، يعيد النود التشغيل حتى ينجح.
• On Error:
  • Stop Workflow: يوقف الـ Workflow بالكامل عند حدوث خطأ، ويمنع تنفيذ أي نودات بعده.
  • Continue: يتابع إلى النود التالي رغم الخطأ، باستخدام آخر بيانات سليمة.
  • Continue (using error output): يتابع تنفيذ الـ Workflow ويمرّر معلومات الخطأ إلى النود التالي ليتعامل معها عند الحاجة.
• Custom Span Attributes: إضافة خصائص مخصصة (key-value) إلى OpenTelemetry span الخاص بالنود. المفاتيح نص عادي، والقيم تدعم الـ expressions. لا يظهر هذا الإعداد إلا إذا فعّلت OpenTelemetry tracing وكان لديك ترخيص Enterprise للاستضافة الذاتية. راجع Custom span attributes للتفاصيل.

يمكنك توثيق الـ Workflow باستخدام ملاحظات النود:

• Notes: ملاحظة تُحفظ مع النود.
• Display note in flow: عند تفعيله، تعرض n8n الملاحظة في الـ Workflow كعنوان فرعي (subtitle).

مصادر ذات صلة

• مكوّنات سير العمل
• ربط النودات ببعضها
• إضافة ملاحظات وتوثيق
• مجموعات الـ Canvas
• معرفة رقم سير العمل (ID)

الهوامش

1. النودات في n8n هي مكوّنات فردية تركّبها معًا لإنشاء الـ workflows. تحدد النودات متى يعمل الـ workflow، وتتيح لك جلب البيانات وإرسالها ومعالجتها، ويمكنها تحديد منطق التحكم في التدفق، والاتصال بخدمات خارجية. ↩

2. سير العمل (Workflow) في n8n هو مجموعة من النودات تؤتمت عملية معيّنة. يبدأ التنفيذ عند حدوث شرط تشغيل (trigger)، وتُنفَّذ النودات بالتسلسل لإنجاز مهام معقّدة. ↩

3. الـ trigger node هو نود خاص مسؤول عن تشغيل الـ workflow استجابةً لشروط معيّنة. تحتاج كل الـ workflows في الإنتاج إلى trigger واحد على الأقل لتحديد وقت تشغيل الـ workflow. ↩