---
title: قيود التفرّد
description: كيف يفرض Twenty تفرد البيانات أثناء الاستيراد.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

## نظرة عامة

يفرض 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. **ضمّن الحقول الفريدة** إذا كنت تريد تحديث السجلات الموجودة