استيراد CSV: المعاينة ومطابقة الأعمدة وتقارير الأخطاء
· PoolByte Technology
يسمح لك استيراد ملف CSV بنقل آلاف المنتجات أو سجلات العمليات غير الخاصة بالعميل إلى النظام بسرعة. وعلى العكس من ذلك، يمكن لمطابقة عمود واحدة غير صحيحة أن تؤدي إلى إتلاف العديد من السجلات في وقت واحد. توضح لك أداة الاستيراد الجيدة كيفية تفسير البيانات قبل قراءة الملف، مما يؤدي إلى إنشاء عملية يمكن تتبعها.
اجعل الفاصل وترميز الأحرف مرئيًا
لا تفترض أن ملفات CSV مفصولة دائمًا بفواصل. قد تنتج الأدوات الإقليمية فواصل مختلفة. لا يمكن أيضًا التعامل مع الفواصل أو فواصل الأسطر داخل علامات الاقتباس بشكل آمن بمجرد تقسيم النص. RFC 4180 يحدد القواعد الأساسية لتنسيق CSV الشائع؛ لا تزال أنواع الملفات الفعلية تتطلب المعاينة.
أظهر في السجلات القليلة الأولى ما إذا كانت الأحرف التركية تالفة أم لا. يجب الاحتفاظ برموز المنتجات ذات الأصفار البادئة والقيم الشبيهة بالهاتف والمعرفات الطويلة كنص. بدلاً من إعلام المستخدم لاحقًا بأن "00124" سيتغير إلى "124"، اجعل هذا الاختلاف مرئيًا قبل الاستيراد. قم أيضًا بتحديد تنسيق التاريخ والرقم العشري بشكل صريح.
مطابقة الأعمدة هي خطوة تأكيد
يجب أن نفهم ما إذا كان عمود "السعر" في الملف يتوافق مع سعر البيع أو التكلفة في النظام. يجب ألا تبدأ العملية في حالة عدم وجود الأعمدة المطلوبة. إذا كان سيتم إجراء تحديث، فحدد مفتاح مطابقة السجل: يمكن أن يكون رمز المنتج أو معرف النظام الخارجي أو حقل ثابت آخر. لا يمكن الاعتماد على التحديث بناءً على تشابه الاسم وحده.
اعرض بشكل منفصل عدد السجلات المطلوب إضافتها وتغييرها ورفضها على شاشة المعاينة. يمكن أن يؤدي التشغيل التجريبي إلى هذه النتيجة دون الكتابة إلى بيانات حقيقية. إذا تغير الملف النهائي، فلا تعتبر الموافقة على المعاينة السابقة صالحة. يساعد معرف الاستيراد وبصمة الملف في تتبع البيانات التي تمت الموافقة عليها.
تقييم الخلايا الشبيهة بالصيغة
إذا تم فتح ملف CSV لاحقًا في برنامج جداول البيانات، فقد يتم تفسير بعض الخلايا على أنها صيغ. ويجب معالجة هذا الخطر ليس فقط في مجال الاستيراد، بل في التصدير أيضًا. وصف حقن OWASP CSV يشرح سياق هذا الخطر. وضع قيمة الخلية بين علامتي اقتباس لا يضمن التعامل معها كنص آمن في كل برنامج يقرأها.
قم بتطبيق قواعد مختلفة على النص الحر، مثل وصف المنتج وحقل الرقم الذي سيدخل الحساب. لا تقم بتحويل البيانات الخاطئة بصمت إلى صفر أو تاريخ اليوم. يجب أن يمكّن التقرير المستخدم من تصحيح الملف، مع رقم السطر ومعلومات السبب؛ ليس من الضروري تفريغ محتويات الملف بأكمله في سجل الأخطاء.
كيف تستأنف عملية استيراد غير مكتملة؟
إذا كنت تقوم بتشغيل العملية على دفعات صغيرة، فتجنب تكرار نفس الدفعة وإنشاء منتج مزدوج. تتبع الصفوف الناجحة وغير الناجحة بشكل منفصل. لا تفترض أن كل عملية استيراد يمكن التراجع عنها تمامًا؛ حدد مسبقًا القيم السابقة للحقول التي سيتم الاحتفاظ بها. لا ينبغي الكتابة فوق تعديلات المستخدم الفعلية التي تم إجراؤها لاحقًا أثناء التراجع.
جربه أولاً باستخدام ملف صغير وممثل ويحتوي على أخطاء مقصودة. يجب أن تكون تنسيقات العملات المختلفة والحقول الفارغة المطلوبة والمعرفات المكررة موجودة في هذا الملف. عند تسليم مشروع التجارة الإلكترونية ، لا ينبغي إكمال أداة CSV لمجرد أنها "تقبل الملفات"؛ يجب أن يكون مفهوما ما هي السجلات التي تم تغييرها ولماذا.