# استيراد الطلاب من ملف CSV أو Excel
HTML: https://manhali.com/help/import-students
Markdown: https://manhali.com/help/import-students.md
Published: 2026-11-02T09:00:00.000Z
Updated: 2026-11-02T09:00:00.000Z
Type: doc
Category: الطلاب
Series: الاستيراد والتصدير
أدخل طلابك دفعة واحدة من ملف CSV أو Excel أو JSON، مع فحص الملف قبل أن يتغيّر أي شيء وخيار دعوتهم بالبريد.
إن كان عندك طلاب في جدول أو في منصة سابقة فلا داعي لإضافتهم واحدًا واحدًا. بالاستيراد (نقل الطلاب من ملف إلى أكاديميتك) ترفع ملفًا واحدًا، فنفحصه ونعرض لك ما وجدناه، ثم تؤكد. لا يتغيّر شيء في أكاديميتك قبل تأكيدك.
## قبل أن تبدأ
- الاستيراد للمالك والمدير فقط.
- الملف بصيغة CSV (ملف جدول نصي يُفتح في إكسل) أو Excel بامتداد **.xlsx** أو JSON. أقصى حجم 5 ميجابايت، وأقصى عدد 500 صف و32 عمودًا. إن كان ملفك أكبر فقسّمه. ملف **.xls** القديم لا يُقبل، فاحفظه بصيغة xlsx أو CSV.
- نزّل القالب (ملف جاهز بالأعمدة الصحيحة) لتبدأ منه. تجد زر **تنزيل القالب** في الخطوة الأولى.
- كل طالب جديد يُحتسب من حد الطلاب في باقتك.
## الأعمدة
عنوان العمود هو الكلمة في السطر الأول من ملفك. يمكن أن يكون بالإنجليزية كما في القالب، أو بالعربية كما في الجدول أدناه.
| العنوان | ملاحظات |
|---|---|
| **name** أو «الاسم» أو «الاسم الكامل» | اسم الطالب. مطلوب، حتى 120 حرفًا |
| **email** أو «البريد» أو «البريد الإلكتروني» | بريد الطالب. يجب أن يكون صالحًا |
| **phone** أو «الهاتف» أو «الجوال» أو «رقم الهاتف» | هاتف الطالب، من 6 إلى 15 رقمًا. نزيل المسافات والشرطات والأقواس، ونحوّل 00 في أوله إلى + |
| **acceptsMarketing** | هل وافق على النشرة. اكتب نعم أو لا (أو yes وno أو true وfalse أو 1 و0) |
لا بد من **بريد أو هاتف** في كل صف. الأعمدة الأخرى في ملفك لا تُستخدم، ونذكرها لك في الفحص تحت «أعمدة لم تُستخدم».
## الخطوات
1. افتح [**الإعدادات › استيراد وتصدير البيانات**](https://dash.manhali.com/data) ثم تبويب **الاستيراد**.
2. تحت «ماذا تستورد؟» اختر **الطلاب**.
3. اسحب الملف إلى المربع أو اضغط **اختيار ملف**.
4. انتظر الفحص، فتصل إلى الخطوة **راجع**.
5. اختر ما تفعله بمن هو موجود عندك مسبقًا.
6. فعّل **أرسل دعوة بالبريد للطلاب الجدد** إن أردت، وهو متوقف افتراضيًا. تصل الدعوة لمن له بريد فقط.
7. اضغط **استورد الصفوف الصالحة**.
## مراجعة الفحص
يعرض الفحص أربعة أرقام: **الصفوف الموجودة** و**جاهزة** و**تنبيهات** و**أخطاء**، وتحتها جدول بالصف والحقل وما وجدناه. يظهر أول 200 ملاحظة فقط، وأرقام الملخص تشمل كل الصفوف. وأول صف بيانات هو الصف 2 لأن الصف 1 عناوين الأعمدة.
- **الخطأ** يعني أن الصف لن يُضاف، مثل بريد أو هاتف غير صالح، أو اسم ناقص، أو بريد أو هاتف مكرر داخل الملف.
- **التنبيه** لا يمنع الصف من الإضافة. مثال: قيمة غير مفهومة في **acceptsMarketing** تُعامل على أنها «لا».
- زر **تقرير الفحص** ينزّل التقرير كاملًا.
نعرف الطالب الموجود عندك من بريده أو هاتفه. اختر ما تفعله به تحت «إن كان موجودًا مسبقًا»:
| الخيار | النتيجة |
|---|---|
| **تخطَّه** | يبقى كما هو |
| **حدّثه** | يتحدّث اسمه، وموافقة النشرة إن كانت خانتها غير فارغة. ولا يتغيّر بريده ولا هاتفه أبدًا |
إن كان البريد لطالب والهاتف لطالب آخر فلن يُضاف الصف مهما كان اختيارك.
## ماذا يحدث بعد ذلك؟
تظهر رسالة مثل «أُنشئ 100، وحُدّث 10، وتُخطّي 7، ولم يُطبّق 3 صفًا». وعبارة «لم يُطبّق» تعني أن هذه الصفوف لم تُضَف. تجد العملية في تبويب **السجل**، ويمكنك مغادرة الصفحة أثناء الاستيراد.
- إن بلغت حد الطلاب في باقتك يتوقف الاستيراد وتخبرك الرسالة «توقف الاستيراد عند حد الباقة».
- الدعوة رسالة بريد عنوانها «دعوة للانضمام إلى اسم أكاديميتك». تقول للطالب إنه أُضيف إلى أكاديميتك، وتطلب منه أن يسجّل الدخول أو ينشئ حسابه بالبريد نفسه. في الحالة المعتادة تحمل الرسالة زر **تسجيل الدخول** يفتح صفحة الدخول في أكاديميتك على عنوانها الذي ينتهي بنطاق منهلي، مع الرابط نفسه مكتوبًا تحت الزر. وفي حالة نادرة لا نجد فيها عنوان أكاديميتك تصل الرسالة بلا زر، ويكفي نصها. لا تحتوي الرسالة كلمة مرور في أي حال.
- أضف دورة لطلابك المستوردين بعد ذلك: [إضافة طلاب إلى دورة](/help/enroll-student-manually).
من الصفحة نفسها تستورد أيضًا **الدورات** و**المنتجات الرقمية** و**القسائم**، ولكل نوع أعمدته وقالبه. استيراد الطلبات السابقة غير متاح لأنها سجلات مالية. وتحديث الدورات الموجودة غير متاح كذلك.
> [!tip] جرّب أولًا بملف صغير من 5 صفوف، وراجع نتيجة الفحص قبل أن ترفع ملفك الكبير.
## إذا واجهت مشكلة
| ما يظهر لك | ما تفعله |
|---|---|
| الملف يفتقد عمودًا مطلوبًا. راجع القالب وأعد رفع الملف | تأكد من عمود **name** في السطر الأول |
| يتجاوز الملف الحد الأقصى: 500 صف. قسّمه ثم أعد رفعه | قسّم الملف |
| لا توجد صفوف بيانات في الملف | ملفك عناوين فقط. أضف الصفوف |
| تعذّر قراءة الملف. احفظه بصيغة CSV أو XLSX أو JSON ثم أعد رفعه | أعد حفظه بإحدى هذه الصيغ |
| أدخل بريدًا إلكترونيًا أو رقم هاتف | الصف بلا وسيلة تواصل. أضف بريدًا أو هاتفًا |
| القيمة مكررة في صف سابق من الملف | أزل الصف المكرر |
| البريد الإلكتروني والهاتف يخصّان طالبين مختلفين | وحّد بيانات الصف |
| لا توجد صفوف صالحة للاستيراد. أصلح الملف ثم أعد رفعه | كل صفوفك بها أخطاء. أصلحها |
| توقف الاستيراد عند حد الباقة | رقِّ الباقة أو احذف طلابًا لا تحتاجهم، ثم استورد الصفوف المتبقية |
| أُضيف الطالب وتعذّر تجهيز دعوته. سنعيد المحاولة تلقائيًا | لا يلزمك فعل شيء |
| انتهت صلاحية الملف. أعد رفعه لفحصه مجددًا | الملفات تبقى 7 أيام فقط |