التنسيقات المدعومة
يدعم 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 سجل:
بالنسبة لعمليات الترحيل الكبيرة جداً (100,000+ سجل)، تكون واجهة API أسرع بكثير وأكثر موثوقية من عمليات استيراد CSV.
