Function Node في N8N: دليل بالأمثلة

مقدمة

عالم الأتمتة دلوقتي بقى أساسي لأي شغل، وN8N من أقوى الأدوات اللي بتساعدك تعمل ده بكفاءة. بس أحيانًا، بتحتاج تعمل حاجات معينة مش موجودة جاهزة في النودز القياسية. هنا بيجي دور Function Node في N8N، الأداة اللي بتديلك قوة تعديل البيانات والتحكم فيها بالظبط زي ما أنت عايز باستخدام كود JavaScript بسيط. المقالة دي هتاخدك في رحلة عملية عشان تفهم إيه هو الـ Function Node وإزاي تستخدمه بأمثلة واضحة.

يعني إيه Node في N8N قبل ما نتكلم في التفاصيل؟

النود في N8N هي زي ما تكون “وحدة بناء” في الـ workflow بتاعك، كل نود بتعمل وظيفة محددة زي إنها تجيب بيانات، تعدل عليها، أو تبعتها لمكان تاني. ببساطة، هي المكون الأساسي اللي بتبني بيه الـ automation بتاعك. عشان تفهم أكتر عن أنواع النودز المختلفة ودورها، ممكن تبص على مقالتنا عن إيه هو الـ Node في N8N بالتفصيل.

إيه هو الـ Function Node وبيعمل إيه بالظبط؟

الـ Function Node في N8N هو نود مخصصة لتشغيل كود JavaScript مخصص لتعديل أو معالجة البيانات اللي بتعدي في الـ workflow بتاعك. بيسمح لك تعمل أي عملية مش موجودة في النودز الجاهزة، زي إنك تغير صيغة البيانات، تحسب قيم معينة، أو حتى تعمل منطق شرطي معقد. وظيفته الأساسية هي إدخال مرونة غير محدودة للتعامل مع البيانات.

ازاي أستخدم الـ Function Node في 3 خطوات؟ (مثال عملي)

استخدام الـ Function Node سهل وفعال لو فهمت الأساسيات، وده مثال عملي عشان نوضح الموضوع. تخيل إن عندنا بيانات منتجات جاية من API بالشكل ده: `[{ “product_name”: “لابتوب”, “price”: 1200 }]` وإحنا عايزين نغير اسم المفتاح من `product_name` لـ `name` ونضيف مفتاح جديد اسمه `currency` قيمته “EGP”.

1. ضيف الـ Function Node للـ workflow بتاعك: اسحب الـ Function Node من قائمة النودز وحطها بعد النود اللي بتطلع البيانات اللي عايز تعدلها.
2. اكتب كود JavaScript بتاعك: افتح الـ Function Node وحط الكود ده جوه صندوق الـ “Function”:

   for (const item of items) {
     item.json.name = item.json.product_name;
     item.json.currency = "EGP";
     delete item.json.product_name; // بنمسح المفتاح القديم
   }
   return items;

   الكود ده بيلف على كل عنصر (item) جاي من النود اللي قبلها، بيضيف مفتاح `name` بياخد قيمة `product_name`، بيضيف `currency`، وبعدين بيمسح `product_name` القديم.

3. شغل الـ workflow وشوف النتيجة: بعد ما تشغل الـ workflow، هتلاقي البيانات خرجت بالشكل ده: `[{ “name”: “لابتوب”, “price”: 1200, “currency”: “EGP” }]`.

غلطة المبتدئين الشائعة: كتير بينسوا يرجعوا الـ `items` في آخر الكود عن طريق `return items;`. الـ Function Node لازم ترجع مصفوفة من الـ `items` عشان الـ workflow يقدر يكمل شغله بشكل صحيح. لو نسيت دي، النود اللي بعدها مش هتلاقي أي بيانات تكمل عليها.

إيه الفرق بين الـ Function Node والـ Code Node؟

الاثنين بيسمحوا لك تكتب كود JavaScript، لكن لكل واحد استخدام مختلف. الـ Function Node مخصصة أكتر لمعالجة وتعديل البيانات اللي بتمر بيها (data transformation) داخل الـ workflow بشكل مباشر وبسيط، وبتتعامل مع المدخلات والمخرجات على أساس إنها `items`. أما الـ Code Node فهي أقوى وبتديلك تحكم أكبر، بتقدر تستخدم فيها مكتبات خارجية، تعمل API calls مباشرة من جوه الكود، وتعمل عمليات معقدة ممكن توقف تنفيذ الـ workflow لحد ما تخلص. لو عايز تعرف تفاصيل أكتر عن استخدامها، شوف دليلنا عن الـ Code Node في N8N.

امتى أستخدم Expressions بدل الـ Function Node؟

الـ Expressions في N8N هي طريقة سريعة وبسيطة لربط البيانات بين النودز أو لتطبيق تحويلات بسيطة بدون كود كامل. لو كنت محتاج تجيب قيمة من نود سابقة، أو تعمل عملية حسابية بسيطة (زي جمع رقمين)، أو تعدل على نص بطريقة مباشرة زي دمج strings، الـ Expressions بتكون هي الحل الأمثل والأسهل. استخدام Function Node في الحالات البسيطة دي بيكون Overkill وممكن يكون أبطأ. لكن لو محتاج تعمل loops، شروط معقدة (if/else)، أو عمليات على مصفوفات بيانات، هنا بيجي دور Function Node في N8N. ممكن تتعمق أكتر في فهم الـ Expressions وإمكانياتها من خلال مقالنا عن الـ Expressions في N8N.

أشهر استخدامات عملية للـ Function Node في N8N

الـ Function Node مفيدة جدًا في سيناريوهات كتير:

• تنسيق البيانات: تغيير صيغة التواريخ، تحويل العملات، أو تنظيف النصوص (مثل إزالة المسافات الزائدة).
• الحسابات والمعالجات: حساب خصومات، ضرائب، أو دمج بيانات من حقول مختلفة لإنشاء حقل جديد.
• التعامل مع المصفوفات: فلترة عناصر من قائمة، أو تقسيم قائمة كبيرة لقوائم أصغر، أو دمج قوائم مختلفة.
• المنطق الشرطي: تطبيق شروط معينة على البيانات لتحديد مسار الـ workflow التالي، أو تعديل البيانات بناءً على قيم معينة.
• إضافة بيانات ديناميكية: إنشاء مفاتيح وقيم جديدة بناءً على بيانات موجودة بالفعل في الـ item.

لو عايز تتعمق أكتر في بناء أنظمة الأتمتة والذكاء الاصطناعي وتتقن أدوات زي N8N عشان تبني حلول متكاملة، ممكن تبص على دوراتنا التدريبية في الأتمتة والذكاء الاصطناعي.

الأسئلة الشائعة

ملخص المقالة

الـ Function Node في N8N هي أداة قوية ومرنة بتديك القدرة على التحكم الكامل في بياناتك داخل الـ workflow عن طريق كتابة كود JavaScript مخصص. فهمها واستخدامها صح هيفتح لك أبواب كتير لإمكانيات أتمتة معقدة ومخصصة، وبيخليك تعدل على البيانات بالطريقة اللي تناسب احتياجاتك بالظبط. ابدأ جربها في الـ workflows بتاعتك وهتكتشف قد إيه هي مفيدة.