> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# تنسيقات الملفات المدعومة

> تنسيقات الملفات المدعومة لاستيراد البيانات في Twenty.

## التنسيقات المدعومة

يدعم Twenty ثلاث تنسيقات ملفات للاستيراد:

| التنسيق          | الامتداد | الملاحظات               |
| ---------------- | -------- | ----------------------- |
| **CSV**          | .csv     | موصى به، الأكثر توافقاً |
| **Excel**        | .xlsx    | تنسيق Excel الحديث      |
| **Excel (قديم)** | .xls     | تنسيق Excel الأقدم      |

## متطلبات الملف

| متطلب                   | القيمة                                     |
| ----------------------- | ------------------------------------------ |
| **الترميز**             | يُوصى باستخدام UTF-8                       |
| **الحد الأقصى للسجلات** | 10,000 سجل لكل ملف                         |
| **الهيكل**              | يجب أن يحتوي الصف الأول على عناوين الأعمدة |
| **المحتوى**             | نوع كائن واحد لكل ملف                      |

## أفضل الممارسات لملفات CSV

* **المحدد**: استخدم الفاصلة (`,`) أو الفاصلة المنقوطة (`;`)
* **محدد النص**: استخدم علامات الاقتباس المزدوجة (`\"`) للنص الذي يحتوي على فواصل
* **نهايات الأسطر**: Windows (CRLF) أو Unix (LF) كلاهما مدعومان
* **القيم الفارغة**: اترك الخلايا فارغة، لا تستخدم "NULL" أو "N/A"

## أفضل الممارسات لبرنامج Excel

عند التصدير من Excel:

* أزل الصيغ (صدّر القيم فقط)
* احذف الصفوف الفارغة في النهاية
* تأكد من عدم وجود خلايا مدمجة
* استخدم الورقة الأولى فقط

## مجموعات البيانات الكبيرة

بالنسبة لمجموعات البيانات التي تزيد عن 10,000 سجل:

* قسّمها إلى عدة ملفات
* أو استخدم [الاستيراد عبر API](/l/ar/user-guide/data-migration/how-tos/import-data-via-api) لسجلات غير محدودة

<Note>بالنسبة لعمليات الترحيل الكبيرة جداً (100,000+ سجل)، تكون واجهة API أسرع بكثير وأكثر موثوقية من عمليات استيراد CSV.</Note>
