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

# إصلاح أخطاء الاستيراد

> دليل شامل لاستكشاف أخطاء استيراد CSV وإصلاحها.

## نظرة عامة

هل تواجه مشكلة في الاستيراد؟ يساعدك هذا الدليل على تحديد أخطاء الاستيراد الشائعة وإصلاحها خطوة بخطوة.

## كيف تعمل عملية التحقّق من الاستيراد

بعد رفع ملفك وتعيين الأعمدة، تتحقّق Twenty من بياناتك:

1. **تُجرى عملية التحقّق** — تتحقّق Twenty من كل صف بحثًا عن الأخطاء
2. **تمييز الأخطاء** — تظهر الصفوف ذات المشكلات باللون **الأصفر**
3. **يمكنك الإصلاح مباشرةً** — حرّر الخلايا مباشرةً في واجهة الاستيراد
4. **أو إزالة الصفوف** — تخطَّ السجلات التي بها مشكلات تمامًا

<Note>**أصلِح الأخطاء في الواجهة.** لست مضطرًا للعودة إلى جدول البيانات الخاص بك. حرّر الخلايا مباشرة أثناء الاستيراد لتوفير الوقت.</Note>

## استكشاف الأخطاء وإصلاحها خطوة بخطوة

### الخطوة 1: تحديد نوع الخطأ

انقر على صف مميّز للاطلاع على رسالة الخطأ المحددة. أنواع الأخطاء الشائعة:

| رسالة الخطأ                                                             | ماذا يعني ذلك                                        |
| ----------------------------------------------------------------------- | ---------------------------------------------------- |
| تم تمييز القيم المكرّرة باللون الأصفر                                   | القيمة موجودة مسبقًا في Twenty أو تظهر مرتين في ملفك |
| `{field} is not a valid {type}` (مرّر المؤشر فوق الخلية الصفراء)        | البيانات لا تطابق التنسيق المتوقع                    |
| تم تمييز الحقل المطلوب                                                  | الحقل المطلوب فارغ                                   |
| `Can't connect to {object}. No unique record found...` (يفشل الاستيراد) | السجل المشار إليه غير موجود                          |
| `Too many records. Up to 10000 allowed` (تم حظر التحميل)                | يحتوي الملف على أكثر من 10,000 سجل                   |

### الخطوة 2: إصلاح الخطأ

اتّبع الإرشادات المحددة أدناه لكل نوع من الأخطاء.

***

## خطأ: قيمة مكرّرة

### ما ستراه

تُميَّز الصفوف ذات القيم المكرّرة باللون **الأصفر** في واجهة الاستيراد قبل بدء الاستيراد.

### ماذا يعني ذلك

حقل فريد (البريد الإلكتروني، النطاق) إمّا:

* موجود مسبقًا في Twenty
* يظهر مرتين في ملفك

### كيفية الإصلاح

**الخيار 1: تعديل القيمة المكرّرة**

1. انقر فوق الخلية التي تحتوي على الخطأ
2. غيّرها إلى قيمة فريدة
3. تابع الاستيراد

**الخيار 2: إزالة الصف المكرّر**

1. انقر الرمز X بجوار الصف
2. سيتم تخطّي الصف أثناء الاستيراد

**الخيار 3: دع Twenty تحدّث السجل الموجود**

1. تأكّد من أن ملفك يتضمن معرّفًا فريدًا (`email`، `domain`، أو `id`)
2. قم بتعيين حقل المعرّف الفريد
3. ستقوم Twenty بتحديث السجل الموجود بدلًا من إنشاء نسخة مكرّرة

<Note>
  **يمكنك تحديث الحقول الفريدة أيضًا.**

  * إذا أبقيت على `id` لكن غيّرت `email` → فسيتم تحديث البريد الإلكتروني
  * إذا أبقيت على `email` لكن غيّرت `id` → فسيتم تحديث المعرّف

  طالما أن أحد المعرّفات الفريدة يطابق، تقوم Twenty بتحديث السجل.
</Note>

### كيفية منع هذا الخطأ

قبل الاستيراد:

1. رتّب جدول البيانات حسب الحقل الفريد
2. أزل الصفوف المكرّرة
3. تحقّق مما إذا كانت السجلات موجودة مسبقًا في Twenty

<Warning>
  **السجلات المحذوفة حذفًا ناعمًا تُحتسب ضمن التفرد.**

  تحقّق من قائمة الأوامر → اعرض السجلات المحذوفة. السجلات هناك ما تزال تفرض شرط التفرد. احذفها نهائيًا أو استعدها وقم بتحديثها.
</Warning>

لمزيد من التفاصيل: [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)

***

## خطأ: تنسيق غير صالح

### ما ستراه

تم تمييز قيمة الخلية باللون الأصفر. مرّر المؤشر فوقها للاطلاع على رسالة الخطأ:

```
{field name} is not a valid {field type}
```

### ماذا يعني ذلك

لا تطابق البيانات التنسيق المتوقع لذلك النوع من الحقول.

### كيفية الإصلاح — حسب نوع الحقل

#### البريد الإلكتروني

**المشكلة:** تنسيق بريد إلكتروني غير صالح
**الحل:** استخدم التنسيق `name@domain.com`

```
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com
```

#### النطاق

**المشكلة:** قد يتسبب عدم اتساق التنسيق في حدوث تكرارات
**الحل:** استخدم تنسيق `https://domain.com` (موصى به)

```
⚠️ acme.com         (valid, but not recommended)
⚠️ www.acme.com     (valid, but not recommended)
✅ https://acme.com  (recommended)
```

<Note>جميع التنسيقات صالحة، لكن يُوصى بـ `https://domain.com` لأنه يطابق التنسيق المستخدم في مزامنة البريد الإلكتروني/التقويم. قد يؤدي استخدام تنسيقات أخرى إلى إنشاء شركات مكرّرة.</Note>

#### تاريخ

**المشكلة:** تنسيق تاريخ غير معروف
**الحل:** استخدم تنسيق `YYYY-MM-DD` بشكل متّسق في جميع أنحاء الملف

```
✓ 2024-03-15        (YYYY-MM-DD)
❌ 03/15/2024        (MM/DD/YYYY)
❌ 15/03/2024        (DD/MM/YYYY)
```

#### هاتف

**المشكلة:** أعمدة مطلوبة مفقودة
**الحل:** تضمين جميع أعمدة الهاتف

| العمود                                  | مثال         |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number**       | `4159095555` |
| **Phones / Primary Phone Country Code** | `US`         |
| **Phones / Primary Phone Calling Code** | `+1`         |

#### قيمة منطقية

**المشكلة:** قيمة منطقية خاطئة
**الحل:** استخدم `TRUE` أو `FALSE` بحروف كبيرة

```
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE
```

#### اختيار / اختيار متعدد

**المشكلة:** لا تطابق القيمة الخيارات الموجودة
**الحل:** استخدم **أسماء واجهة برمجة التطبيقات (API)**، وليس تسميات العرض

كيفية العثور على أسماء واجهة برمجة التطبيقات:

1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن والحقل
3. فعّل **الوضع المتقدم** (زر التبديل في أسفل اليمين)
4. استخدم اسم واجهة برمجة التطبيقات (على سبيل المثال، `OPTION_1`، وليس "Option 1")

```
❌ High Priority
✓ HIGH_PRIORITY
```

#### العملة

**المشكلة:** المبلغ أو رمز العملة مفقود
**الحل:** املأ كلا العمودين

| العمود              | مثال      |
| ------------------- | --------- |
| **المبلغ / المبلغ** | `1234.56` |
| **المبلغ / العملة** | `USD`     |

#### رقم

**المشكلة:** أحرف غير رقمية
**الحل:** أرقام فقط، ونقطة للفواصل العشرية

```
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
```

للاطلاع على مرجع التنسيقات الكامل: [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)

***

## خطأ: حقل مطلوب مفقود

### ما ستراه

تم تمييز الصف باللون الأصفر مع وضع علامة على خلية الحقل المطلوب.

### ماذا يعني ذلك

الحقل المطلوب فارغ لهذا الصف.

### كيفية الإصلاح

**الخيار 1: إدخال قيمة**

1. انقر فوق الخلية الفارغة
2. أدخل قيمة
3. تابع الاستيراد

**الخيار 2: إزالة الصف**

1. إذا لم تكن لديك البيانات، انقر X لتخطّي الصف

### كيفية منع هذا الخطأ

قبل الاستيراد، حدّد الحقول المطلوبة:

1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الخاص بك
3. تحقّق من الحقول المُعلمة كمطلوبة

***

## خطأ: العلاقة غير موجودة

### ما ستراه

يظهر هذا الخطأ **بعد بدء الاستيراد** — يفشل الاستيراد برسالة مثل:

```
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
```

هذا يعني أنه لا توجد شركة في Twenty بذلك المعرّف المحدّد.

<Note>على عكس الأخطاء الأخرى، لا يُلتقط هذا الخطأ أثناء خطوة مراجعة البيانات. سيبدأ الاستيراد ثم يفشل عند مواجهة العلاقة المفقودة.</Note>

### ماذا يعني ذلك

تحاول ربط سجل غير موجود في Twenty.

### كيفية الإصلاح

**الخيار 1: استيراد سجلات الأصل أولًا**

1. ألغِ الاستيراد الحالي
2. استورد سجلات الأصل (مثلًا، الشركات)
3. ثم استورد سجلات التابع (مثلًا، الأشخاص)

**الخيار 2: أصلِح قيمة المرجع**

1. تحقّق من قيمة المرجع في ملفك
2. تأكّد من أنه يطابق سجلًا موجودًا تمامًا
3. تحقّق من التنسيق: يجب أن تكون النطاقات بصيغة `https://domain.com`

**الخيار 3: إزالة العلاقة**

1. امسح الخلية للاستيراد دون العلاقة
2. أضِف العلاقة يدويًا لاحقًا

### كيفية منع هذا الخطأ

1. **استورد بالترتيب الصحيح:**
   * الشركات أولًا
   * الأشخاص ثانيًا (مع مراجع الشركة)
   * الفرص ثالثًا

2. **تحقّق من قيم المراجع:**
   * صدّر سجلات الأصل للحصول على معرّفات دقيقة
   * استخدم تنسيق النطاق `https://domain.com`
   * تحقّق من الأخطاء الإملائية وحساسية حالة الأحرف

<Warning>
  **سيفشل الاستيراد إذا تمت الإشارة إلى سجل غير موجود.**

  استورد دائمًا كائنات الأصل قبل كائنات التابع.
</Warning>

لمزيد من التفاصيل: [استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations)

***

## خطأ: ملف كبير جدًا

### ما ستراه

يظهر هذا الخطأ **عند رفع ملفك** — يتم حظر التحميل بالكامل:

```
Too many records. Up to 10000 allowed
```

لن تتمكّن من الانتقال إلى خطوة مراجعة البيانات حتى تقلّل حجم الملف.

### ماذا يعني ذلك

يحتوي ملفك على أكثر من 10,000 سجل.

### كيفية الإصلاح

**الخيار 1: التقسيم إلى عدة ملفات**

1. قسّم بياناتك إلى ملفات تحتوي على 10,000 سجل أو أقل
2. استورد كل ملف على حدة
3. حافظ على ترتيب الاستيراد (الشركات قبل الأشخاص)

**الخيار 2: استخدم الاستيراد عبر واجهة برمجة التطبيقات (API)**
بالنسبة لمجموعات البيانات الكبيرة جدًا، استخدم واجهة برمجة التطبيقات التي لا تحتوي على حد لعدد السجلات.
راجع: [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)

***

## خطأ: لم يتم التعرّف على الحقل

### ماذا يعني ذلك

لا يمكن تعيين عمود في ملفك لأن الحقل غير موجود في Twenty.

### كيفية الإصلاح

1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الذي تستورده
3. انقر **+ إضافة حقل**
4. أنشئ الحقل المخصّص بالنوع المناسب
5. أعد رفع ملفك

<Note>يُنشئ استيراد CSV سجلات، وليس حقولًا. يجب أن تكون جميع الحقول موجودة قبل الاستيراد.</Note>

***

## خطأ: علاقة المستخدم فارغة

### ماذا يعني ذلك

تحاول إسناد سجل إلى مستخدم (المالك، المعيَّن) لكن العلاقة لا يتم تعيينها.

### أسباب شائعة

1. **لم يقبل المستخدم دعوته** — المستخدم غير موجود في Twenty بعد
2. **استخدام معرّف مستخدم من نظام قديم** — لا تستطيع Twenty مطابقة المعرّفات من نظام آخر
3. **تنسيق بريد إلكتروني خاطئ** — البريد الإلكتروني لا يطابق حساب المستخدم في Twenty

### كيفية الإصلاح

1. تأكّد من أن جميع المستخدمين قد **قبلوا دعوتهم** إلى مساحة عمل Twenty الخاصة بك
2. استخدم **عنوان البريد الإلكتروني** الخاص بالمستخدم (وليس اسمه أو معرّف النظام القديم)
3. استخدم البريد الإلكتروني نفسه الذي استخدموه للانضمام إلى Twenty

<Warning>
  **يجب على المستخدمين قبول الدعوات قبل الاستيراد.**

  إذا لم يقبل المستخدم دعوته، فستكون علاقات المستخدم فارغة في السجلات التي تشير إليه.
</Warning>

***

## قائمة ما قبل الاستيراد

تجنّب الأخطاء من خلال التحقّق مما يلي قبل الاستيراد:

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

<Check>الملف بتنسيق CSV أو XLSX أو XLS</Check>
<Check>يحتوي الملف على أقل من 10,000 سجل</Check>
<Check>يستخدم الملف ترميز UTF-8</Check>

### جودة البيانات

<Check>لا توجد رسائل بريد إلكتروني مكرّرة (للأشخاص)</Check>
<Check>لا توجد نطاقات مكرّرة (للشركات)</Check>
<Check>جميع التواريخ تستخدم تنسيقًا متّسقًا</Check>
<Check>جميع النطاقات تستخدم تنسيق `https://domain.com`</Check>

### تنسيقات الحقول

<Check>الحقول المنطقية تستخدم `TRUE` أو `FALSE` (أحرف كبيرة)</Check>
<Check>حقول الاختيار تستخدم أسماء واجهة برمجة التطبيقات (API)، وليس تسميات العرض</Check>
<Check>حقول الهاتف تحتوي على جميع الأعمدة المطلوبة</Check>
<Check>حقول العملة تتضمن كلًا من المبلغ ورمز العملة</Check>

### العلاقات

<Check>تم استيراد سجلات الأصل قبل سجلات التابع</Check>
<Check>أعمدة العلاقات تشير إلى سجلات موجودة</Check>
<Check>تنسيق النطاق يطابق تنسيق Twenty تمامًا</Check>

### نموذج البيانات

<Check>جميع الحقول المخصّصة موجودة في الإعدادات → نموذج البيانات</Check>
<Check>خيارات الاختيار موجودة قبل الاستيراد</Check>

***

## هل لا تزال تواجه مشكلات؟

إذا كنت قد جرّبت الحلول أعلاه:

1. **نزّل ملف العيّنة** — اطّلع على التنسيق الدقيق الذي تتوقعه Twenty
2. **صدّر السجلات الموجودة** — قارن ملفك بالبيانات التي تعمل بشكل صحيح
3. **اختبر بدفعة صغيرة** — جرّب 5-10 صفوف أولًا
4. **اطّلع على مقالات المرجع:**
   * [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)
   * [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)
   * [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations)
   * [التعامل مع الأخطاء](/l/ar/user-guide/data-migration/capabilities/error-handling)