عارض CSV
اعرض صفوف وأعمدة CSV في جدول واضح مع فحص الفواصل والاقتباسات والعناوين والقيم الفارغة والحقول متعددة الأسطر.
افحص CSV مع الحفاظ على سياق الجدول
تبادل CSV بسيط، لكن الفواصل والاقتباسات والقيم الفارغة والأسطر الجديدة قد يصعب فحصها كنص عادي. يعرض هذا العارض الصفوف والأعمدة لتراجع تفسير البيانات المدخلة.
عرض الجدول هو تفسير لنص مفصول. لا يثبت أن الملف يحمل المعنى التجاري أو أنواع الأعمدة أو الترميز الصحيح. احتفظ بـ CSV الأصلي وتأكد من الفاصل وقواعد الاقتباس التي استخدمها المصدر.
استخدم عينة تشمل العناوين وقيمة فارغة وفاصلة داخل اقتباس وحقل متعدد الأسطر عندما توجد هذه الحالات. قارن الجدول بالنص الخام قبل استيراده في مكان آخر.
ماذا يعرض عارض CSV
يخزن CSV السجلات عادة في أسطر والحقول بفاصل، غالباً فاصلة. تحمي الاقتباسات فاصلة أو سطراً جديداً داخل الحقل، وتمثل الاقتباسات المضاعفة حرف اقتباس.
يحلل العارض النص وفق افتراضات الإدخال الموثقة ويعرض الصفوف والأعمدة الناتجة. الجدول المرتب لا يتحقق من schema خارجي ولا يضمن أن كل منتج يستخدم dialect واحداً.
العناوين بيانات ما لم يتعامل معها العارض أو مسار الاستيراد كعنوان للصف الأول. القيم الفارغة وBOM والترميز ونمط نهاية السطر قد تؤثر في التفسير.
كيفية فحص CSV
- ألصق عينة CSV كاملة أو افتح النص المسموح بفحصه، وحافظ على الفاصل ونمط الاقتباس اللذين استخدمهما المصدر.
- راجع عدد الأعمدة في الصفوف وابحث عن قيم انزاحت بسبب فاصل غير مقتبس أو اقتباس غير مغلق أو سطر غير متوقع.
- افحص العناوين والخلايا الفارغة والأسماء المكررة والأصفار البادئة والقيم الشبيهة بالتواريخ والحقول التي تحتوي فواصل أو أسطر.
- قارن الخلايا المهمة بالنص الخام ثم استخدم importer أو schema validator المطلوب في المشروع.
- أزل الأسرار والمعلومات الشخصية من العينات ما لم تسمح سياسة التعامل بعرضها.
طريقة العرض
- قراءة الفواصل
يحدد العارض حدود الحقول وفق نص CSV وقواعد الفاصل والاقتباس المعتمدة في الإدخال.
- بناء الصفوف والأعمدة
توضع الحقول في صفوف وأعمدة حتى تظهر الأطوال غير المتساوية والقيم الفارغة والخلايا المنزاحة.
- عرض القيم
يعرض العارض نص الخلية للفحص. ولا يحول السلاسل تلقائياً إلى أرقام أو تواريخ أو قيم منطقية أو أنواع قاعدة بيانات.
يجب تأكيد كشف الفاصل ومعالجة الترميز وافتراض العناوين والتعامل مع الصفوف التالفة بمحرك حي قبل وصفها كسلوك ثابت.
قراءة نتيجة الجدول
النتيجة الناجحة هي تفسير جدولي للنص المدخل. تأكد من حدود الصفوف ومواقع الحقول والاقتباسات والقيم الفارغة والعناوين بمقارنة CSV الخام.
فشل التحليل أو اختلاف طول الصف إشارة لفحص الفواصل والاقتباسات والترميز والسجلات. لا تستنتج قاعدة recovery دقيقة بلا دليل runtime.
إذا غيّر الاستيراد الأنواع أو رفض صفوفاً، فافحص importer وschema بشكل منفصل. عرض البيانات لا ينظفها ولا يطبعها.
أخطاء شائعة
اعتبار الصف الأول عنواناً دون فحص مسار العمل قد يغير معنى كل سجل.
تجاهل الاقتباسات حول الفواصل أو الأسطر قد ينشئ أعمدة وصفوفاً وهمية.
افتراض بقاء الأصفار البادئة أو التواريخ أو السلاسل الفارغة بعد استيراد spreadsheet قد يفسد المعرّفات.
مقارنة الجدول وحده دون النص الخام قد تخفي BOM أو فاصلاً نهائياً أو اقتباساً غير مغلق.
القيود
القدرة الموثقة هي عرض نص مفصول في جدول. لا تضمن صحة schema أو جودة البيانات أو إصلاح الترميز أو استقرار الأنواع أو توافق الاستيراد.
يجب اختبار كشف الفاصل وCSV dialect والحقول متعددة الأسطر والصفوف التالفة والملفات الكبيرة وحدود المتصفح في مسار العمل الحقيقي.
لا تعرض بيانات إنتاج سرية إن لم تسمح السياسة؛ فالجدول يكشف القيم الأصلية نفسها.
Examples
عرض صف العناوين
هل يمكن جعل CSV صغير في جدول مقروء؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
يعرض الصف الأول حقلين ويضع الصف الثاني تحتهما.
الحفاظ على قيمة فارغة
كيف أفحص قيمة فارغة في الوسط؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
تبقى الخانة الوسطى فارغة مع بقاء موضعي الخانتين الأخريين.
حماية الفاصلة بالاقتباس
هل تبقى الفاصلة داخل الاسم حقلاً واحداً؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
تبقى الفاصلة المقتبسة داخل حقل الاسم ولا تنشئ عموداً إضافياً.
عرض سطر جديد مقتبس
كيف أراجع حقلاً متعدد الأسطر؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
يبقى السطر الجديد داخل حقل الملاحظات المقتبس.
الحفاظ على الأصفار البادئة
هل يمكن عرض المعرّف 0012 دون تحويله؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
تبقى الأحرف 0012 ظاهرة في الخلية.
مقارنة صفوف غير متساوية
ماذا يكشف الصف الذي يحتوي حقولاً زائدة؟
أرسل عينة CSV ثم افحص الصفوف والأعمدة وقارنها بالنص الخام.
يظهر اختلاف طول الصف عن العنوان ويحتاج قراراً بشأن المصدر أو dialect.
Frequently asked questions
هل يتحقق عارض CSV من صحة البيانات؟
لا. يعرض تفسيراً للنص المفصول. استخدم schema أو importer أو فحوص جودة البيانات المطلوبة.
هل الصف الأول عنوان دائماً؟
ليس بالضرورة. يعتمد ذلك على العارض أو إعداد الاستيراد؛ قارنه بعقد المصدر.
لماذا أنشأت الفاصلة عموداً جديداً؟
الفاصلة فاصل عادة ما لم تكن داخل حقل مقتبس صحيحاً. افحص زوج الاقتباس وdialect المنتج.
هل يمكن أن يحتوي CSV على أسطر داخل حقل؟
نعم، عندما يكون الحقل مقتبساً وفق dialect. تحقق من دعم العارض والمستورد.
هل تبقى الأصفار البادئة؟
يمكن للعارض عرض الأحرف المدخلة، لكن spreadsheet أو importer قد يحولها؛ احفظ المعرّفات كنص عند الحاجة.
ماذا تعني الخلية الفارغة؟
قد تعني سلسلة فارغة أو قيمة مفقودة أو null وفق convention. أكد معناها مع المصدر والوجهة.
هل أصلح CSV التالف هنا؟
استخدم الجدول لتحديد موضع الخلل، ثم أصلح المصدر وأعد فحصه بالـ parser أو importer الفعلي.
ماذا أفعل بعد العرض؟
قارن الخلايا المهمة بالنص الخام وأزل البيانات الحساسة من النسخ المشتركة وشغّل اختبار الاستيراد والتحقق.