개요
Twenty는 중복 레코드를 방지하고 데이터 무결성을 보장하기 위해 일부 필드에 고유성을 강제합니다. 이러한 제약 조건을 이해하는 것은 성공적인 가져오기에 필수적입니다.기본 고유 필드
| 객체 | 고유 필드 |
|---|---|
| 사람 | id, email |
| 회사 | id, domain |
| 사용자 지정 개체 | id만 (기본값) |
id 필드는 Twenty의 내부 식별자로, 각 레코드에 대해 자동 생성됩니다. UUID 형식을 사용합니다(예: c776ee49-f608-4a77-8cc8-6fe96ae1e43f).사용자 지정 고유 필드
설정 → 데이터 모델에서 추가 고유 필드를 정의할 수 있습니다:- 설정 → 데이터 모델로 이동
- 객체를 선택하세요
- 필드를 클릭하세요
- 필드 설정에서 Unique를 활성화하세요
사용자 지정 고유 필드의 활용 사례
- 외부 ID: 다른 시스템의 ID 저장(Salesforce ID, HubSpot ID)
- 비즈니스 식별자: 사번, 고객 코드
- 대체 연락처 정보: LinkedIn 프로필, 전화번호
필드 이름
id는 Twenty의 내부 ID로 예약되어 있습니다. 외부 식별자에는 externalId 또는 legacyId와 같은 다른 이름을 사용하세요.가져오기 동작 방식
새 레코드 생성
고유 필드 값이 존재하지 않으면 새 레코드가 생성됩니다.기존 레코드 업데이트
고유 필드 값이 기존 레코드와 일치하면 해당 레코드는 새 데이터로 업데이트됩니다.소프트 삭제된 레코드
가져오기 중 중복 감지
유효성 검사 단계에서:- 파일 내 중복 항목은 노란색으로 강조 표시됩니다
- 가져오기를 시작하기 전에 UI에서 중복 행을 편집하거나 제거할 수 있습니다
모범 사례
- 가져오기 전에 파일에서 중복 항목을 제거하세요
- 가져오기 전에 Twenty에서 기존 레코드가 있는지 확인하세요
- 다른 시스템에서 마이그레이션할 때 외부 ID를 사용하세요
- 기존 레코드를 업데이트하려면 고유 필드를 포함하세요