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

# قيود التفرّد

> كيف يفرض Twenty تفرد البيانات أثناء الاستيراد.

export const VimeoEmbed = ({videoId, title = 'Video'}) => <div style={{
  padding: '69.01% 0 0 0',
  position: 'relative',
  margin: '32px 0px'
}}>
    <iframe src={`https://player.vimeo.com/video/${videoId}?autoplay=1&loop=1&autopause=0&background=1&app_id=58479`} frameBorder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write" style={{
  position: 'absolute',
  top: 0,
  left: 0,
  width: '100%',
  height: '100%',
  borderRadius: '16px',
  border: '2px solid black'
}} title={title} />
  </div>;

## نظرة عامة

يفرض Twenty التفرّد على حقول معيّنة لمنع تكرار السجلات وضمان سلامة البيانات. فهم هذه القيود أمرٌ أساسي لنجاح عمليات الاستيراد.

## الحقول الفريدة الافتراضية

| كائن             | الحقول الفريدة       |
| ---------------- | -------------------- |
| **الأشخاص**      | `id`, `email`        |
| **الشركات**      | `id`, `domain`       |
| **كائنات مخصصة** | `id` فقط (افتراضيًا) |

<Note>حقل `id` هو المعرّف الداخلي الخاص بـ Twenty، يتم إنشاؤه تلقائيًا لكل سجل. يستخدم تنسيق UUID (مثلًا: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>

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

يمكنك تعريف حقول فريدة إضافية ضمن **الإعدادات → نموذج البيانات**:

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

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

* **معرّفات خارجية**: خزّن معرّفات من أنظمة أخرى (Salesforce ID, HubSpot ID)
* **معرّفات الأعمال**: أرقام الموظفين، رموز العملاء
* **معلومات اتصال بديلة**: ملف LinkedIn، رقم الهاتف

<Note>اسم الحقل `id` محجوز للمعرّف الداخلي الخاص بـ Twenty. استخدم اسمًا مختلفًا مثل `externalId` أو `legacyId` للمعرّفات الخارجية.</Note>

## سلوك الاستيراد

### إنشاء سجلات جديدة

إذا لم تكن قيمة الحقل الفريد موجودة، فسيتم إنشاء سجل جديد.

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

إذا طابقت قيمة حقل فريد سجلًا موجودًا، فسيتم **تحديث** ذلك السجل بالبيانات الجديدة.
<Warning>لـ **تحديث السجلات الموجودة**، يُنصَح بـ **مطابقة حقل فريد واحد فقط**.</Warning>

### السجلات المحذوفة حذفًا غير نهائي

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

  السجلات المحذوفة حذفًا غير نهائي (مرئية ضمن Command Menu → See deleted records) مُدرجة ضمن فحوصات التفرّد. إذا قمت باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم **استعادة** السجل المحذوف مع البيانات الجديدة.
</Warning>

## اكتشاف التكرارات أثناء الاستيراد

أثناء مرحلة التحقق:

* يتم تمييز التكرارات داخل ملفك باللون الأصفر
* يمكنك تعديل الصفوف المكرّرة أو إزالتها من واجهة المستخدم قبل بدء الاستيراد

<VimeoEmbed videoId="1145246326" title="عرض توضيحي بالفيديو" />

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

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