إنتقل إلى المحتوى الرئيسي

مرجع مواصفات وأعمدة ملفات استيراد Excel (Excel Import Schema)

يوفر هذا المرجع الفني القيود الهيكلية والتحققات الدقيقة لملفات استيراد أولياء الأمور والطلاب المعتمدة في منصة Skool.Cool لضمان خلو الملفات من الأخطاء قبل الرفع.

1. مواصفات الملف العامة (File Constraints)​

  • الامتداد المدعوم: .xlsx حصرياً (ملفات جداول إكسل الحديثة).
  • الحد الأقصى لحجم الملف: 10 ميجابايت (10MB).
  • الحد الأقصى للأسطر: 1000 سطر (عدا سطر الترويسة الأول).
  • منع التكرار (Transaction Rollback): أي خطأ في أي سطر يؤدي إلى إلغاء رفع الملف بالكامل، ولا يتم حفظ أي جزء من البيانات لحين تصحيح كافة الأخطاء.

2. هيكل أعمدة استيراد أولياء الأمور (Parents Schema)​

اسم العمود (Row 1)نوع البياناتهل مطلوب؟القيود الفنية وقواعد التحقق
PhoneNumberنصنعمرقم الجوال الفريد. شروطه:
1. يجب ألا يتكرر في الملف.
2. يجب ألا يكون مسجلاً لمستخدم آخر في قاعدة البيانات.
3. يجب أن يطابق الجوال السعودي (أرقام فقط تبدأ بـ 5).
FirstNameنصنعمالاسم الأول لولي الأمر (مثل: محمد، أحمد).
CityIdرقمنعمالكود التعريفي الرقمي للمدينة في قاعدة البيانات (مثل: 1 للرياض، 2 لجدة). يجب أن يطابق كود مدينة حقيقية.
Emailبريد إلكترونينعمالبريد الإلكتروني الفريد لولي الأمر للتواصل وإرسال الإيصالات. يجب ألا يتكرر بالملف أو قاعدة البيانات.

3. هيكل أعمدة استيراد الطلاب (Children Schema)​

اسم العمود (Row 1)نوع البياناتهل مطلوب؟القيود الفنية وقواعد التحقق
PhoneNumberنصنعمرقم جوال ولي الأمر المسجل مسبقاً في النظام. يُستخدم لربط الطفل بولي أمره تلقائياً. إذا كان الرقم غير موجود بالخادم، يفشل السطر.
FirstNameنصنعمالاسم الأول للطفل (مثل: سلطان، سارة).
FatherNameنصاختيارياسم الأب للطفل. (يصبح إجبارياً في حال إدراج العمود بالملف).
FamilyNameنصاختيارياسم العائلة للطفل. (يصبح إجبارياً في حال إدراج العمود بالملف).
Genderرقمنعمجنس الطفل. أدخل الكود الرقمي المقابل:
1 لتمثيل الذكور (Boy).
2 لتمثيل الإناث (Girl).
BirthDateتاريخنعمتاريخ ميلاد الطفل بالتنسيق القياسي المقبول (مثال: 15/08/2016 أو YYYY-MM-DD).

4. رموز وأكواد الأخطاء الشائعة في ملف الأخطاء (Errors Column)​

عند تحميل ملف الأخطاء ImportErrors.xlsx بعد فشل الرفع، ستجد الأخطاء مدونة في العمود الأخير تحت مسمى Errors بالشكل التالي:

  • PhoneNumber already exists. -> رقم الجوال هذا مسجل بالفعل لولي أمر آخر في المدرسة.
  • Email already exists. -> البريد الإلكتروني مستخدم مسبقاً لحساب آخر.
  • PhoneNumber not exists. -> (في ملف الطلاب) رقم جوال ولي الأمر المكتوب غير مسجل في قاعدة البيانات، يجب تسجيل الأب أولاً.
  • Duplicate PhoneNumber in file. -> قمت بكتابة نفس رقم الهاتف في سطرين مختلفين داخل الملف المرفوع.
  • CityId not found. -> كود المدينة الذي كتبته غير معرّف في لوحة تحكم المنصة.
  • BirthDate is required. -> حقل تاريخ الميلاد فارغ أو مكتوب بتنسيق لا يفهمه النظام.