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

​

نظرة عامة

​

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

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

​

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

​

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

​

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

​

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

​

ما ستراه

​

ماذا يعني ذلك

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

​

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

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

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

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

​

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

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

​

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

​

ما ستراه

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

​

ماذا يعني ذلك

​

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

​

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

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

​

النطاق

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

​

تاريخ

✓ 2024-03-15        (YYYY-MM-DD - recommended)
✓ 03/15/2024        (MM/DD/YYYY)
✓ 15/03/2024        (DD/MM/YYYY)

​

هاتف

​

قيمة منطقية

❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE

​

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

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

❌ High Priority
✓ HIGH_PRIORITY

​

العملة

​

رقم

❌ $1,234.56
❌ 1,234.56
✓ 1234.56

​

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

​

ما ستراه

​

ماذا يعني ذلك

​

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

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

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

​

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

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

​

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

​

ما ستراه

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

​

ماذا يعني ذلك

​

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

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

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

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

​

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

1. استورد بالترتيب الصحيح:
   • الشركات أولًا
   • الأشخاص ثانيًا (مع مراجع الشركة)
   • الفرص ثالثًا
2. تحقّق من قيم المراجع:
   • صدّر سجلات الأصل للحصول على معرّفات دقيقة
   • استخدم تنسيق النطاق https://domain.com
   • تحقّق من الأخطاء الإملائية وحساسية حالة الأحرف

​

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

​

ما ستراه

Too many records. Up to 10000 allowed

​

ماذا يعني ذلك

​

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

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

​

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

​

ماذا يعني ذلك

​

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

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

​

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

​

ماذا يعني ذلك

​

أسباب شائعة

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

​

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

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

​

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

​

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

​

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

​

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

​

العلاقات

​

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

​

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

1. نزّل ملف العيّنة — اطّلع على التنسيق الدقيق الذي تتوقعه Twenty
2. صدّر السجلات الموجودة — قارن ملفك بالبيانات التي تعمل بشكل صحيح
3. اختبر بدفعة صغيرة — جرّب 5-10 صفوف أولًا
4. اطّلع على مقالات المرجع:
   • مرجع تعيين الحقول
   • قيود التفرد
   • كيفية استيراد العلاقات
   • التعامل مع الأخطاء