查看並排除匯入錯誤

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

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

修復匯入過程中的錯誤

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

• 找不到關聯標籤
• 找不到所有者
• 無法解析日期
• 無法解析數字
• 驗證失敗
• 域名無效
• 郵箱無效
• 枚數選項無效
• 無效的記錄ID

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

• 按一下[x]個錯誤。

• 在右側面板中，檢視有關錯誤類型的更多詳細資訊，包括哪些欄和行受到影響。
• 若要檢視要對應的旅居，請按一下右上角的旅居名稱。
• 若要深入瞭解特定錯誤，請按一下錯誤名稱。
• 若要檢視檔案中受影響的行，請按一下「檢視有錯誤的值」。
• 如果有建議的解決方案，系統會顯示「修正錯誤」部分。檢視建議的解決方案，然後根據錯誤，您可以執行以下操作：

• • 若要編輯屬性，請按一下「編輯[name]屬性」。屬性編輯器會出現在右側面板中。根據建議更新旅居（例如編輯旅居名稱或選項） ，然後按一下「儲存」。
  • 若要將列舉屬性或關聯標籤的值重新對映到現有的選項：
    • 要手動重新映射，請單擊受影響行中的選擇選項，然後選擇更新值的選項，或者選擇忽略錯誤以忽略值。如果忽略該值，該行將在沒有該屬性值的情況下匯入。
    • 要自動重新映射，請單擊自動修復錯誤。如果沒有明確的更換，自動修復可能無法成功。
    • 若要重設個別變更，請點擊更新後的選項，然後點擊「重設變更」。若要復原所有變更，請按一下重設所有變更。

• • 若要更新值的格式（例如，日期格式不正確） ，請按一下下拉式選單並更新值的格式。
  • 如果屬性是唯讀的（例如，某些預設的HubSpot屬性） ，請按一下檢視[name]屬性以檢視屬性的詳細資訊。無法編輯唯讀屬性，因此需要更新並重新匯入檔案以解決錯誤。

• 在「其他選項」部分，按一下right以展開並檢視每個額外選項。

• 解決錯誤後，「對應」欄中會出現success 勾選記號。

請注意：如果您的檔案包含超過1000行，則可能有其他錯誤未解決。

檢查匯入

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

• 在「摘要」卡片上，查看已匯入的行數、新建的記錄以及已更新的現有記錄。深入瞭解如何分析匯入。
• 如果您在匯入期間修復了枚舉屬性值或關聯標籤的錯誤，則會顯示一個顯示您對值所做更改的區段。

• 如果匯入有錯誤，則會顯示「匯入錯誤」部分。在表格中，查看以下信息：
  • 從檔案匯入欄位：檔案中受錯誤影響的欄位標頭。 
  • 對象類型：指派給受影響欄的CRM對象或活動。
  • HubSpot屬性：與受影響欄匹配的HubSpot屬性。
  • 錯誤類型：受影響欄的錯誤類型。進一步了解所有匯入錯誤。
  • 錯誤影響：因為錯誤而未匯入的行數或屬性值。如果未匯入行，表示無法匯入受影響行中的所有列。如果未匯入值，這意味著無法匯入該特定屬性的欄中的值，但可以匯入行中的其他欄。

• 若要檢視有關特定錯誤的詳細資訊，請將鼠標懸停在行上，然後按一下檢視詳情。
• 若要檢視所有含有錯誤的行，請按一下檢視含有錯誤的行。在「有錯誤的行」頁面上：
  • 在表格中，查看行及其內含的錯誤。受錯誤影響的欄位將包含exclamation 警示圖示。按一下最左欄的錯誤名稱，即可查看錯誤的原因和解決方法。
  • 按一下下載有錯誤的行作為檔案，下載受影響的行及其錯誤。按一下下載的zip檔案，提取CSV檔案，然後開啟檔案。
• 若要下載檔案中的錯誤清單，請在表格上方按一下下載錯誤作為檔案。 
  • 按一下下載的zip檔案，提取CSV檔案，然後開啟檔案。
  • 在檔案中，在「錯誤代碼」列中識別錯誤代碼，在「物件類型」列中識別受影響的記錄對象，在「原因」列中識別錯誤原因，以及在其他列中識別記錄的屬性值。

請注意：匯入錯誤中的敏感資料將替換為匯入後畫面和下載的錯誤檔案中的編輯字詞。若要檢視值，請參閱原始匯入檔案。

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

匯入檔案錯誤

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

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

曖昧列數選項

錯誤的含義

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

如果檔案中的值是屬性選項的標籤而不是其內部值，您也可能會看到此錯誤。這適用於標籤與內部值不同的列舉屬性選項。

已匯入受影響的記錄，但列舉屬性不包含值。

如何解決錯誤

透過將匯入檔案與HubSpot中的屬性進行比較，找出不正確的值。更新導入文件中的值以僅匹配一個現有選項，或者如果標籤與其內部值不同，則更新選項的內部值。更新值後，重新匯入檔案。

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

找不到關聯標籤

錯誤的含義

匯入期間，一欄包含關聯標籤，但該標籤在HubSpot中不存在。已匯入資料，但產生的關聯未標記。

如何解決錯誤

透過將匯入檔案與HubSpot中的關聯標籤進行比較，找出不正確的值。請確保您的值與現有標籤相符，或建立新標籤。如果您要匯入配對標籤，請確保對應物件使用了正確的標籤(例如，僱主已套用至公司，員工已套用至客服案件)。完成後，請重新匯入檔案或手動更新受影響記錄中的標籤。

已超過關聯限制

錯誤的含義

您之前為記錄之間允許的總關聯數或標記關聯數設置了關聯限制，但您的匯入包含超過限制的關聯。資料已匯入，但結果記錄並未在HubSpot中關聯。

如果記錄應關聯或具有特定標籤以定義關聯，請更新您的關聯限制，然後重新匯入檔案或在HubSpot中手動更新關聯。

匯入期間，欄會對應到 唯一識別碼屬性以關聯記錄（即記錄ID、電子郵件、公司網域名稱或自訂唯一值屬性）。但是，所需的唯一值未包含在文件中。如果您使用的值包含換行符或超過100個字元的唯一識別碼，也可能會發生這種情況。資料已匯入，但結果記錄並未在HubSpot中關聯。

如何解決錯誤

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

找不到所有者

錯誤的含義

匯入檔案包含的記錄擁有者與HubSpot中的使用者不匹配。受影響的記錄已匯入，但「擁有者」欄位不包含值。

如何解決錯誤

確認要將記錄指派給的人員是帳戶中的活躍使用者，然後更新匯入檔案的「擁有者」欄中的資料，以包含使用者的姓名或電子郵件。

• 如果您要將記錄指派給的人尚未成為帳戶中的使用者，請將他們新增為使用者，然後使用帳戶中顯示的姓名或電子郵件重新匯入。
• 如果你想指派的用戶是已停用的用戶，請重新啟用該用戶，然後使用帳戶中顯示的姓名或電郵重新匯入。

無法解析日期

錯誤的含義

匯入檔包含的日期值與您在匯入過程中選擇的格式不符。受影響的記錄已匯入，但date屬性不包含值。

如何解決錯誤

使用正確的值更新匯入檔案並重新匯入，或手動更新受影響記錄中的屬性值。

無法解析數字

錯誤的含義

匯入檔案包含非數字字元的數字屬性值。受影響的記錄已匯入，但number屬性不包含值。

如何解決錯誤

使用正確的數值更新匯入檔案並重新匯入，或手動更新受影響記錄中的屬性值。

無法解析行

錯誤的含義

匯入檔案包含一行無法處理的資料。如果它是必需的屬性，則未匯入記錄。如果它不是必需的屬性，則記錄已匯入，但該屬性不包含值。

如何解決錯誤

驗證您的資料值與您要匯入的屬性的正確格式相符，修正任何錯誤，然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。

無法解析術語

錯誤的含義

匯入檔案包含的時間段值與接受的術語格式不匹配。受影響的記錄仍被匯入，但條款屬性不包含值。 

如何解決錯誤

將檔案中的條款值更新為整數個月或ISO8601持續時間格式（例如，三年，六個月，四天的時間為P3Y6M4D ） ，然後重新匯入檔案。您也可以手動更新受影響記錄中的屬性值。

只建立import

錯誤的含義

您選擇匯入應僅建立新記錄，但匯入檔案包含與HubSpot中現有記錄相符的唯一識別碼值。例如，您匯入的電子郵件值已與現有聯絡人的電子郵件相符（包括其他電子郵件） ，或者您匯入的公司網域名稱值已與現有公司的網域相符（包括其他網域）。受影響的行未被匯入，因此現有記錄未被更新，但包含新資訊的行確實創建了新記錄。

如何解決錯誤

如果您的目標只是創建新記錄，並避免更新現有記錄，則無需採取任何操作。如果您確實想要更新檔案中的現有記錄，請重新匯入檔案，然後選擇在匯入過程中建立新記錄並更新現有記錄。

• 若要避免重複，請使用聯絡人的電子郵件、公司的公司網域名稱或任何物件的記錄 ID。 
• 若要關聯記錄，請使用電子郵件、公司網域名稱、記錄 ID ，或選擇一對多屬性，其中一個值對於與其關聯的許多記錄是唯一的（例如，公司名稱作為一個，它將與在同一家公司工作的許多聯繫人關聯。如需進一步指導，請參閱範例匯入檔案。

重複關聯ID

錯誤的含義

您選擇關聯記錄的關聯ID不唯一。

如何解決錯誤

選擇不同的欄標題作為兩個檔案之間的共同欄。為了獲得最佳結果，請選擇一個一對多屬性，其中與其相關聯的許多記錄的一個值是獨一無二的（例如，公司名稱為該記錄，該記錄將與在同一公司工作的許多聯絡人相關聯）。如需進一步指導，請參閱範例匯入檔案。選擇新的關聯ID後，請重新匯入檔案。

重復的記錄ID

錯誤的含義

相同的記錄ID在您的檔案中被多次使用。受影響的記錄未在HubSpot中更新或關聯。

如何解決錯誤

更新您的匯入檔案，以便只有一行具有該記錄ID。保持行包含您希望包含在HubSpot中的最新信息。移除重複檔案後，請重新匯入檔案。

復制行內容

錯誤的含義

HubSpot偵測到匯入檔案包含重複記錄。匯入沒有創建新記錄。

如何解決錯誤

移除匯入檔案中的重複項目，然後重新匯入。

重複獨特的旅居價值

錯誤的含義

HubSpot中的唯一識別碼屬性會在所有記錄中強制執行該屬性值的唯一性。與檔案中的其他列或CRM中的其他記錄相比，對映到唯一識別碼屬性的欄中的某些值並不唯一。如果此屬性在檔案中不是唯一的，則只匯入了此屬性引用的一行。如果此屬性值與CRM中的其他記錄衝突，則不會匯入該記錄。

如何解決錯誤

選擇不同的欄標題作為唯一值，或移除重複的值，然後重新匯入檔案。

如果檔案包含多個唯一識別碼屬性：

• 可能存在衝突的獨特值（例如，電子郵件和自訂獨特屬性，其中自訂屬性具有獨特值，但存在重複的電子郵件）。移除衝突的唯一值，然後重新匯入。
• 如果您嘗試更新其中一個唯一值屬性，請在匯入期間選擇不想更新的屬性作為用於查找現有[objects]的屬性。

請注意：如果你使用記錄ID作為唯一標識符，它將取代匯入中包含的任何其他唯一標識符。聯絡人屬性電子郵件也將始終需要唯一的值。

無法建立關聯

錯誤的含義

HubSpot無法以當前格式關聯您的記錄。記錄已匯入，但沒有關聯。

如何解決錯誤

確認您已達到關聯記錄的檔案要求。如果要匯入一個檔案，您可能需要為每個物件新增唯一識別碼。如果要匯入兩個檔案，則可能需要選擇不同的公用欄才能正確關聯。對檔案進行變更並重新匯入，或手動關聯記錄。

無法選擇退出聯絡方式

錯誤的含義

如何解決錯誤

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

錯誤的含義

您的檔案包含多個列的空值，而HubSpot無法處理記錄。未匯入該行中的資料。

如何解決錯誤

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

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

錯誤的含義

如何解決錯誤

找不到文件

錯誤的含義

找不到您選擇的檔案。您的數據未被匯入。

如何解決錯誤

確認您已將檔案儲存到電腦，且檔案類型正確。完成後，請重新上傳檔案。

GDPR封鎖的電子郵件

錯誤的含義

導入文件包含一個或多個由於數據隱私而被阻止通信的電子郵件。未匯入這些聯絡人。

如何解決錯誤

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

列數不正確

錯誤的含義

匯入檔案至少包含一個沒有標題的欄位。未 匯入沒有標題的列中的數據。

確保記錄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資料的儲存格或行，這些資料太大，導入工具無法處理。未匯入該行中的資料。

如何解決錯誤

縮小檔案中受影響的單元格或行大小，然後重新匯入檔案。

未知的錯誤請求

錯誤的含義

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

如何解決錯誤

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

未知錯誤

錯誤的含義

由於未知錯誤， HubSpot無法處理檔案。您的數據未被匯入。

如何解決錯誤

確認你的檔案符合所有要求。清除瀏覽器快取或使用其他瀏覽器後，請嘗試重新匯入。如果仍然看到錯誤，請在社羣發佈訊息（所有用戶）或聯絡支援團隊（僅限初學者、專業人士和企業帳戶）。

僅更新import

錯誤的含義

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

如何解決錯誤

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

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

Salesforce匯入錯誤

• 瀏覽至您的記錄：
• 聯系人： 在你的 HubSpot 帳戶中，瀏覽「CRM」>「連絡人」。
• 公司： 在你的 HubSpot 帳戶中，瀏覽「CRM」>「公司」。
• 優惠： 在你的 HubSpot 帳戶中，瀏覽「CRM」>「交易」。
• 工單： 在你的 HubSpot 帳戶中，瀏覽「CRM」>「服務票證」。
• 自訂物件：在HubSpot帳戶中，瀏覽至「聯絡人」>「聯絡人」，然後按一下左上角的下拉式選單，然後選擇自訂物件的名稱。
• 產品：在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中，瀏覽至「物件」>「產品」。

• 按一下右上角的「匯入」。如果你在產品索引頁面上，按一下[操作]下拉選單，然後選擇[匯入]。
• 將滑鼠停留在有錯誤的Salesforce匯入上，然後按一下檢視匯入錯誤。 
• 在「匯入錯誤」表格中，將鼠標懸停在錯誤上，然後按一下檢視詳情以查看更多資訊。

• 右側面板會顯示錯誤的描述，以及解決資料。您還會看到受錯誤影響的記錄清單。按一下記錄連結以存取記錄，並按需要進行變更。