查看並排除匯入錯誤
上次更新時間: 九月 27, 2023
將記錄或活動匯入HubSpot時,您可能會遇到錯誤。以下是如何解決在匯入時檢測到的錯誤、下載錯誤檔案、檢視錯誤詳情以及更正匯入檔案或Salesforce中的問題。
在開始匯入或修復有錯誤的檔案之前,請瞭解有關匯入HubSpot的條款和要求。
修復匯入過程中的錯誤
在完成匯入之前, HubSpot會檢查檔案前100行中的某些錯誤。如果偵測到以下任何錯誤,則會在匯入過程中映射屬性時,引起你的注意:
要解決這些錯誤,請按照以下步驟,從檔案中的「映射」列到「HubSpot屬性」畫面:
- 將遊標停留在exclamation 感嘆號圖示上,然後在彈出式方塊中按一下修復匯入錯誤。
- 在右側面板中,檢視有關錯誤類型的更多詳細資訊,包括哪些欄和行受到影響。
- 若要檢視檔案中受影響的行,請按一下「檢視有錯誤的值」。
- 如果有建議的解決方案,則會顯示「修復此錯誤」部分。檢視建議的解決方案,然後根據錯誤選擇一個選項:
-
- 點擊編輯[name]屬性。屬性編輯器會出現在右側面板中。根據建議更新旅居,然後按一下儲存。
- 如果屬性是只讀的(例如,某些預設的HubSpot屬性) ,您可以按一下檢視[name]屬性以查看屬性的詳細資料。無法編輯唯讀屬性,因此需要更新並重新匯入檔案以解決錯誤。
- 按一下下拉式選單以更新格式(例如日期格式)。
- 在「其他選項」部分:
- 按一下right展開並檢視每個附加選項。
- 若要查看對應的旅居的更多詳情,請點擊查看[NAME]旅居。
- 若要進一步了解特定錯誤,請點擊「進一步了解此錯誤」。
- 解決錯誤後,「已映射」欄中會有一個success勾選標記。
請注意:如果您的檔案包含超過100行,則可能會出現其他未解決的錯誤。
匯入後查看錯誤
完成匯入後,系統會自動帶你到匯入摘要,包括任何錯誤的概述。您也可以查看之前完成的匯入的摘要。
- 在「摘要」卡片上,查看已匯入的行數、新建的記錄以及已更新的現有記錄。了解更多有關分析匯入的資訊。
- 如果匯入有錯誤,則會顯示「匯入錯誤」部分。在表格中,查看以下信息:
- 若要檢視有關特定錯誤的詳細資訊,請將鼠標懸停在行上,然後按一下檢視詳情。
- 若要檢視所有含有錯誤的行,請按一下檢視含有錯誤的行。在「有錯誤的行」頁面上:
- 在表格中,查看行及其內含的錯誤。受錯誤影響的欄位將包含exclamation 警示圖示。按一下最左欄的錯誤名稱,即可查看錯誤的原因和解決方法。
- 按一下下載有錯誤的行作為檔案,下載受影響的行及其錯誤。按一下下載的zip檔案,提取CSV檔案,然後開啟檔案。
- 若要下載檔案中的錯誤清單,請在表格上方按一下下載錯誤作為檔案。
- 按一下下載的zip檔案,提取CSV檔案,然後開啟檔案。
- 在檔案中,在「錯誤代碼」列中識別錯誤代碼,在「物件類型」列中識別受影響的記錄對象,在「原因」列中識別錯誤原因,以及在其他列中識別記錄的屬性值。
顯示匯入錯誤後,請瞭解如何解決特定錯誤。
匯入檔案錯誤
以下是按字母排序的錯誤代碼清單,其中包含錯誤的詳細資料和可能的解決步驟。在某些情況下,有錯誤的記錄或活動會被匯入,並可以在HubSpot中進行更正,或者更正匯入檔案並重新匯入。在其他情況下,記錄或活動不會匯入,匯入檔案需要在重新匯入前更正。
請注意:下載檔案中的錯誤代碼將包含大寫字母和下劃線字符,但會列於本文的正常文字中。例如,錯誤會顯示為檔案中的Ambiguous_enumeration_OPTION ,但您會在下面的清單 中找到Ambiguous enumeration_option。
曖昧列數選項
錯誤的含義
相同的記錄與為枚舉屬性定義的多個現有選項匹配。這適用於多重選擇、下拉選擇、無線選擇和核取方塊類型屬性。
如果檔案中的值是屬性選項的標籤而不是其內部值,您也可能會看到此錯誤。這適用於標籤與內部值不同的枚舉屬性選項。
受影響的記錄已匯入,但枚舉屬性不包含值。
如何解決錯誤
通過將匯入檔案與HubSpot中的屬性進行比較來識別不正確的值。更新匯入檔案中的值以只匹配一個現有選項,或者如果標籤與其內部值不同,則更新選項的內部值。更新值後,重新匯入檔案。
您也可以手動更新受影響記錄中的屬性值。如果您的記錄應匹配多個選項,請了解如何格式化檔案以正確將資料匯入多個核取方塊屬性。
找不到關聯標籤
錯誤的含義
匯入期間,一欄包含關聯標籤,但該標籤在HubSpot中不存在。已匯入資料,但產生的關聯未標記。
如何解決錯誤
透過將匯入檔案與HubSpot中的關聯標籤進行比較,找出不正確的值。請確保您的值與現有標籤相符,或建立新標籤。完成後,請重新匯入檔案或手動更新受影響記錄中的標籤。
未找到關聯記錄
錯誤的含義
匯入期間,欄會對應到 唯一識別碼屬性以關聯記錄(即記錄ID、電子郵件、公司網域名稱或自訂唯一值屬性)。但是,所需的唯一值未包含在文件中。資料已匯入,但結果記錄並未在HubSpot中關聯。
如何解決錯誤
更新匯入檔案以包含正確的值,然後重新匯入檔案。您可能需要匯出現有記錄以獲得正確的記錄ID ,或為現有記錄使用不同的唯一識別碼。了解如何正確設定檔案以匯入和關聯多個物件。
找不到所有者
錯誤的含義
匯入檔案包含的記錄擁有者與HubSpot中的使用者不匹配。受影響的記錄已匯入,但「擁有者」欄位不包含值。
如何解決錯誤
確認您要指派紀錄的人員是帳戶中的活躍使用者,然後更新匯入檔案「擁有者」欄中的資料,以包含使用者的名字和姓氏或電子郵件。
- 如果要指派紀錄的人員還不是帳戶中的用戶,請將他們新增為用戶,然後重新匯入帳戶中出現的姓名或電子郵件。
- 如果您要指派的人員是已停用的使用者,請重新啟用該使用者,然後重新匯入其姓名或電子郵件,如其顯示在帳戶中。
無法解析日期
錯誤的含義
匯入檔案包含的日期值與您在匯入過程中選擇的格式不匹配。受影響的記錄已匯入,但date屬性不包含值。
如何解決錯誤
使用正確的值更新您的匯入檔案並重新匯入,或手動更新受影響記錄中的屬性值。
無法解析數字
錯誤的含義
匯入檔案包含具有非數字字元的數字屬性的值。受影響的記錄已匯入,但number屬性不包含值。
如何解決錯誤
使用正確的數值更新匯入檔案並重新匯入,或手動更新受影響記錄中的屬性值。
無法解析行
錯誤的含義
匯入檔案包含一行無法處理的資料。如果它是必需的屬性,則未匯入記錄。如果它不是必需的屬性,則記錄已匯入,但該屬性不包含值。
如何解決錯誤
確認您的資料值與您要匯入的屬性的正確格式相符,修復任何錯誤,然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。
無法解析術語
錯誤的含義
匯入檔案包含的時間段值與接受的術語格式不匹配。受影響的記錄仍被匯入,但條款屬性不包含值。
如何解決錯誤
將檔案中的條款值更新為整數個月或ISO8601持續時間格式(例如,三年,六個月,四天的時間為P3Y6M4D ) ,然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。
只建立import
錯誤的含義
您選擇了匯入僅應建立新記錄,但匯入檔案包含與HubSpot中現有記錄匹配的唯一識別碼值。例如,您匯入的電子郵件值已經與現有聯絡人的電子郵件相匹配。受影響的行未被匯入,因此現有記錄未被更新,但包含新資訊的行確實創建了新記錄。
如何解決錯誤
如果您的目標只是創建新記錄,並避免更新現有記錄,則無需採取任何操作。如果您確實想要更新檔案中的現有記錄,請重新匯入檔案,然後選擇在匯入過程中建立新記錄並更新現有記錄。
副本ID重復
錯誤的含義
相同的替代ID在您的文件中多次使用。您的資料已匯入,但HubSpot中可能有相同記錄的重複項目。如果您試圖關聯,則您的記錄沒有關聯。
如何解決錯誤
選擇不同的欄標題作為您的替代ID ,然後重新匯入文件。- 若要避免重複,請使用聯絡人的電子郵件、公司的網域名稱或任何物件的記錄 ID。
- 若要關聯記錄,請使用電子郵件、公司網域名稱、記錄 ID ,或選擇一對多屬性,其中一個值對於與其關聯的許多記錄是唯一的(例如,公司名稱作為一個,它將與在同一家公司工作的許多聯繫人關聯。請參閱匯入檔案範例以取得進一步指引。
重複關聯ID
錯誤的含義
您選擇關聯記錄的關聯ID不唯一。
如何解決錯誤
選擇不同的欄標題作為兩個檔案之間的共同欄。為了獲得最佳結果,請選擇一個一對多屬性,其中與其相關聯的許多記錄的一個值是獨一無二的(例如,公司名稱為該記錄,該記錄將與在同一公司工作的許多聯絡人相關聯)。請參閱匯入檔案範例以取得進一步指引。選擇新的關聯ID後,請重新匯入檔案。
重復的記錄ID
錯誤的含義
相同的記錄ID在您的檔案中被多次使用。受影響的記錄未在HubSpot中更新或關聯。
如何解決錯誤
更新您的匯入檔案,以便只有一行具有該記錄ID。保持行包含您希望包含在HubSpot中的最新信息。移除重複檔案後,請重新匯入檔案。
復制行內容
錯誤的含義
HubSpot偵測到匯入檔案包含重複記錄。匯入沒有創建新記錄。
如何解決錯誤
移除匯入檔案中的重複項目,然後重新匯入。
重複獨特的旅居價值
錯誤的含義
相同的唯一值在您的文件中多次使用。您的資料已匯入,但HubSpot中可能有相同記錄的重複項目。如果您試圖關聯,則您的記錄沒有關聯。
如何解決錯誤
選擇一個不同的欄標題作為您的獨特值,然後重新匯入文件。- 若要避免重複,請使用聯絡人的電子郵件、公司的網域名稱或任何物件的記錄ID。
- 若要關聯記錄,請使用電子郵件、公司網域名稱、記錄 ID ,或選擇一對多屬性,其中一個值對於與其關聯的許多記錄是唯一的(例如,公司名稱作為一個,它將與在同一家公司工作的許多聯繫人關聯。請參閱匯入檔案範例以取得進一步指引。
無法建立關聯
錯誤的含義
HubSpot無法以當前格式關聯您的記錄。記錄已匯入,但沒有關聯。
如何解決錯誤
確認您已達到關聯記錄的檔案要求。如果匯入一個檔案,您可能需要為每個物件新增唯一識別碼。如果匯入兩個檔案,您可能需要選擇一個不同的共同欄位來正確關聯。對檔案進行變更並重新匯入,或手動關聯記錄。
無法選擇退出聯絡方式
錯誤的含義
HubSpot無法退出退出文件中的某些聯系人。如何解決錯誤
確認您的選擇 退出清單中的所有聯絡人都有電子郵件值。如果有任何遺漏的電子郵件,請將其電子郵件地址新增至檔案,以便適當選擇退出聯絡人接收電子郵件。您也可以 手動建立聯絡人,並從聯絡紀錄中 選擇退出。無法處理屬性值為空的對象
錯誤的含義
您的檔案包含多個列的空值,而HubSpot無法處理記錄。未匯入該行中的資料。
如何解決錯誤
填寫匯入檔案缺少的屬性值,然後重新匯入檔案。
電子郵件、交易/工單 階段或交易/工單管道的驗證失敗
錯誤的含義
匯入檔案包含不符合典型電子郵件地址格式的電子郵件地址(例如 name@domain.com) ,或與HubSpot中現有階段、狀態或管道名稱不匹配的Deal Stage、Deal Pipeline、 Ticket Status或Ticket Pipeline屬性的值。匯入 沒有建立或更新記錄。如何解決錯誤
對於聯絡人,請使用正確的電子郵件更新您的匯入檔案,然後重新匯入檔案。對於交易或工單,請使用正確的階段、狀態和管道名稱更新您的匯入檔案,或將自訂 交易階段或 工單狀態新增至HubSpot。完成後,請重新匯入檔案。找不到文件
錯誤的含義
找不到您選擇的檔案。您的數據未被匯入。
如何解決錯誤
確認您已將檔案儲存至電腦,且檔案類型正確。完成後,請重新上傳檔案。
GDPR黑名單郵箱
錯誤的含義
匯入檔案包含一封或多封由於GDPR而被封鎖的電子郵件。未匯入這些聯絡人。
如何解決錯誤
匯入檔案仍會匯入您的其他聯絡人,但您無法透過匯入新增被封鎖的聯絡人。將永久刪除的聯絡人新增回CRM的唯一方法是要求他們提交表格。一旦聯絡人提交表格,他們就會在你的CRM中建立為新聯絡人。
列數不正確
錯誤的含義
匯入檔案至少包含一個沒有標題的欄位。未 匯入沒有標題的列中的數據。
如何解決錯誤
確認是否應匯入列中的資料,新增適當的標題或移除列,然後重新匯入檔案。
無效的替代ID
錯誤的含義
匯入檔案包含作為電子郵件地址、網域名稱或記錄ID匯入的無效值。匯入沒有建立或更新記錄。
如何解決錯誤
使用正確的電子郵件、網域名稱或記錄ID值更新匯入檔案,然後重新匯入檔案。
無效的關聯識別碼
錯誤的含義
匯入檔案沒有包含適當的唯一值來關聯您的記錄。數據已匯入,但結果記錄未在HubSpot中關聯。
如何解決錯誤
更新您的匯入檔案以包含有效的關聯識別碼(例如,聯絡人的電子郵件、公司的公司網域名稱或記錄ID ) ,然後重新匯入檔案。了解如何正確設定檔案以匯入和關聯多個物件。
枚數選項無效
錯誤的含義
匯入檔案包含的值與枚舉屬性中的現有選項不匹配。這適用於多重選擇、下拉選擇、無線選擇和核取方塊類型屬性。受影響的記錄仍被匯入,但枚舉屬性不包含值。
如何解決錯誤
通過將匯入檔案與HubSpot中的屬性進行比較來識別不正確的值。對於HubSpot預設枚舉屬性(例如,生命週期 階段、工業) ,請確保您的值與英文選項的標籤或其內部值匹配。您可以選擇更新匯入檔案中的值以匹配現有選項,或將值作為自訂選項添加到您的屬性中。完成後,請重新匯入檔案或手動更新受影響記錄中的屬性值。
無效的文件類型
錯誤的含義
輸入檔案是輸入到HubSpot的錯誤檔案類型。您的數據未被匯入。
如何解決錯誤
將檔案轉換為.csv、.xls或.xlsx檔案,然後重新匯入。查看匯入HubSpot的其他檔案要求。
無效的數字大小
錯誤的含義
匯入檔案包含數值太小或太大。受影響的行已匯入,但number屬性不包含值。
如何解決錯誤
確認您的特定屬性或屬性類型的格式要求,更新您的檔案以符合正確的格式,然後重新匯入。您也可以手動更新受影響記錄中的屬性值。
無效的記錄ID
錯誤的含義
在匯入期間,檔案的其中一個欄位被映射到記錄ID。但是,文件中 列出的記錄I D與HubSpot中的現有ID不匹配。記錄未被匯入。
如何解決錯誤
確保記錄ID正確。您可能需要匯出現有記錄以獲得正確的記錄ID ,或為現有記錄使用不同的唯一識別碼。如果您沒有更新或關聯HubSpot中的現有物件,請勿在匯入過程中選取該核取方塊。
所需的屬性無效
錯誤的含義
匯入檔案中的必需屬性包含無效值。未匯入該行中的資料。
如何解決錯誤
確認您的特定屬性或屬性類型的格式要求,更新您的檔案以符合正確的格式,然後重新匯入。
無效的工作表數
錯誤的含義
匯入檔案包含多個工作表。您的數據未被匯入。
如何解決錯誤
從匯入檔案中移除任何額外的工作表,然後重新匯入。查看匯入HubSpot的其他檔案要求。
無效的電子表格
錯誤的含義
匯入檔案不是有效的試算表檔案。您的數據未被匯入。
如何解決錯誤
將檔案轉換為.csv、.xls或.xlsx檔案,然後重新匯入。查看匯入HubSpot的其他檔案要求。
已超出上限
錯誤的含義
HubSpot無法建立紀錄,因為您已達到可儲存該物件的紀錄數量上限。此錯誤適用於標準CRM物件:聯絡人、公司、交易和工單。您的數據未被匯入。
如何解決錯誤
刪除不再需要該物件的任何記錄,然後重新匯入檔案以建立新記錄。進一步了解您的HubSpot訂閱及其局限性。
行中有許多錯誤
錯誤的含義
匯入檔案包含超過10個錯誤的行。錯誤的描述將列出所有行的錯誤和受影響的列。視錯誤而定,該列可能尚未匯入,或者該列在匯入時沒有受影響列的值。
如何解決錯誤
檢查每個錯誤,然後更新並重新匯入檔案,或在HubSpot中手動更新受影響的記錄/活動。
具有此域的多家公司
錯誤的含義
匯入檔案包含一個與您的HubSpot帳戶中的多個公司相匹配的公司網域名稱值。匯入沒有更新公司記錄。
如何解決錯誤
在公司主頁中搜尋特定的公司網域名稱值,以尋找重複的網域。合併公司記錄或刪除其中一個,然後重新匯入檔案。
找到多位所有者
錯誤的含義
匯入檔案包含與帳戶中多個使用者匹配的Owner值。這通常發生在名稱上(例如,您的HubSpot帳戶中有兩個John Doe用戶,而匯入文件包含名稱“John Doe” )。受影響的記錄已匯入,但Owner屬性不包含值。
如何解決錯誤
將擁有者的姓名替換為匯入檔案中的電子郵件地址,然後重新匯入檔案。您也可以手動更新受影響記錄中的擁有者屬性值。
超出有效期限
錯誤的含義
匯入檔案包含超出接受條款範圍的時間段值。受影響的記錄已匯入,但術語屬性不包含值。
如何解決錯誤
將檔案中的條款值更新為在接受的時間範圍內(大於或等於1個月的整數) ,然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。
超出有效時間範圍
錯誤的含義
匯入檔案包含超出接受時間範圍的時間段值。受影響的記錄已匯入,但時間範圍屬性不包含值。
如何解決錯誤
將檔案中的時間範圍值更新為可接受的時間範圍內(少於1000年) ,然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。
超出入口全自定義對象限制
錯誤的含義
HubSpot無法建立紀錄,因為您已達到可儲存該自訂物件的紀錄數量上限。您的數據未被匯入。
如何解決錯誤
如果有不再需要的記錄,請刪除該自訂物件中的記錄,然後重新匯入檔案。如果您需要額外的記錄存儲,您可以購買自訂物件記錄限制增加。進一步了解您的HubSpot訂閱及其局限性。
找不到屬性定義
錯誤的含義
匯入檔案包含與HubSpot屬性不匹配的列標題。未匯入該列中的資料。
如何解決錯誤
在匯入期間,請選擇現有的屬性,或在檔案中的「映射欄位到 [物件]屬性頁面」上新建屬性,以正確匹配欄位。您也可以選擇跳過匯入不匹配的欄位。
屬性驗證規則錯誤
錯誤的含義
匯入檔案包含的值不符合屬性驗證規則的要求(例如,該值包含特殊字元,太長,太短等)。受影響的記錄已匯入,但屬性不包含值。
如何解決錯誤
在設定中查看或編輯旅居的驗證規則。更新匯入檔案以包含遵循屬性規則的值,然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。
找不到房源價值
錯誤的含義
匯入檔案缺少所需屬性的值。未匯入該行中的資料。
如何解決錯誤
更新匯入檔案以包含所需屬性的值,然後重新匯入檔案。
行數據太大
錯誤的含義
您的檔案包含包含超過1 MB資料的儲存格或行,這些資料太大,導入工具無法處理。未匯入該行中的資料。
如何解決錯誤
縮小檔案中受影響的單元格或行大小,然後重新匯入檔案。
未知的錯誤請求
錯誤的含義
匯入檔案包含無效的記錄ID ,該記錄ID與HubSpot帳戶中的任何現有記錄不匹配。匯入沒有更新記錄,因為數據與任何現有記錄不匹配。
如何解決錯誤
確認你有正確的記錄ID。如果發現錯誤的ID ,請使用正確的記錄ID更新匯入檔案,然後重新匯入檔案。
未知錯誤
錯誤的含義
由於未知錯誤, HubSpot無法處理檔案。您的數據未被匯入。
如何解決錯誤
確認您的檔案符合所有要求。清除瀏覽器快取或使用其他瀏覽器後,請嘗試重新匯入。如果仍然看到錯誤,請在社羣發佈訊息(所有用戶)或聯絡支援團隊(僅限初學者、專業人士和企業帳戶)。
僅更新import
錯誤的含義
您選擇了匯入僅更新現有記錄,但您的匯入檔案包含與HubSpot中現有記錄不對應的唯一識別碼值。例如,您匯入的電子郵件值與現有聯絡人的電子郵件不匹配,或記錄ID值與現有記錄不匹配。未匯入受影響的行,因此未建立新記錄,但更新了現有記錄。
如何解決錯誤
如果受影響的值應該與現有記錄匹配,請確認值拼寫正確或包含正確的記錄ID號碼。修復檔案中的任何錯誤,然後重新匯入。
如果您的目標只是更新現有記錄,而不是創建新記錄,則不需要採取任何操作。如果希望受影響的行建立新記錄,請重新匯入檔案,然後選擇建立新記錄並更新匯入過程中的現有記錄。
Salesforce匯入錯誤
- 瀏覽至您的記錄:
- 聯系人: 在你的 HubSpot 帳戶中,瀏覽「連絡人」>「連絡人」。
- 公司: 在你的 HubSpot 帳戶中,瀏覽「連絡人」>「公司」。
- 優惠: 在你的 HubSpot 帳戶中,瀏覽「銷售」>「交易」。
- 工單: 在你的 HubSpot 帳戶中,瀏覽「服務」>「服務票證」。
- 自訂物件:在HubSpot帳戶中,瀏覽至「聯絡人」>「聯絡人」,然後按一下左上角的下拉式選單,然後選擇自訂物件的名稱。
- 產品:在你的 HubSpot 帳戶中,點擊主導覽列中的settings「設定圖示」。在左側邊欄選單中,瀏覽至「物件」>「產品」。
- 按一下右上角的「匯入」。如果你在產品索引頁面上,按一下[操作]下拉選單,然後選擇[匯入]。
- 將滑鼠停留在有錯誤的Salesforce匯入上,然後按一下檢視匯入錯誤。
- 在「匯入錯誤」表格中,將鼠標懸停在錯誤上,然後按一下檢視詳情以查看更多資訊。
- 右側面板會顯示錯誤的描述,以及解決資料。您還會看到受錯誤影響的記錄清單。按一下記錄連結以存取記錄,並按需要進行變更。
