github-actions[bot]
001c2097a3
Created by Github action <!-- mintlify-editor-comments:start --> Mintlify --- 0 threads from 0 users in Mintlify - No unresolved comments <!-- mintlify-editor-comments:end --> <!-- mintlify-comment--> <a href="https://dashboard.mintlify.com/twenty/twenty/editor/i18n-docs?source=pr_comment" target="_blank" rel="noopener noreferrer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-light.svg"><img src="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-light.svg" alt="Open in Mintlify Editor"></picture></a> <!-- /mintlify-comment --> Co-authored-by: github-actions <github-actions@twenty.com>
73 lines
4.8 KiB
Plaintext
73 lines
4.8 KiB
Plaintext
---
|
|
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>
|
|
**Записи, помеченные как удалённые, учитываются при проверке уникальности.**
|
|
|
|
Записи, помеченные как удалённые (видны в Командном меню → Показать удалённые записи), учитываются при проверке уникальности. Если вы импортируете запись с тем же уникальным значением, что и у удалённой записи, удалённая запись будет **восстановлена** с новыми данными.
|
|
</Warning>
|
|
|
|
## Обнаружение дубликатов при импорте
|
|
|
|
На этапе проверки:
|
|
|
|
* Дубликаты в вашем файле подсвечиваются жёлтым
|
|
* Вы можете отредактировать или удалить строки-дубликаты в интерфейсе перед началом импорта
|
|
|
|
<VimeoEmbed videoId="1145246326" title="Видеодемонстрация" />
|
|
|
|
## Лучшие практики
|
|
|
|
1. **Удалите дубликаты** из файла перед импортом
|
|
2. **Проверьте наличие существующих записей** в Twenty перед импортом
|
|
3. **Используйте внешние идентификаторы** при миграции из других систем
|
|
4. **Указывайте уникальные поля**, если хотите обновлять существующие записи
|