CSV 파일 준비

​

개요

​

1단계: 파일 요구 사항 확인

​

2단계: 샘플 파일 다운로드

1. 오브젝트 보기(사람들, 회사 등)로 이동하세요.
2. ⋮ → 레코드 가져오기를 클릭하세요
3. 샘플 파일 다운로드를 클릭하세요
4. 이 파일을 템플릿으로 사용하세요

​

3단계: 중복 값 제거

1. 스프레드시트를 고유 필드(이메일 또는 도메인)로 정렬하세요
2. 중복 행을 제거하거나 병합하세요
3. Twenty에 이미 존재하는 중복 항목이 있는지 확인하세요

​

4단계: 각 필드 유형을 올바르게 형식 지정하기

​

텍스트 필드

• 특별한 형식 지정이 필요 없습니다
• 앞/뒤 공백은 자동으로 제거됩니다

​

이메일 필드

• 유효한 이메일 형식이어야 합니다: name@domain.com
• 고유해야 합니다(파일 또는 Twenty에 중복이 없어야 함)
• 추가 이메일의 경우 Emails / Additional Emails 열에서 다음 형식을 사용하세요:

["jane@twenty.com","jane.doe@twenty.com"]

​

도메인 필드

• 권장 형식: https://domain.com
• 이는 메일박스/캘린더 동기화에서 사용하는 형식과 일치하며 중복을 방지합니다
• 두 열을 모두 채우세요:
  • Domain / Domain Label: domain.com
  • Domain / Domain URL: https://domain.com
• 파일 내 및 Twenty에서 고유해야 합니다

​

전화번호 필드

​

주소 필드

• Address / Address 1: 주소 1행
• Address / Address 2: 주소 2행(선택 사항)
• Address / City: 도시 이름
• Address / State: 주 또는 도
• Address / Country: 국가 이름
• Address / Post Code: 우편번호/ZIP 코드

​

날짜 필드

• YYYY-MM-DD (권장): 2024-03-15
• ISO 8601: 2024-03-15T10:30:00Z

​

숫자 필드

• 숫자만 사용(텍스트 금지)
• 소수점 구분 기호로 점(.)을 사용: 1234.56
• 천 단위 구분 기호 사용 금지(1,234.56는 사용하지 마세요)

​

통화 필드

​

부울 필드

​

선택 필드

1. 설정 → 데이터 모델로 이동
2. 객체와 필드를 선택하세요
3. 고급 모드를 활성화하세요(오른쪽 하단 토글)
4. API 이름을 복사하세요(예: OPTION_1, “Option 1” 아님)

​

다중 선택 필드

["VALUE1","VALUE2"]

​

배열 필드

["value1","value2"]

​

평점 필드

​

링크/URL 필드

• Links / Link Label: Twenty
• Links / Link URL: https://twenty.com

[{"url":"https://twenty.com","label":"Twenty"}]

​

JSON 필드

{"key":"value","key2":"value2"}

​

ID 필드

• 선택 사항: 제공하지 않으면 Twenty가 ID를 자동 생성합니다
• 형식: UUID(예: c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
• 사용 사례: 새로 생성하는 대신 기존 레코드를 업데이트하려면 ID를 포함하세요

​

5단계: 관계 열 추가(레코드를 연결하는 경우)

firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co

• 상위 레코드는 Twenty에 이미 존재해야 합니다
• 라벨이 아니라 도메인 URL 형식(https://domain.com)을 사용하세요
• 고유 식별자는 하나만 매핑하세요(companyId와 companyDomain을 모두 포함하지 마세요)
• 워크스페이스 구성원은 이름이 아닌 이메일을 사용하세요

​

6단계: Twenty에 필드가 존재하는지 확인

1. 설정 → 데이터 모델로 이동
2. 객체를 선택하세요
3. 필요한 사용자 정의 필드를 생성하세요
4. 필드 이름을 정확히 확인하세요(열 제목과 일치해야 합니다)

​

7단계: 최종 체크리스트

​

피해야 할 일반적인 실수

​

다음 단계

• 회사 가져오기 (먼저 가져오세요)
• 연락처 가져오기
• 가져오기 오류 수정