شرح أنواع البيانات داخل n8n للمبتدئين
بسم الله والصلاة والسلام على رسول الله،
اللهم علمنا ما ينفعنا وانفعنا بما علمتنا إنك أنت العليم الحكيم.
في هذا المقال سنتعرف على أنواع البيانات داخل منصة n8n، وهي من أهم الأساسيات التي لا غنى عنها لأي شخص يعمل في الأتمتة وبناء الـ Workflows.
فهمك لأنواع البيانات في n8n هو الذي يحدد قدرتك على ربط النودز ببعضها، ومعالجة الداتا بشكل صحيح، وتجنب الأخطاء أثناء التنفيذ.
لماذا فهم أنواع البيانات مهم في n8n
n8n تعتمد بشكل أساسي على تمرير البيانات بين النودز.
كل نود تستقبل Input وتُخرج Output، وإذا لم يكن نوع البيانات صحيحًا أو متوافقًا مع النود التالية، سيتوقف الـ Workflow أو يعطي نتائج خاطئة.
معرفة نوع البيانات تساعدك على:
استخدام Node Set و Edit Field بشكل صحيح
معالجة البيانات قبل إرسالها إلى API
بناء Workflows احترافية بدون أخطاء
استخدام Manual Trigger و Node Set في n8n
عادةً ما نبدأ الشرح باستخدام Manual Trigger لأنه أبسط Trigger في n8n ويساعدنا على تجربة البيانات يدويًا.
بعد ذلك نستخدم Node Set أو Edit Fields للتحكم في شكل البيانات، سواء أردنا تعديلها أو إعادة إخراجها بتنسيق مختلف.
من خلال هذه النود، يمكننا إنشاء أنواع مختلفة من البيانات وفهم كيف يتعامل معها n8n.
نوع البيانات النصية String في n8n
الـ String هو أبسط نوع بيانات داخل n8n.
يُستخدم لتخزين أي نص مثل الاسم، الرسائل، العناوين، أو أي محتوى كتابي.
عند عرض البيانات في n8n، ستلاحظ أن القيم النصية تظهر بشكل واضح داخل الـ JSON، ويكون بجانبها رمز يدل على أنها نص وليست رقمًا.
نوع البيانات الرقمية Number
الـ Number يُستخدم مع القيم الرقمية مثل العمر، السعر، الكمية، أو أي قيمة حسابية.
الفرق بينه وبين النص أن الرقم يمكن استخدامه في العمليات الحسابية داخل الـ Workflow.
n8n تميز الأرقام تلقائيًا، مما يساعدك على اكتشاف الأخطاء عند تمرير البيانات بين النودز.
القيم المنطقية Boolean داخل n8n
الـ Boolean نوع بيانات له قيمتان فقط، صحيح أو خاطئ.
يُستخدم بكثرة في الشروط داخل IF Node أو أثناء اتخاذ قرار داخل الـ Workflow.
هذا النوع شائع جدًا عند التعامل مع:
Checkboxes في الفورمز
التحقق من حالة معينة
تفعيل أو تعطيل منطق معين
المصفوفات Array في n8n
الـ Array هي مجموعة عناصر مجمعة معًا.
تُستخدم عندما يكون لديك أكثر من قيمة لنفس العنصر مثل قائمة أصدقاء، منتجات، أو نتائج متعددة من API.
داخل n8n، المصفوفات تظهر بشكل واضح في الـ JSON، ويمكن التعامل معها باستخدام Looping أو Nodes مخصصة لمعالجة العناصر واحدًا تلو الآخر.
الكائن Object ولماذا هو الأهم في n8n
الـ Object هو أهم نوع بيانات في n8n، وغالبًا ما يكون في شكل JSON.
يمكن اعتباره صندوق منظم يحتوي على عدة قيم، كل قيمة لها اسم وقيمة محددة.
n8n تعتمد بشكل أساسي على Objects عند:
استقبال البيانات من API
إرسال البيانات إلى تطبيقات أخرى
تنظيم المعلومات داخل الـ Workflow
ما هو JSON في n8n
JSON هو الشكل القياسي الذي تستخدمه n8n في عرض وتمرير البيانات.
يعتمد على مبدأ Key و Value، مما يجعله سهل القراءة والمعالجة.
باستخدام JSON، يمكن إرسال كل بيانات المستخدم أو الطلب أو العملية في كائن واحد منظم بدلًا من التعامل مع كل قيمة بشكل منفصل.
الكائنات المتداخلة في Workflows n8n
في التطبيقات الحقيقية، ستتعامل كثيرًا مع Objects داخل Objects.
مثل Object يمثل طالب، يحتوي على الاسم والعمر ومصفوفة أصدقاء، وكل ذلك داخل Object أكبر مثل مدرسة أو نظام.
n8n تتعامل مع هذا النوع من البيانات بكفاءة عالية، بشرط أن تكون فاهم البنية بشكل صحيح.
كيف يساعدك ChatGPT أثناء العمل على n8n
إذا وجدت صعوبة في إنشاء JSON أو تنظيم البيانات، يمكنك استخدام ChatGPT لإنشاء هيكل البيانات الذي تحتاجه.
سواء كنت تريد JSON لطالب، مستخدم، طلب شراء، أو أي سيناريو آخر، سيوفر عليك وقتًا كبيرًا.
خلاصة المقال
أنواع البيانات داخل n8n هي الأساس لأي Workflow ناجح.
فهمك للـ String و Number و Boolean و Array و Object يجعلك قادرًا على بناء أتمتة قوية واحترافية بدون تعقيد.
كلما أتقنت هذه الأساسيات، أصبحت جاهزًا للانتقال لمرحلة أكثر تقدمًا مثل التعامل مع APIs وربط n8n مع أي منصة خارجية.
في الشرح القادم سننتقل لشرح مفهوم الـ API داخل n8n، ولماذا هو مهم، وكيف نستخدمه عمليًا خطوة بخطوة.