> ## 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.

# تحديث السجلات الموجودة عبر الاستيراد

> دليل كامل خطوة بخطوة لتحديث السجلات بشكل مجمّع باستخدام استيراد CSV.

## نظرة عامة

هل تحتاج إلى تحديث العديد من السجلات دفعة واحدة؟ بدلاً من تعديلها واحدًا تلو الآخر، استخدم استيراد CSV لتحديث السجلات الموجودة بشكل مجمّع.

**حالات الاستخدام:**

* حدّث المسمّيات الوظيفية لعدة أشخاص
* غيّر معلومات الشركة بشكل مجمّع
* أضِف بيانات إلى حقول مخصّصة جديدة
* صحّح أخطاء البيانات عبر العديد من السجلات

## كيف يعمل

عند استيراد ملف يحتوي على **معرّف فريد** يطابق سجلًا موجودًا، يقوم Twenty بتحديث ذلك السجل بدلاً من إنشاء نسخة مكررة.

| إذا كان المعرّف الفريد... | سيقوم Twenty بـ...                               |
| ------------------------- | ------------------------------------------------ |
| يطابق سجلًا موجودًا       | **تحديث** السجل الموجود                          |
| لا يطابق أي سجل           | **إنشاء** سجل جديد                               |
| مفقود من ملفك             | **إنشاء** سجل جديد (بمُعرّف يتم إنشاؤه تلقائيًا) |

<Warning>
  **يتم استبدال حقول الاختيار المتعدد، ولا يتم دمجها.**

  إذا كان السجل محدّدًا فيه `Option A` و`Option B`، وقمتَ باستيراد `[\"Option C\"]`، فسيحتوي السجل على `Option C` فقط بعد الاستيراد. تستبدل عملية الاستيراد جميع الاختيارات السابقة — ولا تضيف إليها.

  للاحتفاظ بالقيم الحالية، ضمّنها جميعًا في عملية الاستيراد: `[\"Option A\",\"Option B\",\"Option C\"]`
</Warning>

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

أولًا، صدّر السجلات التي تريد تحديثها:

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

<Note>**لماذا نُصدِّر أولًا؟** يحتوي الملف المُصدَّر على التنسيق الصحيح، ويتضمن معرّفات فريدة، ويتم تعيينه تلقائيًا أثناء الاستيراد.</Note>

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

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

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

افتح الملف المُصدَّر في تطبيق الجداول الحسابية لديك (Excel، Google Sheets، إلخ):

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

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

**الملف المُصدَّر:**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```

**بعد تعديلاتك:**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```

<Warning>
  **لا تغيّر قيم المعرّفات الفريدة.**

  إذا غيّرتَ `john@acme.com` إلى `john.smith@acme.com`، فسيقوم Twenty بإنشاء سجل جديد بدلاً من تحديث السجل الموجود.
</Warning>

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

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

يطابق Twenty السجلات باستخدام المعرّف الفريد ويحدّثها بالقيم الجديدة.

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

| كائن             | مُوصى به            | بديل | الملاحظات                        |
| ---------------- | ------------------- | ---- | -------------------------------- |
| **الأشخاص**      | `البريد الإلكتروني` | `id` | البريد الإلكتروني مقروء للبشر    |
| **الشركات**      | `النطاق`            | `id` | النطاق مقروء للبشر               |
| **كائنات مخصصة** | أي حقل فريد         | `id` | استخدم الحقل الفريد المخصّص لديك |

<Note>**استخدم مُعرّفًا فريدًا واحدًا فقط.** لا تقُم بتعيين كلٍّ من `email` و`id`. قد يسبب هذا ارتباكًا وأخطاء.</Note>

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

إذا كان لديك حقل مخصّص مُعلَّم كفريد (مثل مُعرّف خارجي من نظام آخر):

1. ضمّن ذلك الحقل في التصدير والاستيراد
2. قم بتعيينه أثناء الاستيراد
3. سيطابق Twenty بناءً على ذلك الحقل

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

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

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

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

**الحقول غير المُدرجة في ملف الاستيراد تبقى دون تغيير.**

| يحتوي ملفك على...            | النتيجة                                              |
| ---------------------------- | ---------------------------------------------------- |
| `email`, `jobTitle`          | يتم تحديث `jobTitle` فقط؛ وتبقى الحقول الأخرى كما هي |
| `email`, `jobTitle`, `phone` | يتم تحديث `jobTitle` و`phone`                        |

هذا يعني أنك تحتاج فقط إلى تضمين الحقول التي تريد تغييرها (بالإضافة إلى المعرّف الفريد).

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

يمكنك تحديث السجلات الموجودة وإنشاء سجلات جديدة في نفس عملية الاستيراد:

```csv theme={null}
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
```

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

| الخطأ                     | المشكلة                                                              | النتيجة                             | الحل                                         |
| ------------------------- | -------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------- |
| **تغيير المعرّف الفريد**  | تغيير `john@acme.com` إلى `john.smith@acme.com`                      | يُنشئ سجلًا جديدًا بدلًا من التحديث | أبقِ المعرّفات الفريدة كما هي                |
| **حقول فريدة متعددة**     | تعيين كلٍّ من `email` و`id`                                          | احتمال حدوث تعارضات في المطابقة     | قم بتعيين مُعرّف فريد واحد فقط               |
| **لا يوجد معرّف فريد**    | يحتوي الملف فقط على `firstName` و`lastName` و`jobTitle`              | كل الصفوف تُنشئ سجلات جديدة         | قم دائمًا بتضمين `email` أو `domain` أو `id` |
| **عدم تطابق حالة الأحرف** | الملف يحتوي على `John@acme.com` لكن Twenty يحتوي على `john@acme.com` | ينشئ سجلًا جديدًا                   | صدّر من Twenty للحصول على القيم الدقيقة      |

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

<AccordionGroup>
  <Accordion title="ماذا لو لم تكن بعض السجلات موجودة بعد؟">
    السجلات ذات المعرّفات الفريدة التي لا تطابق سجلات موجودة سيتم إنشاؤها كسجلات جديدة. يتيح لك هذا التحديث والإنشاء في نفس عملية الاستيراد.
  </Accordion>

  <Accordion title="هل يمكنني مسح/إفراغ قيمة حقل؟">
    نعم، اترك الخلية فارغة في ملف CSV. ستقوم عملية الاستيراد بمسح قيمة ذلك الحقل في السجل الموجود.
  </Accordion>

  <Accordion title="ماذا يحدث للحقول التي لا أضمّنها في الاستيراد؟">
    الحقول غير الموجودة في ملف الاستيراد تبقى دون تغيير في السجلات الموجودة. يتم تحديث الحقول التي تضمّنها فقط.
  </Accordion>

  <Accordion title="هل يمكنني تحديث حقول العلاقات (مثل الشركة)؟">
    نعم! ضمّن المعرّف الفريد للعلاقة (مثلًا، `companyDomain`) وعيّنه لحقل العلاقة. سيتم تحديث العلاقة.
  </Accordion>

  <Accordion title="كيف أعرف أي السجلات سيتم تحديثها وأيها سيتم إنشاؤه؟">
    أثناء خطوة مراجعة الاستيراد، يعرض لك Twenty عدد السجلات التي سيتم تحديثها مقابل إنشائها بناءً على تطابقات المعرّف الفريد.
  </Accordion>

  <Accordion title="هل يمكنني التراجع عن تحديث مجمّع؟">
    لا يوجد تراجع تلقائي. نوصي بتصدير بياناتك كنسخة احتياطية قبل إجراء تحديثات مجمّعة.
  </Accordion>
</AccordionGroup>

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

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

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

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

* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
* [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)