# تصدير البيانات واستيرادها

من أي قائمة، نزل السجلات في ملف XLSX أو CSV بالحقول التي تختارها، ثم أعد جدول بيانات عبر استيراد السجلات، مع اختبار قبل كتابة أي شيء.

يبدأ التصدير والاستيراد كلاهما من عرض القائمة. يكتب التصدير السجلات في ملف جدول بيانات؛ ويقرأ الاستيراد جدول بيانات وينشئ السجلات أو يحدثها. يستخدم المثال أدناه جهات الاتصال، لكن العناصر نفسها موجودة في كل قائمة. التصدير صلاحية قائمة بذاتها: يملكها مسؤولو النظام، ويحتاج المستخدمون الآخرون إلى منحها (صلاحية **تصدير**، مجموعة **مسموح به**، على نموذج المستخدم تحت **الإعدادات/المستخدمون والشركات/المستخدمون**). أما الاستيراد فيحتاج إلى صلاحية إنشاء السجلات في ذلك التطبيق.

## قبل أن تبدأ {#before-you-start}

- صف القائمة أولا: يتبع التصدير البحث والتجميع الحاليين.
- للاستيراد، جهز الملف في جدول بيانات: صف لكل سجل، وعمود لكل حقل، والصف الأول يحمل أسماء الأعمدة. ينصح بملفات Excel؛ وتعمل ملفات .csv أيضا.
- أضمن قالب للاستيراد هو تصدير للقائمة نفسها مع تفعيل **أرغب في استيراد البيانات (التصدير المتوافق مع الاستيراد)**: أعمدته تطابق الحقول، وعمود **معرف خارجي** فيه يتيح لك تحديث السجلات نفسها لاحقا.

## الخطوات {#steps}

1. افتح **جهات الاتصال/جهات الاتصال**؛ تفتح قائمة جهات الاتصال. طبق عوامل التصفية التي تحتاجها.
2. لنسخة سريعة اضغط **الإجراءات** ثم **تصدير الكل**. ينزل فورا ملف XLSX بالأعمدة المعروضة في القائمة، لكل سجل يطابق البحث.
3. لاختيار الحقول، حدد السجلات المراد تصديرها (المربع في بداية كل صف؛ ويحدد المربع في الترويسة الصفحة كلها)، ثم اضغط **الإجراءات** و**تصدير**.

![حوار "تصدير البيانات": الصيغة والحقول المتاحة والحقول المراد تصديرها والقوالب.](https://jaah.app/web/image/6817-28d398d2/essentials-export-export_dialog-ar.png)

4. في حوار **تصدير البيانات** اختر **صيغة الملف المصدر:** (XLSX أو CSV). ابحث عن حقل تحت **الحقول المتاحة** (يصفيها مربع **بحث**) وأضفه بعلامة الزائد (**تحديد الحقل**)؛ ووسع العلاقة (**إظهار الحقول الفرعية**) للوصول إلى حقول السجل المرتبط. أعد ترتيب القائمة تحت **الحقول المراد تصديرها** بالسحب، أو أزل حقلا بأيقونة سلة المهملات (**إزالة الحقل**). فعل **أرغب في استيراد البيانات (التصدير المتوافق مع الاستيراد)** لتحصل على ملف يمكنك استيراده من جديد. ولإعادة استخدام الاختيار لاحقا افتح **القالب:**، واختر **قالب جديد**، وسمه تحت **الحفظ كـ:** واحفظه. اضغط **تصدير**؛ ويخرج **إغلاق** دون تصدير.
5. للاستيراد اضغط **الإجراءات** ثم **استيراد السجلات**. تفتح شاشة **استيراد ملف** وفيها **قم بإفلات أو رفع ملف لاستيراده**. اضغط **رفع ملف البيانات** واختر ملفك (.csv أو .xls أو .xlsx أو .xlsm أو .ods)، أو أفلته على الشاشة.

![شاشة "استيراد ملف" قبل تحميل أي ملف.](https://jaah.app/web/image/6821-181bf4dd/essentials-export-import_screen-ar.png)

6. راجع المطابقة: يقابل كل **عمود الملف** حقل في عمود **حقل جاه**؛ والعمود الذي يحمل عبارة **للاستيراد، قم باختيار حقل...** يتجاهل ما لم تختر له حقلا؛ وتعرض **معاينة** القيم الأولى، وتشير **التعليقات** إلى المشكلات. وعلى الجانب، يضم **التنسيق** الخيار **استخدم الصف الأول كترويسة**، ولملفات CSV **الفاصل:** و**الترميز:**؛ ويضم **متقدم** الخيارين **تتبع السجل خلال الاستيراد** و**السماح بالمطابقة مع الحقول الفرعية**؛ ويضم **الاستيراد المجمع** الخيارين **حد الدفعة** و**ابدأ من السطر**. ويستبدل **تحميل ملف البيانات** الملف.
7. اضغط **اختبار**. لا يكتب شيء بعد: النتيجة إما **يبدو كل شيء صحيحاً.** وإما **يحتوي الملف على أخطاء تعيق العمليات (انظر أدناه)** مع سرد كل خطأ. أصلح الملف أو المطابقة واختبر من جديد.
8. اضغط **استيراد**. يؤكد إشعار عدد السجلات المستوردة، مثل "12 سجلات تم استيرادها بنجاح". يحمل الملف الكبير على دفعات؛ وإذا توقف الاستيراد مؤقتا فيكمله **المتابعة**. ويعيدك **إلغاء** إلى القائمة.

!!! warning "اختبر قبل الاستيراد"
    لا يمكن التراجع عن الاستيراد. شغل **اختبار** حتى يبلغ **يبدو كل شيء صحيحاً.**، واحتفظ بتصدير للقائمة مأخوذ قبل الاستيراد.

## النتيجة {#result}

يعطيك التصدير ملفا بالحقول التي اخترتها تحديدا، صف لكل سجل، بالصيغة التي اخترتها. وينشئ الاستيراد سجلا لكل صف؛ وحين يحمل الملف عمود **معرف خارجي** يطابق سجلات موجودة، تحدث تلك السجلات بدلا من تكرارها. افتح القائمة من جديد للتحقق من النتيجة.

## الأسئلة الشائعة {#faq}

### لماذا لا أرى تصدير أو تصدير الكل؟ {#export-missing}

صلاحية التصدير غير ممنوحة لحسابك. يملكها مسؤولو النظام؛ فاطلب من أحدهم منح صلاحية **تصدير** (مجموعة **مسموح به**) على نموذج المستخدم الخاص بك. ولا يعتمد الاستيراد عليها.

### أي صيغة أختار؟ {#which-format}

XLSX، ما لم تكن الأداة التي ستقرأ الملف لا تقبل إلا CSV. عند الاستيراد لا يحتاج ملف XLSX إلى أي إعداد (تقول الشاشة **يتطلب ملفات بصيغة Excel حيث أن التنسيق يتم تلقائياً.**)، بينما يجب لملف CSV اختيار **الفاصل:** و**الترميز:** الصحيحين تحت **التنسيق**.

### كيف أحدث السجلات الموجودة بدلا من إنشاء نسخ مكررة؟ {#update-existing}

صدرها مع تفعيل **أرغب في استيراد البيانات (التصدير المتوافق مع الاستيراد)**، وعدل الملف دون المساس بعمود **معرف خارجي**، ثم استورده: يحدث كل صف السجل الذي يشير إليه معرفه الخارجي.

### هل يمكن التراجع عن استيراد؟ {#undo-import}

لا. استخدم **اختبار** أولا، وجرب ملفا صغيرا، واحتفظ بالتصدير الذي أخذته قبل تغيير أي شيء. أما السجلات المنشأة بالخطأ فيجب حذفها أو أرشفتها يدويا.

---

- Source: https://jaah.app/ar/docs/essentials/export-and-import-data
- Updated: 2026-10-13
- Version: الأساسيات 19.0.2.0.5
- Verified: 2026-10-13