ملف csv هو اختصار لمصطلح Comma Separated Values أو القيم المفصولة بفواصل . يتم استخدام تنسيق ملف csv كجزء أساسى فى عملية نقل البيانات فى نظام ماجنتو 2 . يدعم ملف CSV جميع تطبيقات جداول و قواعد البيانات . تدعم عملية استيراد و تصدير البيانات فى ماجنتو أنواع الملفات التالية :
- عملية الاستيراد : تدعم ملفات CSV و ZIP (ملف csv مضغوط)
- عملية التصدير : تدعم ملف csv .
تحتوى ملفات csv على بنية محددة من البيانات و التى يجب أن تتطابق مع قاعدة البيانات . يتوافق كل عنوان عمود فى جدول البيانات مع رمز السمة الخاص بالحقل الذى يمثله العمود . لتضمن قراءة نظام ماجنتو لعناوين هذه الأعمدة ، أولاً قم بتصدير البيانات من متجرك على ماجنتو 2 كملف csv . ثم يمكنك بعد ذلك تحرير و تعديل البيانات و استيرادها مرة أخرى إلى نظام ماجنتو 2 .
إذا قمت بفتح ملف csv تم تصديره فى محرر النصوص Text Editor ، فسترى أن القيم تم فصلها بفواصل (,) و أن القيم المتعددة محاطة بعلامات اقتباس مزدوجة (“) . رغم ان علانة الفاصلة هى العلامة الافتراضية للفصل بين البيانات ، الا انه يمكنك استخدام علامة أو حرف مخصص اخر كفاصل .
هيكلية ملف csv لبيانات المنتجات
يحتوى التصدير الكامل لقاعدة بيانات المنتج على معلومات حول كل منتج فى كتالوج متجرك داخل نظام ماجنتو 2 ، و العلاقة بينهما . يحتوى كل سجل فى جدول البيانات على مجموعة ثابتة من الأعمدة التى تتوافق مع السمات الموجودة فى كتالوج المتجر ، على الرغم من تجاهل ترتيب السمات أثناء عملية الاستيراد .

ملف Csv لبيانات منتج تم تصديرها
يحتوى الصف الأول من الجدول على أسم كل سمة ، و التى يتم استخدامها كعناوين للأعمدة . تصف الصفوف المتبقية سجلات المنتج الفردية . أى صف يبدأ بقيمة فى عمود sku ، هو بداية لسجل منتج جديد . يمكن أن يتضمن المنتج الواحد العديد من الصفوف التى تحتوى على معلومات عن الصور و الخيارات المتعددة للمنتج . يبدأ الصف التالى الذى يحتوى على قيمة فى عمود sku منتج جديد .
يحتوى عمود الفئة (Category) على مسار كل فئة التى يتم تعيين المنتج لها . يتضمن هذا المسار اسم الفئة الرئيسية يتبعها شرطة مائلة (\) بين كل مستوى . تُستخدم علامة الشرطة العمودية (|) للفصل بين مسارات الفئات المختلفة فى جدول البيانات . على سبيل المثال
Default Category/Gear|Default Category/Gear/Bags
لاستيراد البيانات ، تحتاج لتضمين فقط رمز sku و أى أعمدة اخرى ذات تغييرات . يتم تجاهل أى أعمدة فارغة أثناء عملية الاستيراد . لا يمكنك إضافة أى سمات تريدها أثناء عملية الاستيراد . يمكنك تضمين السمات الموجودة فقط فى جدول البيانات .

ملف csv لبيانات المنتجات فى Notepad++
هيكل بيانات المنتج فى ملف CSV
اسم العمود | الوصف |
name | رؤوس الأعمدة التى تبدأ بعلامة الشرطة السفلية ، تحتوى على خصائص كيان الخدمة أو البيانات المعقدة . أعمدة الخدمة ليست سمات المنتج . |
attribute _ name | رؤوس الأعمدة التى تحتوى على رمز السمة أو اسماء الحقول تقوم بتعريف البيانات الموجودة فى كل عمود من أعمدة جدول البيانات . قد يمثل العمود سمة موجودة فى نظام ماجنتو 2 ، أو سمة تم إنشاءها بواسطة مدير متجر ماجنتو . |
هيكل ملف CSV لبيانات العميل
تحتوى ملفات csv الخاصة بالعملاء على معلومات العملاء من قاعدة البيانات فى ماجنتو 2 . لديها البنية أو الشكل التالى :

البيانات المُصدرة فى برنامج Open Office Clac
يحتوى الصف الأول من جدول البيانات على أسماء أعمدة السمات (و التى هى نفس رموز السمات) . هناك نوعان من أسماء الاعمدة ، كما نرى فى الجدول التالى . تحتوى الصفوف الاخرى على قيم السمات ، بيانات الخدمة و البيانات المعقدة . يحتوى كل صف على قيم ممتلئة و غير فارغة فى أعمدة Email و Website يبدأ بوصف العميل التالى . كل صف يمكن أن يمثل بيانات العميل مع أو بدون بيانات العنوان أو ببيانات العنوان فقط . إذا كان الصف يحتوى على بيانات العنوان فقط ، فإن القيم فى الأعمدة المرتبطة بملف تعريف العميل ، سيتم تجاهلها و قد تكون فارغة .
لإضافة أو استبدال أكثر من عنوان واحد للعميل ، فقم فى ملف استيراد البيانات ، بإضافة صف لكل عنوان جديد مع بيانات العميل الفارغة . بالإضافة إلى بيانات العنوان الجديدة أو التى تم تحديثها أسفل صف بيانات العميل .

البيانات المُصدرة فى برنامج Notepad++
هيكل بيانات العملاء فى ملف CSV
اسم العمود | الوصف |
name | رؤوس الأعمدة التى تبدأ بعلامة الشرطة السفلية (_) تحتوى على بيانات الخدمة أو البيانات المعقدة فى نظام ماجنتو 2 . |
attribute_name | هذا العمود يحتوى على قيم السمات الى أنشأها نظام ماجنتو ، و قيم السمات التى أنشأها مدير متجر ماجنتو . |