تسطيح مسبق لنصوص JSON المتداخلة ليعمل Set بتعيينات بسيطة بلا JSON.parse

كيف يعمل

1. 1.شغّل Manual Trigger لتوليد سجلات تجريبية من عقدة Sample Records
2. 2.عقدة Parse And Flatten تحلل كل حقل نصي يبدأ بـ { أو [ وتسطحه لمسارات نقاطية بأنواع صريحة
3. 3.الحقول المعطوبة تُوسم فشل بسبب invalid_json_text ويُحفظ النص في حقل field__unresolved
4. 4.عقدة Map Flat Fields تعيّن record_id والحالة والعدادات بتعيينات بسيطة فقط مع includeOtherFields
5. 5.عقدة If تقارن unresolved_json_marker بالفراغ وتوجّه السجلات ذات النص الباقي إلى Review Queue
6. 6.NoOp للمراجعة وNoOp للنظيف يدخلان Merge في مدخلين مستقلين بوضع append
7. 7.عقدة Build Report بوضع runOnceForAllItems تُخرج تقريراً واحداً مرتباً بحسب record_id

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

• تجنّب فشل تعبيرات JSON.parse داخل عقدة Set على n8n Cloud
• تسطيح حمولات Webhook التي تصل كنص JSON داخل حقل واحد
• كشف الحقول التي بقيت نص JSON غير محلول قبل مراحل لاحقة
• توليد تقرير جودة تحليل لدفعة سجلات

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

• n8n 2.46.4 أو أحدث
• لا توجد بيانات اعتماد مطلوبة للعرض اليدوي
• لربط مصدر حقيقي: استبدل Sample Records بـ Webhook أو HTTP Request أو عقدة قاعدة بيانات بنفس المخطط
• الحقول النصية المتوقع تحليلها يجب أن تبدأ بـ { أو [

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

1. استورد JSON في n8n واضغط Execute Workflow
2. تحقّق أن REC-1001 و REC-1003 بحالة resolved ومسارات نقاطية مسطحة
3. تحقّق أن REC-1002 بحالة failed وسبب invalid_json_text ومسار review
4. أضف سجلاً بلا record_id وتأكد من توليد معرّف NO_ID-n
5. أفرغ مصفوفة records في Sample Records وتأكد من تقرير بأصفار ومصفوفة فارغة

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

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