Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
개요
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를 사용하세요
- 기존 레코드를 업데이트하려면 고유 필드를 포함하세요