الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

هل تحتاج إلى تحديث العديد من السجلات دفعة واحدة؟ بدلاً من تعديلها واحدًا تلو الآخر، استخدم استيراد CSV لتحديث السجلات الموجودة بشكل مجمّع. حالات الاستخدام:
  • حدّث المسمّيات الوظيفية لعدة أشخاص
  • غيّر معلومات الشركة بشكل مجمّع
  • أضِف بيانات إلى حقول مخصّصة جديدة
  • صحّح أخطاء البيانات عبر العديد من السجلات

​
كيف يعمل

عند استيراد ملف يحتوي على معرّف فريد يطابق سجلًا موجودًا، يقوم Twenty بتحديث ذلك السجل بدلاً من إنشاء نسخة مكررة.
إذا كان المعرّف الفريد…سيقوم Twenty بـ…
يطابق سجلًا موجودًاتحديث السجل الموجود
لا يطابق أي سجلإنشاء سجل جديد
مفقود من ملفكإنشاء سجل جديد (بمُعرّف يتم إنشاؤه تلقائيًا)
يتم استبدال حقول الاختيار المتعدد، ولا يتم دمجها.إذا كان السجل محدّدًا فيه Option A وOption B، وقمتَ باستيراد [\"Option C\"]، فسيحتوي السجل على Option C فقط بعد الاستيراد. تستبدل عملية الاستيراد جميع الاختيارات السابقة — ولا تضيف إليها.للاحتفاظ بالقيم الحالية، ضمّنها جميعًا في عملية الاستيراد: [\"Option A\",\"Option B\",\"Option C\"]

​
الخطوة 1: تصدير بياناتك الحالية

أولًا، صدّر السجلات التي تريد تحديثها:
  1. انتقل إلى الكائن (الأشخاص، الشركات، إلخ)
  2. أضِف الأعمدة التي تحتاجها — انقر Options → Fields لعرض الحقول التي تريد تحديثها
  3. رشّح إذا لزم الأمر — ضيّق النطاق ليقتصر على السجلات التي تريد تحديثها
  4. انقر ⋮ → Export view
  5. احفظ ملف CSV
لماذا نُصدِّر أولًا؟ يحتوي الملف المُصدَّر على التنسيق الصحيح، ويتضمن معرّفات فريدة، ويتم تعيينه تلقائيًا أثناء الاستيراد.

​
ما الذي يتم تصديره

  • جميع الأعمدة المرئية في العرض الحالي
  • المعرّفات الفريدة للسجل (id، email، domain)
  • قيم الحقول الحالية التي يمكنك تعديلها

​
الخطوة 2: تحرير ملف CSV

افتح الملف المُصدَّر في تطبيق الجداول الحسابية لديك (Excel، Google Sheets، إلخ):
  1. أبقِ عمود المعرّف الفريد — لا تحذف id أو email أو domain
  2. حدّث القيم في الأعمدة التي تريد تغييرها
  3. أزِل الأعمدة التي لا تحتاج إلى تحديثها (اختياري، لكنه أنظف)
  4. لا تغيّر قيم المعرّفات الفريدة — وإلا فسيقوم Twenty بإنشاء سجلات جديدة

​
مثال: تحديث المسمّيات الوظيفية

الملف المُصدَّر: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,[email protected],John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,[email protected],Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,[email protected],Bob,Johnson,Sales Rep
بعد تعديلاتك: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,[email protected],John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,[email protected],Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,[email protected],Bob,Johnson,Account Executive
لا تغيّر قيم المعرّفات الفريدة.إذا غيّرتَ [email protected] إلى [email protected]، فسيقوم Twenty بإنشاء سجل جديد بدلاً من تحديث السجل الموجود.

​
الخطوة 3: استيراد الملف المُحدَّث

  1. انتقل إلى الكائن
  2. انقر ⋮ → Import records
  3. حمّل ملف CSV الذي تم تحريره
  4. تأكّد من تعيين المعرّف الفريد — تحقّق من تعيين email أو domain أو id بشكل صحيح
  5. راجع تعيينات الحقول
  6. تحقّق من الأخطاء
  7. انقر Confirm
يطابق Twenty السجلات باستخدام المعرّف الفريد ويحدّثها بالقيم الجديدة.

​
اختيار المعرّف الفريد المناسب

كائنمُوصى بهبديلالملاحظات
الأشخاصالبريد الإلكترونيidالبريد الإلكتروني مقروء للبشر
الشركاتالنطاقidالنطاق مقروء للبشر
كائنات مخصصةأي حقل فريدidاستخدم الحقل الفريد المخصّص لديك
استخدم مُعرّفًا فريدًا واحدًا فقط. لا تقُم بتعيين كلٍّ من email وid. قد يسبب هذا ارتباكًا وأخطاء.

​
استخدام حقول فريدة مخصّصة

إذا كان لديك حقل مخصّص مُعلَّم كفريد (مثل مُعرّف خارجي من نظام آخر):
  1. ضمّن ذلك الحقل في التصدير والاستيراد
  2. قم بتعيينه أثناء الاستيراد
  3. سيطابق Twenty بناءً على ذلك الحقل

​
الخطوة 4: التحقق من التحديثات

بعد الاستيراد:
  1. افتح بعض السجلات التي تم تحديثها
  2. تحقّق من تطبيق التغييرات
  3. تحقّق من عدم إنشاء سجلات مكررة

​
ماذا عن الحقول غير الموجودة في ملفك؟

الحقول غير المُدرجة في ملف الاستيراد تبقى دون تغيير.
يحتوي ملفك على…النتيجة
email, jobTitleيتم تحديث jobTitle فقط؛ وتبقى الحقول الأخرى كما هي
email, jobTitle, phoneيتم تحديث jobTitle وphone
هذا يعني أنك تحتاج فقط إلى تضمين الحقول التي تريد تغييرها (بالإضافة إلى المعرّف الفريد).

​
الجمع بين التحديثات والسجلات الجديدة

يمكنك تحديث السجلات الموجودة وإنشاء سجلات جديدة في نفس عملية الاستيراد: 
email,firstName,lastName,jobTitle
[email protected],John,Smith,Senior Manager    ← Updates existing (email matches)
[email protected],New,Person,Analyst      ← Creates new (email doesn't match)

​
أخطاء شائعة يجب تجنّبها

الخطأالمشكلةالنتيجةالحل
تغيير المعرّف الفريدتغيير [email protected] إلى [email protected]يُنشئ سجلًا جديدًا بدلًا من التحديثأبقِ المعرّفات الفريدة كما هي
حقول فريدة متعددةتعيين كلٍّ من email وidاحتمال حدوث تعارضات في المطابقةقم بتعيين مُعرّف فريد واحد فقط
لا يوجد معرّف فريديحتوي الملف فقط على firstName وlastName وjobTitleكل الصفوف تُنشئ سجلات جديدةقم دائمًا بتضمين email أو domain أو id
عدم تطابق حالة الأحرفالملف يحتوي على [email protected] لكن Twenty يحتوي على [email protected]ينشئ سجلًا جديدًاصدّر من Twenty للحصول على القيم الدقيقة

​
الأسئلة الشائعة

السجلات ذات المعرّفات الفريدة التي لا تطابق سجلات موجودة سيتم إنشاؤها كسجلات جديدة. يتيح لك هذا التحديث والإنشاء في نفس عملية الاستيراد.
نعم، اترك الخلية فارغة في ملف CSV. ستقوم عملية الاستيراد بمسح قيمة ذلك الحقل في السجل الموجود.
الحقول غير الموجودة في ملف الاستيراد تبقى دون تغيير في السجلات الموجودة. يتم تحديث الحقول التي تضمّنها فقط.
نعم! ضمّن المعرّف الفريد للعلاقة (مثلًا، companyDomain) وعيّنه لحقل العلاقة. سيتم تحديث العلاقة.
أثناء خطوة مراجعة الاستيراد، يعرض لك Twenty عدد السجلات التي سيتم تحديثها مقابل إنشائها بناءً على تطابقات المعرّف الفريد.
لا يوجد تراجع تلقائي. نوصي بتصدير بياناتك كنسخة احتياطية قبل إجراء تحديثات مجمّعة.

​
أفضل الممارسات

  1. ابدأ بالتصدير أولًا — ابدأ دائمًا من تصدير لضمان التنسيق الصحيح
  2. قم بإنشاء نسخة احتياطية قبل التحديث — صدّر بياناتك قبل إجراء تغييرات مجمّعة
  3. اختبر على عدد قليل من السجلات — جرّب تحديث 5–10 سجلات أولًا قبل تنفيذ دفعة كبيرة
  4. استخدم معرّفات مقروءة للبشر — يعدّ email وdomain أسهل في التحقق منهما من id
  5. ضمّن الأعمدة اللازمة فقط — فكلما قلّ عدد الأعمدة قلّ احتمال حدوث الأخطاء

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

هل تواجه مشكلات؟ اطّلع على: