에러 타입
에러 원인
해결 방법
Ambiguous enumeration option
동일한 레코드가 열거형 속성에 대해 정의된 기존 옵션 중 두 개 이상과 일치하여 발생합니다. (다중 선택, 드롭다운 선택, 라디오 선택 및 체크박스 유형의 속성에 해당) 이 오류는 레이블이 내부 값과 다른 열거형 속성 옵션에 적용됩니다. 이 경우 에러가 발생한 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다.
임포트 파일의 값을 기존 속성 옵션 중 하나만 일치하도록 업데이트한 뒤 다시 임포트합니다.레코드가 여러 옵션과 일치해야 하는 경우, 맵핑한 허브스팟 속성을 Multiple checkboxes로 변경하여야 합니다.
Association label not found
허브스팟에 존재하지 않는 Association Label 열을 포함한 파일 임포트 시 발생합니다.
파일 내의 값들이 기존에 존재하는 Label과 일치하는지 확인하고, 없을 시 신규 생성 후 다시 임포트합니다. 만약 페어(pair)로 구성된 라벨을 임포트한다면(예, 컴퍼니에 적용된 고용인과 컨택에 적용된 직원) 알맞은 개체를 선택하도록 주의하세요.
Association limits exceeded
설정해 둔 레코드 간의 레이블된 연계(association) 수 혹은 레이블된(Labelled) 수 제한을 넘어서는 데이터를 임포트하여 발생합니다. 이 경우 에러가 발생한 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다.
레코드에 꼭 연계가 필요하거나 특정 연계 레이블이 필요하다면 관련 제한 설정을 변경하고 다시 임포트합니다.
Association record not found
임포트 중에 고유 식별 속성에 매핑된 레코드 (예, 레코드 ID, 이메일, 회사 도메인 이름 등)을 연결했으나, 필수 고유 값이 미포함된 경우나, 줄 바꿈이나 100자를 초과하는 값이 고유 식별 속성에 맵핑된 경우 발생합니다. 이 경우 임포트는 되지만 레코드와 연계되지는 않습니다.
에러의 원인이 되는 값을 파일에서 수정한 후 다시 임포트합니다. 올바른 레코드 ID를 알아야 하는 경우 앞서 임포트한 레코드를 다시 내보내기(export)하는 방법이 있습니다.
Could not find owner
임포트 파일의 오너 정보를 허브스팟에서 찾을 수 없어 발생합니다. 이 경우 Owner 속성 값을 제외하고 임포트됩니다.
레코드에 할당할 오너가 어카운트에 존재하는지, active상태가 맞는지 확인하고 파일에 정확한 이름 혹은 이메일을 입력하여 다시 임포트합니다.
Could not parse date
허브스팟이 인식할 수 없는 형식의 날짜 데이터가 포함되어 있어 있어 발생합니다. 이 경우 에러 발생 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다.
파일 내 에러 발생 열의 날짜 형식을 수정하고 다시 임포트합니다.
Could not parse number
허브스팟이 인식할 수 없는 형식의 숫자 데이터가 포함되어 있어 발생합니다. 이 경우 에러 발생 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다.
파일 내 에러 발생 열의 숫자 형식을 수정하고 다시 임포트합니다.
Could not parse row
임포트를 수행할 수 없는 행이 포함되어 있어 발생합니다. 이 경우 에러 발생 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다. 필수 속성과 맵핑된 경우에는 레코드가 생성되지 않습니다.
파일 내 에러 발생 행을 수정하고 다시 임포트합니다.
Could not parse term
허브스팟이 인식할 수 없는 형태의 날짜 데이터가 포함되어 있어 발생합니다. 이 경우 에러 발생 데이터와 맵핑된 속성 값을 제외하고 임포트됩니다.
파일의 기간 값을 설정에서 지정한 어카운트의 날짜 표기 형식에 맞춰 업데이트하거나, ISO8601 기간 형식(예: 3년 6개월 4일의 기간은 P3Y6M4D)으로 업데이트한 다음 다시 임포트합니다. 영향을 받는 레코드의 속성 값에 대하여 수동 업데이트도 가능합니다.
Create only import
임포트 방식을 ‘새로운 레코드 생성만’(create only new record) 가능하도록 선택하였으나 기존 데이터와 일치하는 고유 식별 값이 데이터에 포함된 경우 발생합니다. (예, 레코드 신규 생성을 위해 임포트 하는 파일의 이메일 열 중 이미 기존 컨택 레코드의 이메일 주소가 포함된 경우.) 이 경우 에러의 원인이 되는 행을 제외하고 임포트가 진행되며, 기존 레코드에도 업데이트가 발생하지 않습니다.
기존 레코드에 업데이트를 피하면서, 새로운 레코드만 생성하는 것이 목적이었다면 아무런 조치를 취하지 않아도 되지만, 매칭되는 기존 데이터에도 업데이트하는 것이 목적이라면 임포트 방식을 ‘새로운 레코드의 경우 신규 생성하고, 기존 레코드에는 업데이트’(Create and update)로 변경하여 다시 임포트를 진행합니다.
Duplicate alternate ID
동일한 alternate ID(레코드 고유 식별 값)가 파일들 내에 복수로 존재하는 경우 발생합니다. 이 경우 임포트가 수행되나, 중복 레코드가 생성될 수 있습니다.
alternate ID 역할을 할 열의 첫 행을 변경하고 다시 임포트합니다. 중복을 피하기 위해서는 Contact 개체는 이메일, Company 개체는 도메인, 그 외 개체는 레코드 ID를 사용하는 것이 좋습니다. 만약 복수의 회사가 같은 도메인을 사용하는 경우에는 companies의 parent & child를 생성하여 관리하는 방법도 있습니다.
Duplicate association ID
레코드에 연계하기 위해 선택한 연계 ID가 고유한 값이 아닌 경우 발생합니다.
두 파일 사이의 공통 열 역할을 할 다른 열을 선택하여 다시 임포트합니다. ‘다수의 연락처-하나의 회사’와 같이 하나의 값이 연계된 여러 레코드의 고유 값인 1대 다 속성을 선택하는 것이 좋습니다.
Duplicate record ID
임포트 파일들 내에 동일한 레코드 ID가 중복되어 발생합니다. 이 경우 에러 원인이 되는 데이터를 제외한 레코드가 업데이트 됩니다.
모든 행의 데이터가 고유한 레코드ID를 가질 수 있도록 우선 파일을 임포트 한 후, 허브스팟에 업로드할 가장 최신의 정보를 가진 열만 남기고 나머지 중복된 열은 삭제한 뒤 다시 임포트합니다.
Duplicate row content
허브스팟이 임포트 파일내에 중복된 레코드를 감지했을 때 발생합니다. 이 경우 신규 레코드를 생성하지 않고 임포트 됩니다.
중복을 삭제하고 다시 임포트합니다.
Duplicate unique property value
허브스팟의 고유 식별 속성은 모든 레코드에 걸쳐 유일한 값을 갖도록 하기 때문에, 임포트 파일의 특정 열과 맵핑된 고유 식별 속성이 파일 내 다른 행의 데이터나 CRM 내 레코드와 비교했을 때 유일하지 않을 경우 에러가 발생합니다. 이 경우 속성에서 참조하는 하나의 행만 임포트되고, 속성 값이 CRM의 다른 레코드와 충돌하는 경우 해당 레코드를 임포트하지 않습니다.
고유 값으로 사용할 다른 열을 선택하거나 중복된 값을 제거한 다음 파일을 다시 임포트합니다.
파일에 여러 개의 고유 식별 속성이 포함된 경우에는 이렇게 하세요:
- 고유 식별 값 충돌 (예: 커스텀 속성과에 입력된 이메일 주소와 동일한 값이 이메일 속성에 중복되어 존재) 시, 충돌하는 값을 하나 삭제하고 다시 임포트.
- 고유 식별 값 속성 중 하나를 업데이트하기 위해 임포트 하는 경우, 업데이트하지 않으려는 속성을 기존 [개체]를 찾는 데 사용할 속성으로 선택
고유 식별 값으로 레코드ID를 사용하는 경우, 임포트에 포함된 다른 모든 고유 식별자를 대체합니다. Contact 개체의 이메일 속성은 항상 고유한 값이 필요합니다.
Failed to create association
HubSpot이 현재 형식으로 레코드를 연결할 수 없을 때 발생합니다. 이 경우 임포트는 진행되지만 연계는 수행되지 않습니다.
레코드 연계를 위한 파일 세팅 조건을 모두 충족했는지 확인합니다. 하나의 파일로 임포트 하는 경우, 각 개체에 대한 고유 식별 값이 필요합니다. 두 개의 파일로 업로드 하는 경우 제대로 연계 작업을 하기 위해서는 다른 공통된 열을 지정해야할 수 있습니다. 파일을 수정한 후 다시 임포트를 진행하거나 수동으로 레코드를 연계시킵니다.
Failed to opt out contact
opt-out 파일의 특정 컨택을 opt-out 처리할 수 없을 때 발생합니다.
opt-out 리스트에 있는 모든 컨택 행이 이메일 주소를 가지고 있는지 확인합니다. 만약 이메일 주소가 빠져 있다면 파일에 이메일 주소를 채워넣거나, 수동으로 컨택 레코드를 생성하고 opt-out 처리합니다.
Failed to process object with empty property values
파일의 여러 열이 빈칸으로 되어 있어 허브스팟이 레코드를 처리할 수 없을 때 발생합니다. 이 경우 해당 행은 임포트되지 않습니다.
파일의 비어 있는 속성 값을 점검한 뒤 다시 임포트합니다.
Failed validation of Email, Deal/Ticket Stage, or Deal/Ticket pipeline
파일 내 이메일 값이 일반적인 이메일 형태(예, abc@mzc.com)를 따르지 않거나, Deal Stage, Deal Pipeline, Ticket Status, Ticket Pipeline 속성이 허브스팟에 존재하는 stage, status 혹은 pipeline 이름과 매칭이 불가능한 경우 발생합니다. 이 경우 레코드 생성 및 업데이트가 진행되지 않습니다.
Contact 개체의 경우 파일의 이메일 주소를 수정하고 다시 임포트합니다.
Deal과 Ticket 개체의 경우, 각각의 stage, status, pipeline name을 기존에 허브스팟에서 설정한 내용에 맞게 수정하거나, 커스텀 deal stage, ticket status를 허브스팟에 추가한 뒤 다시 임포트합니다.
File not found
선택한 파일이 임포트되지 않았을 때 발생합니다.
파일이 PC에 제대로 저장되어 있는지 확인하고 파일 유형을 체크한 뒤 다시 파일을 업로드 합니다.
GDPR blocklisted email
임포트 파일 내의 이메일 주소가 개인정보 정책에 의해 차단되었을 때 발생합니다. 이 경우 해당 컨택의 데이터를 제외하고 임포트됩니다.
임포트로는 차단된 컨택의 정보를 올릴 수 없습니다. 영구 제거된 컨택을 다시 CRM에 넣으려면 해당 컨택이 직접 양식을 제출해야하며, 신규 레코드로 생성됩니다.
Incorrect number of columns
파일에 최소 하나라도 헤더인 첫 행이 없이 임포트될 경우 발생합니다. 첫 행이 비어있는 열의 내용을 제외하고 임포트됩니다.
원인이 되는 파일 열의 데이터가 임포트가 필요한 열인지 확인하고, 필요한 경우 첫 행에 내용을 입력하고, 불필요한 경우 해당 열을 삭제한 뒤 다시 임포트합니다.
Invalid additional email
추가 이메일 주소(additional emails)를 포함하여 컨택을 임포팅할 경우, 파일의 이메일 주소가 유하지 않은 형식이거나, 이미 다른 컨택의 이메일 주소로 저장되어 있을 때 발생합니다. 이 경우 추가 이메일 주소를 제외하고 임포트됩니다.
만약 이메일 형식이 잘못되었다면 이를 수정하고 다시 임포트합니다.이미 다른 컨택에 저장된 이메일 주소이나 임포트하는 컨택에게 이 이메일 주소를 저장해야 하는 경우에는 기존에 이메일 주소를 가지고 있던 컨택에게서 해당 주소를 삭제한 뒤 다시 임포트 합니다.
만약 이미 다른 컨택에 저장된 이메일 주소를 그대로 둘 것이라면 아무런 조치를 취하지 않아도 됩니다.
Invalid alternate ID
허브스팟에서 유효하지 않은 고유 식별 값(이메일 주소, 도메인 이름, 레코드 ID)이 포함되어 있을 때 발생합니다. 이 경우 레코드를 생성하거나 업데이트하지 않습니다.
이메일 주소, 도메인 이름, 레코드 ID 등 고유 식별 값을 알맞게 수정한 후 다시 임포트 합니다.
Invalid association identifier
레코드 연계를 위해 필요한 적합한 고유 식별 값이 임포트 파일에 존재하지 않아 발생합니다. 고유하지 않은 속성 값을 사용했거나, 고유 식별 값에 줄 바꿈 또는 100자를 초과하는 값이 포함된 경우에도 발생할 수 있습니다. 이 경우 연계 작업은 수행하지 않은 채 데이터 임포트가 진행 됩니다.
연계를 위해 필요한 유효한 고유 식별 값을 임포트 파일에 입력하고, 다시 임포트합니다.
Invalid enumeration option
임포트 파일에 열거형 속성의 옵션에 포함되지 않는 값이 포함되어 있는 경우 발생합니다. multi-select, dropdown, radio select, and checkbox type properties 속성이 이에 해당합니다. 이 경우 에러의 원인이 되는 값을 제외하고 임포트됩니다.
열거형 속성의 옵션에 맞지않는 값들을 확인하여 수정하거나, 해당 속성의 옵션값을 임포트 파일 내용에 맞춰 업데이트한 뒤 다시 임포트합니다.
Invalid event
Custom event나 Marketing event를 임포트할 때, 임포트 파일에 유효하지 않은 이벤트(예, 시작시간이 종료시간보다 늦은 이벤트)가 포함되어 있으면 발생합니다. 이 경우 에러의 원인이 되는 행은 임포트되지 않습니다.
event 속성의 유효하지 않은 값을 수정한 뒤 다시 임포트합니다.
Invalid event timestamp
Custom Event를 임포트할 때, Occured at 속성이 비어있거나 유효하지 않은 타임스탬프가 포함된 경우 발생합니다. 이 경우 에러의 원인이 되는 열을 제외하고 임포트 됩니다.
허용된 타임스탬프 범위 내의(2000-01-01 ~ 3000-01-01) 값으로 수정한 뒤 다시 임포트합니다.
Invalid file type
임포트 파일이 허브스팟에서 지원하지 않는 형식일 경우 발생하며, 이 경우 데이터가 임포트되지 않습니다.
파일을 .csv, .xls, .xlsx중 하나의 형식으로 변환한 뒤 다시 임포트합니다.
Invalid number size
임포트 파일에 너무 작거나 너무 큰 숫자 값이 포함된 경우 발생합니다. 이 경우 에러의 원인이 되는 값만 제외하고 임포트됩니다.
특정 속성 또는 속성 유형의 형식 요구 사항을 확인하여 알맞은 형식으로 수정한 뒤 다시 임포트 합니다. 에러로 인해 임포트 되지 않은 값만 수동으로 업데이트할 수도 있습니다.
Invalid record ID
임포트 파일의 열 중 하나가 레코드 ID와 맵핑되었으나 일치하는 레코드 ID가 없는 경우 발생합니다. 이 경우 에러 원인이 되는 레코드는 임포트되지 않습니다.
레코드 ID가 정확한지 확인합니다. 필요하다면 기존의 레코드를 내보내기(export)하여 정확한 레코드 ID를 얻을 수 있습니다.
레코드 업데이트나 연계 목적의 경우를 제외하고, 임포트 과정 중 Different unique identifier for existing records를 선택하여 임포트할 수 있습니다.
Invalid required property
임포트 파일 중 필수 속성에 유효하지 않은 값이 들어있는 경우 발생합니다. 이 경우 원인이 된 행의 데이터는 임포트 되지 않습니다.
속성 유형의 형식 요구 사항을 확인하고 올바른 형식에 맞게 파일을 업데이트한 뒤 다시 임포트합니다.
Invalid sheet count
임포트 파일의 시트가 2개 이상일 경우 발생하며, 데이터가 임포트되지 않습니다.
시트를 한 개만 남기고 정리한뒤 다시 임포트합니다.
Invalid spreadsheet
임포트 파일이 유효한 스프레드시트가 아닐 경우 발생하며, 데이터 임포트되지 않습니다.
파일을 .csv, .xls, .xlsx중 하나의 형식으로 변환한 뒤 다시 임포트합니다.
Limit exceeded
해당 개체에 저장할 수 있는 레코드 수 제한을 넘겨버린 경우 허브스팟이 더 이상 레코드를 생성할 수 없어 발생합니다. 이 에러는 스탠다드 개체인 Contacts, Companies, Deals, Tickets에 해당되며, 이 경우 데이터가 임포트되지 않습니다.
더 이상 필요하지 않은 레코드는 삭제하여 정리하고, 다시 파일을 임포트하여 레코드를 생성합니다.
Many errors in row
임포트 파일의 한 행에서 10개 이상의 에러가 있을 경우 발생합니다. 에러 메시지에는 해당 행의 모든 에러와 영향을 받는 열을 리스트로 보여줍니다. 에러가 무엇인지에 따라 임포트 여부는 달라질 수 있습니다.
각 에러를 확인하고 에러 내용에 맞춰 파일을 수정한 뒤 다시 임포트합니다.
Multiple companies with this domain
파일에 존재하는 Company domain name 값이 어카운트 내 두 개 이상의 company와 매칭될 때 발생합니다. 이 경우 company 레코드는 임포트되지 않습니다.
중복된 Company domain name 값을 company 메인 페이지에서 검색해 어떤 도메인이 중복되는지 찾습니다. 발견한 Company 레코드를 머지하거나 둘 중 하나를 삭제하고 다시 임포트 합니다.
Multiple owners found
파일에 존재하는 Owner 값이 어카운트 내 유저 두 명 이상과 매칭될 때 발생하며, 일반적으로 이름이 원인이 되는 경우가 많습니다. 이 경우 에러가 발생한 레코드의 Owner 속성 값을 제외하고 임포트됩니다.
오너의 이름을 이메일 주소로 대체하고 다시 임포트합니다.
Outside valid term range
임포트 파일에 허용된 기간 범위를 벗어난 기간 값이 포함되어 있을 때 발생합니다. 이 경우 기간 속성 값을 제외하고 임포트됩니다.
파일의 기간 값을 허용된 범위(1개월 이상의 정수) 내로 업데이트한 후, 파일을 다시 임포트하거나, 에러가 발생한 레코드의 속성을 수동으로 업데이트합니다.
Outside valid time range
임포트 파일에 허용된 시간 범위를 벗어난 시간 값이 포함되어 있을 때 발생합니다. 이 경우 시간 속성 값을 제외하고 임포트됩니다.
파일의 시간 범위 값을 허용된 범위 내(1000년 미만)로 업데이트한 후 다시 파일을 임포트하거나 에러가 발생한 레코드의 속성을 수동으로 업데이트합니다.
Portal Wide Custom Object Limit Exceeded
커스텀 개체에 저장할 수 있는 레코드 수 제한을 초과한 경우 발생합니다. 이 경우 데이터가 임포트되지 않습니다.
더 이상 필요하지 않은 커스텀 개체의 레코드는 삭제하여 정리하고, 다시 파일을 임포트하여 레코드를 생성합니다. 추가 레코드 공간이 필요하다면 커스텀 개체의 레코드 한도를 늘리는 옵션을 구매할 수 있습니다.
Property definition not found
허브스팟 속성과 매칭되지 않는 파일의 첫 행(헤더)이 있는 경우 발생합니다. 이 경우 해당 열에 있는 데이터는 임포트되지 않습니다.
임포트 과정에서 기존 속성 중 알맞은 속성을 수기로 맵핑시키거나, 새로운 속성을 만들어 올바르게 맵핑합니다. 일치하지 않는 열은 임포트하지 않도록 건너뛸 수도 있습니다.
Property validation rule error
임포트 파일에 유효성 검사 조건에 충족하지 않는 값(예, 특수 문자가 포함된 값)이 포함되어 있는 경우 발생합니다. 이 경우 에러의 원인이 되는 값을 제외하고 임포트됩니다.
설정에서 해당 속성의 유효성 검사 규칙을 확인하고, 필요시 편집하세요. 속성의 규칙을 따르는 값으로 파일을 업데이트한 후 다시 임포트합니다.
Property value not found
필수 속성의 값이 파일 내에 존재하지 않을 경우 발생합니다. 이 경우 해당 행은 임포트되지 않습니다.
임포트 파일에 필수 속성 값을 업데이트한 뒤 다시 임포트합니다.
Row data too large
1MB를 넘는 행 혹은 셀이 존재할 경우 발생합니다. 이 경우 해당 행은 임포트되지 않습니다.
에러의 원인이 되는 행 혹은 셀의 사이즈를 줄인 뒤 다시 임포트합니다.
Unknown bad request
임포트 파일이 기존 레코드와 매치되지 않는 무효한 레코드 ID를 포함하고 있어 발생합니다. 어떤 레코드와도 매치할 수 없기 때문에 해당 레코드를 임포트하지 않습니다.
올바른 레코드 ID인지 확인하고, 파일 내 부정확한 레코드 ID를 업데이트한 뒤 다시 임포트합니다.
Unknown error
허브스팟이 알 수 없는 이유로 인해 파일의 데이터를 처리할 수 없는 경우 발생하며, 이 때 데이터는 임포트되지 않습니다.
파일이 임포트에 필요한
요구사항에 충족하는지 확인합니다. 브라우저의 캐시를 삭제하고 다시 임포트를 시도하거나, 다른 브라우저에서 시도합니다. 만약 에러가 지속적으로 발생한다면
커뮤니티나
서포트팀에 문의합니다.
Update only import
임포트 방식을 기존 데이터에 대한 업데이트만 수행하도록 only update existing record로 선택하였으나, 기존 레코드에 상응하는 고유 식별 값이 없는 경우에 발생합니다. (예, 기존 컨택의 이메일 주소와 일치하지 않는 이메일 값을 임포트)
에러의 원인이 되는 열은 임포트되지 않으므로 신규 레코드로도 생성되지도 않습니다.
만약 일치하는 레코드가 분명히 있음에도 이 에러가 발생했다면, 해당되는 고유 식별 값에 오탈자가 없는지 다시 한번 확인하고 업데이트한 뒤, 다시 임포트합니다.
임포트 목적이 기존 레코드에 대한 업데이트만이라면, 아무런 조치를 취하지 않아도 괜찮지만, 임포트 목적에 신규 레코드 생성도 포함된다면 임포트 방식을
create new records and update existing records로 변경한 뒤 다시 임포트합니다.
.png)
.png)
