跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

查看並排除匯入錯誤

上次更新時間: 三月 3, 2023

套用至:

所有產品和版本

將記錄或活動入HubSpot時,您可能會遇到錯誤。以下是如何解決在匯入時檢測到的錯誤、下載錯誤檔案、檢視錯誤詳情以及更正匯入檔案或Salesforce中的問題。

在開始匯入或修復有錯誤的檔案之前,請瞭解有關匯入HubSpot的條款和要求。

修復匯入過程中的錯誤

在完成匯入之前, HubSpot會檢查檔案前100行中的某些錯誤。如果偵測到以下任何錯誤,則會在匯入過程中映射屬性時,引起你的注意:

要解決這些錯誤,請按照以下步驟,從檔案中的「映射」列到「HubSpot屬性」畫面:

  • 將滑鼠懸停在嘆號感嘆圖示上,然後按一下彈出方塊中的修復匯入錯誤。

import-error-preview

  • 在右側面板中,檢視有關錯誤類型的更多詳細資訊,包括哪些欄和行受到影響。

固定匯入錯誤窗格

  • 若要檢視檔案中受影響的行,請按一下「檢視有錯誤的值」。
  • 如果有建議的解決方案,則會顯示「修復此錯誤」部分。檢視建議的解決方案,然後根據錯誤選擇一個選項:
    • 點擊編輯[name]屬性。屬性編輯器會出現在右側面板中。根據建議更新旅居,然後按一下儲存。
    • 如果屬性是只讀的(例如,某些預設的HubSpot屬性) ,您可以按一下檢視[name]屬性以查看屬性的詳細資料。無法編輯唯讀屬性,因此需要更新並重新匯入檔案以解決錯誤。
    • 按一下下拉式選單以更新格式(例如日期格式)。
  • 在「其他選項」部分:
    • 按一下右鍵以展開並檢視每個額外選項。
    • 若要查看對應的旅居的更多詳情,請點擊查看[NAME]旅居。
    • 若要進一步了解特定錯誤,請點擊「進一步了解此錯誤」。
  • 解決錯誤後,「映射」欄中將會顯示成功勾選標記。

請注意:如果您的檔案包含超過100行,則可能會出現其他未解決的錯誤。

匯入後查看錯誤

完成匯入後,系統會自動帶你到匯入摘要,包括任何錯誤的概述。您也可以查看之前完成的匯入的摘要。

  • 在「摘要」卡片上,查看已匯入的行數、新建的記錄以及已更新的現有記錄。了解更多有關分析匯入的資訊。
  • 如果匯入有錯誤,則會顯示「匯入錯誤」部分。在表格中,查看以下信息:
    • 從檔案匯入欄位:檔案中受錯誤影響的欄位標頭。 
    • 對象類型:指派給受影響欄的CRM對象或活動。
    • HubSpot屬性:與受影響欄匹配的HubSpot屬性。
    • 錯誤類型:受影響欄的錯誤類型。進一步了解所有匯入錯誤。
    • 錯誤影響:因為錯誤而未匯入的行數或屬性值。如果未匯入行,表示無法匯入受影響行中的所有列。如果未匯入值,這意味著無法匯入該特定屬性的欄中的值,但可以匯入行中的其他欄。
  • 若要檢視有關特定錯誤的詳細資訊,請將鼠標懸停在行上,然後按一下檢視詳情。
  • 若要檢視所有含有錯誤的行,請按一下檢視含有錯誤的行。在「有錯誤的行」頁面上:
    • 在表格中,查看行及其內含的錯誤。受錯誤影響的欄位將包含exclamation 警報圖示。按一下最左欄的錯誤名稱,即可查看錯誤的原因和解決方法。
    • 按一下下載有錯誤的行作為檔案,下載受影響的行及其錯誤。按一下下載的zip檔案,提取CSV檔案,然後開啟檔案。
  • 若要下載檔案中的錯誤清單,請在表格上方按一下下載錯誤作為檔案。 
    • 按一下下載的zip檔案,提取CSV檔案,然後開啟檔案。
    • 在檔案中,在「錯誤代碼」列中識別錯誤代碼,在「物件類型」列中識別受影響的記錄對象,在「原因」列中識別錯誤原因,以及在其他列中識別記錄的屬性值。

顯示匯入錯誤後,請瞭解如何解決特定錯誤。

匯入檔案錯誤

以下是按字母排序的錯誤代碼清單,其中包含錯誤的詳細資料和可能的解決步驟。在某些情況下,有錯誤的記錄或活動會被匯入,並可以在HubSpot中進行更正,或者更正匯入檔案並重新匯入。在其他情況下,記錄或活動不會匯入,匯入檔案需要在重新匯入前更正。

請注意:下載檔案中的錯誤代碼將包含大寫字母和下劃線字符,但會列於本文的正常文字中。例如,錯誤會顯示為檔案中的Ambiguous_enumeration_OPTION ,但您會在下面的清單 中找到Ambiguous enumeration_option。

曖昧列數選項

錯誤的含義

相同的記錄與為枚數屬性定義的多個現有選項相匹配。 這適用於多重選擇、下拉選擇、無線選擇和核取方塊類型屬性。

如果檔案中的值是屬性選項的標籤,而不是其內部值,也可能會顯示此錯誤。這適用於標籤與內部值不同的枚數屬性選項。

已匯入影響的記錄,但枚數屬性不包含值。

如何解決錯誤

將匯入檔案與HubSpot中的屬性進行比較,以識別不正確的值。U將匯入檔案中的值更新為只匹配一個現有選項,如果標籤與其內部值不同,則更新該選項的內部值。更新值後,重新匯入檔案。

您也可以在受影響的記錄
手動更新屬性值。
 
如果您的記錄應與多個選項相符,請瞭解如何格式化檔案,以便將資料正確匯入到多個核取方塊內容中。

找不到所有者

錯誤的含義

匯入檔案中包含的記錄擁有者與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無法在選擇退出檔案中選擇退出某些聯絡人。 
 

如何解決錯誤

確認你的選擇退出清單上的所有聯絡人都有電郵值。如果有任何遺漏的電子郵件,請將其電子郵件地址新增至檔案,以便適當選擇退出聯絡人接收電子郵件。您也可以手動建立聯絡人,並從聯絡人記錄中選擇取消聯絡人。

無法處理屬性值為空的對象

錯誤的含義

Y我們的文件包含多列空值, HubSpot無法處理記錄。匯入該行中的資料。

如何解決錯誤

填寫匯入檔案的缺失屬性值,然後重新匯入檔案。

電子郵件、交易/工單 階段或交易/工單管道的驗證失敗

錯誤的含義

匯入檔案包含的電子郵件地址不符合典型電子郵件地址的格式 (例如 name@domain.com ) ,或與HubSpot中現有階段、狀態或管道名 稱不匹配的交易階段、交易管道、工單狀態或工單管道內容的值。匯入沒有建立或更新記錄。
 

如何解決錯誤

對於聯絡人,請使用正確的電子郵件更新匯入檔案,然後重新匯入檔案。若要獲得優惠或入場券,請使用正確的階段、狀態和管道名稱更新匯入檔案,或將自訂優惠階段或入場券狀態新增至HubSpot。完成後,重新匯入檔案。

找不到文件

錯誤的含義

找不到您選擇的檔案。您的資料匯入。

如何解決錯誤

驗證您已將檔案儲存到電腦,並且檔案類型正確無誤。完成後,重新上傳檔案。

GDPR黑名單郵箱

錯誤的含義

匯入檔案包含一個或多個因GDPR而無法溝通的電子郵件匯入這些聯絡人。

如何解決錯誤

匯入檔案仍會匯入您的其他聯絡人,但您無法透過匯入新增被封鎖的聯絡人。將永久刪除的聯絡人新增回CRM的唯一方法是要求他們提交表格。一旦聯絡人提交表格,他們就會在你的CRM中建立為新聯絡人。

列數不正確

錯誤的含義

匯入檔案包含至少一列沒有標題。匯入沒有標題的列中的資料。

如何解決錯誤

確認是否應匯入列中的資料,新增適當的標題或移除列,然後重新匯入檔案。

無效的替代ID

錯誤的含義

匯入檔案包含作為電子郵件地址、網域名稱或 記錄ID匯入的無效值。匯入沒有建立或更新記錄。

如何解決錯誤

使用正確的電子郵件、網域名稱或記錄ID值更新匯入檔案,然後重新匯入檔案。

無效的關聯識別碼

錯誤的含義

匯入檔案不包含適當的獨特值,無法連結記錄。已匯入資料,但所得記錄並未與HubSpot相關聯。

如何解決錯誤

更新您的匯入檔案以包含有效的關聯識別碼(例如,聯絡人的電子郵件、公司的公司網域名稱或記錄ID ) ,然後重新匯入檔案。瞭解如何正確設定檔案,以匯入和關聯多個物件。

枚數選項無效

錯誤的含義

匯入檔案包含的值與枚數屬性中的現有選項不匹配。這適用於多重選擇、下拉選擇、無線選擇和核取方塊類型屬性。仍匯入受影響的記錄,但枚數屬性不包含值。

如何解決錯誤

將匯入檔案與HubSpot中的屬性進行比較,以識別不正確的值。您可以選擇更新匯入檔案中的值,以匹配現有選項,或將值新增為自訂選項至房源。完成後,重新匯入檔案或手動更新受影響記錄中的屬性值。

無效的文件類型

錯誤的含義

匯入檔案類型不正確,無法匯入到HubSpot。Y我們的資料未被匯入。

如何解決錯誤

將檔案轉換為.csv、.xls或.xlsx檔案,然後重新匯入。查看匯入HubSpot的其他檔案要求。

無效的數字大小

錯誤的含義

匯入檔案包含的數值太小或太大。已匯入影響的行,但number屬性不包含值。

如何解決錯誤

確認特定旅居或旅居類型的格式要求,更新檔案以符合正確的格式,然後重新匯入。您也可以在受影響的記錄中手動更新屬性值。

無效的記錄ID

錯誤的含義

在匯入期間,檔案的其中一個欄位被映射到記錄ID。但是,文件中 列出的 記錄I D與HubSpot中的現有ID不匹配。匯入記錄。

如何解決錯誤

確保記錄ID正確無誤。您可能需要匯出現有記錄以獲得正確的記錄ID ,或為現有記錄使用不同的唯一識別碼。如果您沒有更新或關聯HubSpot中的現有物件,請勿在匯入過程中選擇核取方塊

所需的屬性無效

錯誤的含義

匯入檔案中必需的屬性包含無效的值。匯入該行中的資料。

如何解決錯誤

確認特定旅居或旅居類型的格式要求,更新檔案以符合正確的格式,然後重新匯入。

無效的工作表數

錯誤的含義

匯入檔案包含多個工作表。您的資料匯入。

如何解決錯誤

從匯入檔案中移除所有其他工作表,然後重新匯入。查看匯入HubSpot的其他檔案要求。

無效的電子表格

錯誤的含義

匯入檔案不是有效的電子表格檔案。您的資料匯入。

如何解決錯誤

將檔案轉換為.csv、.xls或.xlsx檔案,然後重新匯入。查看匯入HubSpot的其他檔案要求。

已超出上限

錯誤的含義

由於限制, HubSpot無法建立記錄。您的檔案可能太大,或者您可能已達到帳戶上限,例如已達到清單的最大數量您的資料匯入。

如何解決錯誤

確認您的檔案小於1,000列和1,048,576行。檔案的大小和每天可以匯入的行數也會受到帳戶訂閱的限制:

  • 如果您使用的是HubSpot的免費工具,您每天最多可以匯入20MB和50萬行檔案。
  • 對於所有其他訂閱,您每天最多可以匯入512 MB和10,000,000行。  

這些限制適用於24小時的輪流期,並不會在一天中的特定時間重設。如果檔案較大,請將資料分離成多個檔案。然後,在多天內重新匯入。如果檔案大小正確,請進一步了解您的HubSpot訂閱及其限制。 

具有此域的多家公司

錯誤的含義

匯入檔案包含與您HubSpot帳戶中的多家公司相匹配的公司網域名稱值。匯入沒有更新公司記錄。

如何解決錯誤

在公司首頁中搜尋特定的公司網域名稱值,以查找重複網域。合並公司記錄或刪除其中一個記錄,然後重新匯入檔案。

找到多位所有者

錯誤的含義

匯入檔案包含與帳戶中多個用戶相匹配的所有值。這通常發生在名稱上 (例如,您的HubSpot帳戶中有兩個John Doe用戶,而匯入檔案包含 「John Doe」名稱)。已匯入受影響的記錄,但所有者屬性不包含值。

如何解決錯誤

用匯入檔案中的電子郵件地址替換所有者的名稱,然後重新匯入檔案。您也可以在受影響的記錄中手動更新所有者屬性值。

超出有效期限

錯誤的含義

匯入檔案包含超出可接受的條款範圍的值。已匯入影響的記錄,但術語屬性不包含值。 

如何解決錯誤

將檔案中的術語值更新為在接受的時間範圍內(大於或等於1個月的整數) ,然後重新匯入檔案。您也可以在受影響的記錄中手動更新屬性值。

超出有效時間範圍

錯誤的含義

匯入檔案包含超出可接受時間範圍的值。已匯入影響的記錄,但時間範圍內屬性不包含值。 

如何解決錯誤

將檔案中的時間範圍值更新為在接受的時間範圍內(小於1000年) ,然後重新匯入檔案。您也可以在受影響的記錄中手動更新屬性值。

找不到屬性定義

錯誤的含義

匯入檔案包含一個與HubSpot Propert y不匹配的列標題。匯入該欄中的資料。

如何解決錯誤

在匯入期間,請選擇現有屬性或在檔案中的「映射」欄位上新建屬性至 [object]屬性頁面,以正確匹配欄位。您也可以選擇跳過匯入不匹配的欄。

屬性驗證規則錯誤

錯誤的含義

匯入檔案包含的值不符合屬性驗證規則的要求(例如,該值包含特殊字元,太長,太短等)。已匯入影響的記錄,但屬性不包含值。

如何解決錯誤

在設定中查看或編輯旅居的驗證規則。更新匯入檔案以包含遵循屬性規則的值,然後重新匯入檔案。您也可以在受影響的記錄中手動更新屬性值。

找不到房源價值

錯誤的含義

匯入檔案缺少必須屬性的值。匯入該行中的資料。

如何解決錯誤

更新匯入檔案以包括所需屬性的值,然後重新匯入檔案。

未知關聯記錄ID

錯誤的含義

在匯入期間,檔案的其中一個欄位被映射到記錄ID。但是,所需的記錄 ID並未包含在檔案中。資料已匯入,但所得的記錄並未關聯在HubSpot中。

如何解決錯誤

更新您的匯入檔案以包含記錄ID ,然後重新匯入檔案。您可能需要匯出現有記錄以獲得正確的記錄ID ,或為現有記錄使用不同的唯一識別碼。瞭解如何正確設定檔案,以匯入和關聯多個物件。

未知的錯誤請求

錯誤的含義

匯入檔案包含無效的記錄ID 該記錄ID與HubSpot帳戶中的任何現有記錄不匹配。匯入更新記錄,因為數據與任何現有記錄都不匹配。

如何解決錯誤

確認你有正確的記錄ID。如果發現錯誤的ID ,請使用正確的記錄ID更新匯入檔案,然後重新匯入檔案。

未知錯誤

錯誤的含義

由於未知錯誤, HubSpot無法處理檔案。您的資料未匯入。

如何解決錯誤

確認您的檔案符合所有要求清除瀏覽器緩存或使用其他瀏覽器後,請嘗試重新匯入。如果你仍然看到錯誤,請在社區 (所有用戶)上發佈,或聯絡支援團隊(僅限新手、專業和企業帳戶)。

更新import

錯誤的含義

選擇了匯入僅更新現有記錄,但您的匯入檔案包含與HubSpot中現有記錄不對應的唯一識別碼值。例如,您匯入的電子郵件值與現有聯絡人的電子郵件不匹配,或記錄ID值與現有記錄不匹配。未匯入受影響的行,因此未建立新記錄,但更新了現有記錄。

如何解決錯誤

如果受影響的值應該與現有記錄匹配,請確認值拼寫正確或包含正確的記錄ID號碼。修復檔案中的任何錯誤,然後重新匯入。

如果您的目標只是更新現有記錄,而不是創建新記錄,則不需要採取任何操作。如果希望受影響的行建立新記錄,請重新匯入檔案,然後選擇建立新記錄並更新匯入過程中的現有記錄。

Salesforce匯入錯誤

  • 瀏覽至您的記錄:
    • 聯系人: 在 HubSpot 帳戶中,進入「連絡人」>「連絡人」。
    • 公司: 在 HubSpot 帳戶中,進入「連絡人」>「公司」。
    • 優惠: 在 HubSpot 帳戶中,進入「銷售」>「交易」。
    • 工單: 在 HubSpot 帳戶中,進入「服務」>「服務票證」。
    • 自訂物件:在HubSpot帳戶中,瀏覽至「聯絡人」>「聯絡人」,然後按一下左上角的下拉式選單,然後選擇自訂物件的名稱。
    • 產品:在您的HubSpot帳戶中,按一下 主導航 列中的 設定圖示設定。在左側邊欄選單中,瀏覽至  物件」>「 產品與報價」。
  • 按一下右上角的「匯入」。如果你在產品索引頁面上,按一下[操作]下拉選單,然後選擇[匯入]。
  • 將滑鼠停留在有錯誤的Salesforce匯入上,然後按一下檢視匯入錯誤。 
  • 在「匯入錯誤」表格中,將鼠標懸停在錯誤上,然後按一下檢視詳情以查看更多資訊。

salesforce-import-errors-view-details

  • 右側面板會顯示錯誤的描述,以及解決資料。您還會看到受錯誤影響的記錄清單。按一下記錄連結以存取記錄,並按需要進行變更。 
salesforce-import-rror-details
這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助