Обзор
Twenty обеспечивает уникальность для определённых полей, чтобы предотвратить дублирование записей и обеспечить целостность данных. Понимание этих ограничений важно для успешного импорта.Уникальные поля по умолчанию
| Объект | Уникальные поля |
|---|---|
| Люди | id, email |
| Компании | id, domain |
| Пользовательские объекты | Только id (по умолчанию) |
Поле
id — внутренний идентификатор Twenty, автоматически создаётся для каждой записи. Используется формат UUID (например, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).Пользовательские уникальные поля
Вы можете задать дополнительные уникальные поля в разделе Настройки → Модель данных:- Перейдите в Настройки → Модель данных
- Выберите объект
- Нажмите на поле
- Включите Уникальность в настройках поля
Сценарии использования пользовательских уникальных полей
- Внешние идентификаторы: храните идентификаторы из других систем (Salesforce ID, HubSpot ID)
- Бизнес-идентификаторы: номера сотрудников, коды клиентов
- Альтернативные контактные данные: профиль LinkedIn, номер телефона
Имя поля
id зарезервировано для внутреннего идентификатора Twenty. Для внешних идентификаторов используйте другое имя, например externalId или legacyId.Поведение при импорте
Создание новых записей
Если значение уникального поля отсутствует, создаётся новая запись.Обновление существующих записей
Если значение уникального поля совпадает с существующей записью, эта запись будет обновлена новыми данными.Записи, помеченные как удалённые
Обнаружение дубликатов при импорте
На этапе проверки:- Дубликаты в вашем файле подсвечиваются жёлтым
- Вы можете отредактировать или удалить строки-дубликаты в интерфейсе перед началом импорта
Лучшие практики
- Удалите дубликаты из файла перед импортом
- Проверьте наличие существующих записей в Twenty перед импортом
- Используйте внешние идентификаторы при миграции из других систем
- Указывайте уникальные поля, если хотите обновлять существующие записи