مُوحّد المفرد/المصفوفة بأسماء دلالية مشتقة من الحقل الأب

كيف يعمل

1. 1.شغّل المشغل اليدوي فتصدر عقدة Code خمس حمولات اختبارية
2. 2.تفحص عقدة If كون invoice.lines مصفوفة: true يمرر عبر noOp كما هو، وfalse يلف الكائنات المفردة في مصفوفات ويسجل الشكل الأصلي _originalShape (single/missing/invalid)
3. 3.تجمع عقدة Merge بوضع append ومدخلين (index 0 و1) عناصر الفرعين
4. 4.يبني محرك التسمية أسماء دلالية ديناميكياً من مفتاح الحقل الأب، ويحفظ الحقول العددية في scalars، ويتعامل مع missing/invalid بأمان (normalized وscalars كائنان فارغان {})
5. 5.تفرز عقدة المحرك الناتج حسب payloadId وتسلّم noOp ناتجاً موحد البنية مرتباً PL-001 إلى PL-005

حالات الاستخدام

• توحيد حمولات Webhook المتذبذبة بين كائن مفرد ومصفوفة لنفس الكيان
• تسمية دلالية ديناميكية للمصفوفات المتوازية من مفتاح الحقل الأب قبل التفكيك
• فحص صريح للأنواع مع حفظ الحقول العددية ومسار آمن للحمولات الناقصة أو غير الصالحة وناتج مرتب حتمياً

المتطلبات قبل التشغيل

• لا يتطلب بيانات اعتماد؛ المعالجة محلية بالكامل
• للاستبدال بمدخل حقيقي: احذف عقدة Emit Sample ووصّل Webhook بنفس بنية invoice مباشرة بعقدة If
• بوابة If مثبتة على مسار invoice.lines فقط؛ عدّل التعبير إذا اختلف مسار المصفوفة المستهدفة، ومحرك التسمية يعمل على أي حقول داخل invoice تلقائياً. جمع الفرعين بعقدة Merge بوضع append بمدخلين صحيحين 0 و1

الإعداد والاختبار في n8n

1. استورد JSON في n8n مع active = false
2. شغّل Manual Trigger وتفحص مخرجات Unified Output Handoff: خمسة عناصر مرتبة PL-001 حتى PL-005
3. تحقق أن PL-001 ملفوف في مصفوفات من عنصر واحد مع scalars يحوي id، وPL-002 بعدده الأصلي 2 عبر فرع التمرير، وPL-003 بnormalized = {} وscalars = {} وmissing، وPL-004 بnormalized = {} وinvalid مع بقاء id في scalars، وPL-005 تمرر customer كمصفوفة من عنصرين وتلف lines المفرد
4. أضف حقلاً جديداً داخل invoice في العينة لتتأكد أن التسمية الدلالية تُشتق تلقائياً دون تعديل الكود

ماذا يقدّم كخدمة؟

مناسب كخدمة أتمتة تشغيلية لربط الأنظمة، تقليل المهام اليدوية، وتسريع تسليم النتائج للعملاء أو الفرق الداخلية.