برمجة

استيراد أوامر ERP من JSON باستخدام jsonb_to_recordset

فريق فايندو جروب3 دقائق قراءة0 مشاهدة0 تعليقات
مشاركة:
شاشة استعلام PostgreSQL تعرض مصفوفة أوامر وجدولًا فيه رقم الطلب والكمية وحقل مفقود.

يرسل تكامل المخزون مجموعة أوامر في مصفوفة JSON، بينما تحتاج قاعدة ERP إلى صفوف ذات أعمدة واضحة. قد ينجح فك الملف ثم يتوقف الاستيراد بسبب كلمة داخل حقل الكمية. وقد تمر كمية فارغة دون ظهور خطأ تحويل أصلًا. لذلك يحتاج فريق التنفيذ إلى عينة قبول تفصل قراءة البيانات عن اعتمادها في سجلات التشغيل.

جهّز عقدًا صغيرًا للدفعة

في مثال تعليمي، لكل أمر order_ref نصي وqty صحيحة. نستخدم سجلين؛ الأول يحتوي الكمية 3، والثاني يفتقدها. المتفق عليه في هذا المثال أن غياب الكمية خطأ في المدخلات، وأن رقم الطلب مطلوب وفريد داخل الدفعة. هذه قرارات لعقد الاستيراد الذي تراجعه مع فريق المشروع.

دالة jsonb_to_recordset تحوّل مصفوفة كائنات إلى صفوف وفق الأعمدة المعلنة بعد AS. أسماء المفاتيح هي التي تربط القيم بالأعمدة؛ ترتيب المفاتيح داخل الكائن لا يحدد ترتيب الأعمدة. القيمة المفقودة تنتج NULL، ولذلك لا تكفي نتيجة الاستعلام وحدها لإعلان صحة الطلب.

SELECT order_ref, qty
FROM jsonb_to_recordset(
'[{"order_ref":"A-21","qty":3},{"order_ref":"A-22"}]'::jsonb
) AS input(order_ref text, qty integer);

اقرأ النتيجة قبل إدراجها

تُظهر العينة صف A-21 بكمية 3 وصف A-22 بكمية NULL. أضف تحققًا صريحًا يرفض الكمية الغائبة أو غير المسموح بها، وسجل سبب الرفض بجانب رقم الطلب. اختبر كذلك []، والتي تنتج صفر صفوف. نجاح استعلام لا يعيد سجلات لا يساوي استيراد طلبات فعلية.

غيّر الكمية في سجل مستقل إلى "three" مع بقاء تعريف qty integer. تتوقف العبارة بخطأ تحويل بدل إرجاع رقم صالح. لو أردت تقرير أخطاء يجمع كل الصفوف، احتفظ بالمدخل الخام، وفك الحقول النصية إلى مساحة مرحلية، ثم تحقق من قيمها قبل التحويل والاعتماد. لا تفترض أن الدالة تمنحك قائمة أخطاء كاملة لكل عناصر المصفوفة.

صمم مرحلة اعتماد واضحة

عند استيراد كبير، سجل معرف دفعة، والعدد المستلم، وعدد المقبول والمرفوض، ومصدر الملف. اعرض للمستخدم أسباب الرفض قبل النقل إلى جداول الأوامر. احتفظ بالمرجع الأصلي لربط رسالة الخطأ بسجل يمكنه إصلاحه. البيانات التي تنجح في التحويل ما زالت تحتاج قواعد الصنف والصلاحيات والتكرار في نظامك.

جرّب بنية غير متوقعة مثل كائن منفرد بدل المصفوفة. واختبر مفتاحًا إضافيًا غير مستخدم لتعرف هل عقد التطبيق يسمح به أم يرفضه. عرّف أيضًا سياسة إعادة إرسال نفس الدفعة قبل بدء الربط الفعلي؛ وجود رقم الطلب في JSON لا ينشئ وحده حماية من التكرار.

اختبار القبول مع فريق ERP

  • دفعة صحيحة تعيد العدد والقيم المتوقعين.
  • دفعة فارغة تظهر رسالة مناسبة.
  • كمية مفقودة تبقى مميزة عن الصفر.
  • قيمة غير رقمية تُرفض مع مرجع مفهوم.
  • فشل الاعتماد لا يترك أوامر جزئية خارج السياسة المتفق عليها.

يمكن استخدام هذه العينة ضمن مراجعة تكاملات ERP، وربط تقرير الاستيراد بمواصفات التطوير البرمجي قبل تشغيل ملفات حقيقية.

مراجع التنفيذ

التصنيفات:برمجة
شارك:

التعليقات

لا توجد تعليقات بعد

أضف تعليقك

كن أول من يعلق على هذا المقال

02 · تابع القراءة

مقالات ذات صلة