استيراد بيانات أولياء الأمور جماعياً عبر Excel

الهدف

رفع واستيراد حسابات وبيانات أولياء الأمور دفعة واحدة باستخدام ملف Excel لتوفير الوقت وتجنب الإدخال اليدوي الفردي.

---

متى تحتاج هذه الخاصية؟

عند بداية العام الدراسي أو تهيئة فرع جديد للمدرسة، حيث تتوفر قائمة ببيانات التواصل لأولياء الأمور الجدد وترغب الإدارة في تسجيلهم في النظام دفعة واحدة.

---

قبل أن تبدأ

• الصلاحية المطلوبة للرفع: صلاحية استيراد أولياء الأمور.
• الحد الأقصى لحجم الملف: 10 ميجابايت (10MB).
• عدد الأسطر الأقصى: 1000 سطر للملف الواحد.
• تنسيق الملف: يجب أن يكون امتداد الملف .xlsx حصرياً.

---

المسار في النظام

القائمة الجانبية > [Users & Imports] > استيراد أولياء الأمور [Import Parents].

---

الخطوات التشغيلية

1. تحميل النموذج القياسي (Template)

لتفادي أخطاء الرفع وتطابق الأعمدة، يجب دائماً استخدام النموذج الخاص بالنظام:

1. في شاشة الاستيراد، اضغط على زر تحميل النموذج [Download Template].
2. سيقوم النظام بتحميل ملف Excel فارغ مهيأ بالأعمدة المطلوبة باسم ImportParentsTemplate.xlsx.

2. تعبئة البيانات في الملف

افتح الملف وقم بتعبئة السطور بالبيانات المطلوبة بدءاً من السطر الثاني، مع الالتزام التام بترتيب الأعمدة الفني:

العمود	اسم العمود في الملف (A1)	الحالة	الوصف والقواعد
A	PhoneNumber	إجباري	رقم جوال ولي الأمر (يجب أن يكون فريداً وغير مكرر في النظام أو الملف).
B	FirstName	إجباري	الاسم الأول لولي الأمر.
C	CityId	إجباري	كود المدينة في النظام (يجب أن يكون رقماً صحيحاً مطابقاً لمدينة مسجلة).
D	Email	إجباري	البريد الإلكتروني لولي الأمر (يجب أن يكون فريداً وغير مكرر).

3. رفع الملف ومتابعة المعالجة

1. اضغط على منطقة اختيار الملف [Select File] وحدد الملف الذي قمت بتعبئته.
2. اضغط على زر الحفظ والرفع [Save].
3. سيظهر لك شريط تقدم حي (ProgressOverlay) يوضح نسبة تقدم الرفع ومعالجة الأسطر لحظياً عبر قناة SignalR.
4. في حال نجاح الرفع الكامل: ستظهر رسالة تأكيد خضراء: Import successful! All parents have been imported.

---

معالجة وتحميل ملف الأخطاء (Error File)

في حال وجود أخطاء في تعبئة البيانات (مثل بريد إلكتروني مكرر أو رقم هاتف مستخدم سابقاً):

1. سيقوم النظام بإيقاف عملية الحفظ بالكامل (تراجع كامل للعملية لضمان سلامة قاعدة البيانات - Transaction Rollback).
2. ستظهر رسالة خطأ باللون الأحمر أسفل الملف تفيد بفشل الاستيراد ووجود أخطاء.
3. يقوم النظام تلقائياً بتوليد زر تحميل تقرير الأخطاء [Download Error File].
4. اضغط عليه لتحميل نسخة من ملفك المرفوع مضافاً إليها عمود خامس جديد باسم Errors يوضح لك بالتفصيل سبب المشكلة بجانب كل سطر خاطئ (مثال: PhoneNumber already exists.).
5. قم بتعديل السطور الخاطئة في نفس الملف، واحذف العمود الخامس، ثم أعد رفع الملف مجدداً.