메인 콘텐츠로 건너뛰기

​
개요

여러 레코드를 한 번에 업데이트해야 하나요? 하나씩 편집하는 대신 CSV 가져오기를 사용해 기존 레코드를 일괄 업데이트하세요. 사용 사례:
  • 여러 사람의 직함 업데이트
  • 회사 정보를 일괄 변경
  • 새 사용자 지정 필드에 데이터 추가
  • 여러 레코드의 데이터 오류 수정

​
작동 방식

기존 레코드와 일치하는 고유 식별자가 포함된 파일을 가져오면, Twenty는 중복을 생성하는 대신 해당 레코드를 업데이트합니다.
고유 식별자가…Twenty가…
기존 레코드와 일치함업데이트 기존 레코드
어떤 레코드와도 일치하지 않음생성 새 레코드
파일에 없음생성 새 레코드(자동 생성된 ID 포함)
다중 선택 필드는 병합되지 않고 덮어써집니다.레코드에 Option A와 Option B가 선택되어 있고 [\"Option C\"]를 가져오면, 가져온 후 해당 레코드에는 Option C만 남습니다. 가져오면 이전 선택 항목이 모두 대체됩니다 — 기존 선택에 추가되지 않습니다.기존 값을 유지하려면 가져오기에 모두 포함하세요: [\"Option A\",\"Option B\",\"Option C\"]

​
1단계: 현재 데이터 내보내기

먼저, 업데이트하려는 레코드를 내보내세요:
  1. 해당 객체(사람, 회사 등)로 이동합니다.
  2. 필요한 열을 추가 — 업데이트하려는 필드를 표시하려면 옵션 → 필드를 클릭하세요
  3. 필요하다면 필터링 — 업데이트하려는 레코드만으로 범위를 좁히세요
  4. ⋮ → 뷰 내보내기를 클릭
  5. CSV 파일을 저장하세요
먼저 내보내는 이유? 내보낸 파일은 올바른 형식을 갖추고 고유 식별자를 포함하며, 가져오는 동안 자동으로 매핑됩니다.

​
내보내지는 내용

  • 현재 보기에서 표시되는 모든 열
  • 레코드의 고유 식별자(id, email, domain)
  • 수정할 수 있는 현재 필드 값

​
2단계: CSV 파일 편집

내보낸 파일을 스프레드시트 애플리케이션(Excel, Google Sheets 등)에서 여세요:
  1. 고유 식별자 열을 유지 — id, email, domain을 삭제하지 마세요
  2. 변경하려는 열의 값을 업데이트하세요
  3. 업데이트할 필요가 없는 열은 제거하세요 (선택 사항이지만 더 깔끔합니다)
  4. 고유 식별자 값을 변경하지 마세요 — 그렇지 않으면 Twenty가 새 레코드를 생성합니다

​
예시: 직함 업데이트

내보낸 파일: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
편집 후: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
고유 식별자 값을 변경하지 마세요.john@acme.com을 john.smith@acme.com으로 변경하면 Twenty는 기존 레코드를 업데이트하는 대신 새 레코드를 생성합니다.

​
3단계: 업데이트된 파일 가져오기

  1. 객체로 이동
  2. ⋮ → 레코드 가져오기를 클릭
  3. 편집한 CSV 파일을 업로드하세요
  4. 고유 식별자가 매핑되었는지 확인 — email, domain, id가 올바르게 매핑되었는지 검증하세요
  5. 필드 매핑을 검토하세요
  6. 오류가 있는지 확인하세요
  7. 확인을 클릭
Twenty는 고유 식별자로 레코드를 매칭하여 새 값으로 업데이트합니다.

​
적합한 고유 식별자 선택

객체권장대안노트
사람들이메일id이메일은 사람이 읽기 쉬움
회사도메인id도메인은 사람이 읽기 쉬움
사용자 지정 개체임의의 고유 필드id사용자 지정 고유 필드를 사용하세요
하나의 고유 식별자만 사용하세요. email과 id를 둘 다 매핑하지 마세요. 이로 인해 혼란과 오류가 발생할 수 있습니다.

​
사용자 지정 고유 필드 사용

고유로 표시된 사용자 지정 필드(다른 시스템의 외부 ID 등)가 있는 경우:
  1. 내보내기와 가져오기에 해당 필드를 포함하세요
  2. 가져올 때 해당 필드를 매핑하세요
  3. Twenty가 해당 필드로 매칭합니다

​
4단계: 업데이트 확인

가져온 후:
  1. 업데이트된 레코드 몇 개를 열어보세요
  2. 변경 사항이 적용되었는지 확인하세요
  3. 중복 레코드가 생성되지 않았는지 확인하세요

​
파일에 없는 필드는 어떻게 되나요?

가져오기 파일에 포함되지 않은 필드는 변경되지 않습니다.
파일에 포함된 항목…결과
email, jobTitlejobTitle만 업데이트되며, 다른 필드는 그대로 유지됩니다
email, jobTitle, phonejobTitle과 phone이 업데이트됩니다
즉, 변경하려는 필드(및 고유 식별자)만 포함하면 됩니다.

​
업데이트와 새 레코드 조합

하나의 가져오기에서 기존 레코드를 업데이트하고 새 레코드를 생성할 수 있습니다: 
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)

​
피해야 할 일반적인 실수

실수문제결과해결책
고유 식별자 변경john@acme.com을 john.smith@acme.com으로 변경함업데이트 대신 새 레코드를 생성함고유 식별자를 변경하지 마세요
여러 개의 고유 필드email과 id를 모두 매핑함매칭 충돌 가능성고유 식별자를 하나만 매핑하세요
고유 식별자 없음파일에 firstName, lastName, jobTitle만 있음모든 행이 새 레코드를 생성함항상 email, domain, id를 포함하세요
대소문자 불일치파일에는 John@acme.com이 있지만 Twenty에는 john@acme.com이 있음새 레코드 생성정확한 값을 얻으려면 Twenty에서 내보내세요

​
FAQ

고유 식별자가 기존 레코드와 일치하지 않는 레코드는 새 레코드로 생성됩니다. 이렇게 하면 하나의 가져오기에서 업데이트와 생성을 함께 수행할 수 있습니다.
예, CSV에서 해당 셀을 비워두세요. 가져오면 기존 레코드의 해당 필드 값이 비워집니다.
가져오기 파일에 없는 필드는 기존 레코드에서 변경되지 않습니다. 포함한 필드만 업데이트됩니다.
예! 관계의 고유 식별자(예: companyDomain)를 포함하고 관계 필드에 매핑하세요. 관계가 업데이트됩니다.
가져오기 검토 단계에서 Twenty가 고유 식별자 일치 여부를 기준으로 업데이트될 레코드와 생성될 레코드 수를 보여줍니다.
자동 실행 취소 기능은 없습니다. 대량 업데이트 전에 데이터를 백업용으로 내보내는 것을 권장합니다.

​
모범 사례

  1. 먼저 내보내기 — 올바른 형식을 보장하려면 항상 내보내기에서 시작하세요
  2. 업데이트 전에 백업 — 대량 변경 전에 데이터를 내보내세요
  3. 일부 레코드로 테스트 — 대량 작업 전에 먼저 5~10개의 레코드를 업데이트해 보세요
  4. 사람이 읽기 쉬운 식별자 사용 — email과 domain이 id보다 확인하기 더 쉽습니다
  5. 필요한 열만 포함 — 열이 적을수록 오류 가능성이 줄어듭니다

​
문제 해결

문제가 있으신가요? 확인하세요: