匯入資料

所有產品型別的資料都可匯入存放區。 此外,您可以匯入產品、進階定價資料、客戶資料、客戶地址資料和產品影像。 匯入支援下列作業:

  • 新增/更新
  • 取代
  • 刪除

匯入准則

新實體

  • 實體會以CSV檔案中指定的屬性值加入。
  • 對於未設定預設值的必要屬性,如果沒有值或無效值,則無法匯入實體(對應的列)。
  • 對於設定了預設值的必要屬性,如果沒有任何值或無效值,則會匯入實體(對應的一列或多列)並設定屬性的預設值。
  • 如果複雜資料無效,則無法匯入實體(對應的列)。

現有實體

  • 對於非複雜資料的屬性,來自匯入檔案的值(包括非必要屬性的空白值)會取代現有值。
  • 如果必要屬性沒有值或存在無效值,則不會取代現有值。
  • 如果實體的複雜資料無效,則無法匯入實體(對應的列或列),但在「匯入行為」下拉式選單中選取「刪除實體」時除外。

複雜資料

如果匯入檔案中指定的屬性存在,且其值衍生自已定義的值集,則適用下列情況:

  • 如果值尚未包含在已定義的值集中,則可匯入列,並為屬性設定預設值(如果已定義)。
  • 如果值已包含在定義的集中,則無法匯入對應的列。
  • 如果匯入檔案指定的屬性名稱尚未在系統中定義,則不會建立該檔案,也不會匯入其值。

無效的檔案

  • 如果所有列都無效,則無法匯入檔案。
  • 在匯入檔案中指定了不存在的服務資料或複雜的資料名稱,例如 _<non-existing name> 標題。

Adobe Commerce的匯入程式可能無法正確辨識使用位元組順序標籤(BOM)的UTF-8編碼檔案。 包含BOM的檔案可能會在匯入過程中導致問題或失敗。

匯入作業

作業
說明
新增/更新
新產品資料會新增至資料庫中現有專案的現有產品資料中。 所有欄位,除了 sku 可更新。

系統會自動建立匯入資料中指定的新稅捐類別。

匯入檔案中指定的新產品類別會自動建立。

匯入檔案中指定的新SKU會自動建立​

注意: ​對於產品,您可以透過匯入來更新除SKU以外的所有欄位。

重要: 使用無法移除多個欄位值,例如網站或類別 新增/更新 匯入行為。 如果這些欄位未列在CSV檔案中,匯入後會保留在資料庫中。
取代
現有產品資料會被新資料取代。

重要: ​更換資料時請務必小心,因為現有產品資料已清除,而且系統中所有參照都會遺失。

如果匯入資料中的SKU符合現有實體的SKU,所有欄位(包括SKU)都會被刪除,並使用CSV資料建立新記錄。 如果CSV檔案參照的SKU不存在於資料庫中,則會發生錯誤。 您可以檢查資料以顯示錯誤。
刪除
匯入資料中存在於資料庫中的所有實體都會從資料庫中刪除。

刪除會忽略匯入資料中的所有欄,SKU除外。 您可以忽略資料中的所有其他屬性。

如果CSV檔案參照的SKU不存在於資料庫中,則會發生錯誤。 您可以檢查資料以顯示錯誤。

匯入程式

匯入檔案的大小是由以下專案中的設定所決定: php.ini 檔案時。 上的系統訊息 匯入 頁面會指出目前的大小限制。 預設大小為2 MB。

特殊字元(例如等號、大於和小於符號、單引號和雙引號、反斜線、垂直線和&符號)可能會在資料傳輸期間造成問題。 為確保這類特殊字元能正確解譯,可將它們標示為 逸出序列. 例如,如果資料包含文字字串,例如 code="str"code="str2",選擇以雙引號括住文字,可確保原始雙引號能理解為資料的一部分。 當系統遇到雙引號集合時,它知道雙引號外部集合正在封入實際資料。

匯入產品資料時,新產品資料會新增到資料庫中現有的產品資料專案中。 SKU以外的所有欄位都可透過匯入進行更新。 所有現有產品資料都會取代為匯入的新資料。 取代資料時請小心。 所有現有的產品資料都會被清除,而且系統中的所有參照都會遺失。

資料匯入 {width="600" modal="regular"}

步驟1:準備資料

  1. 管理員 側欄,前往 System > Data Transfer>Import.

  2. 匯入設定,設定 Entity Type 變更為下列其中一項:

    • Advanced Pricing
    • Products
    • Customer Finances
    • Customers and Addresses
    • Customers Main File
    • Customer Addresses
    • Stock Sources
  3. 按一下 Download Sample File.

  4. 在網頁瀏覽器的下載位置找到匯出檔案,然後開啟檔案。

    範例檔案包含具有產品型別預留位置資料的欄標題。

    匯入資料範例檔案 {width="600" modal="regular"}

  5. 檢查範例檔案的結構,並使用它來準備CSV匯入檔案,確保欄標題拼寫正確。

  6. 確認匯入檔案的大小沒有超過訊息中所顯示的限制。

    資料匯入大小通知 {width="600"}

  7. 如果匯入資料包含產品影像的路徑,請確定影像檔案已上傳至適當位置。

    Commerce伺服器上的預設位置為: pub/media/import.

    如果影像位於外部伺服器上,請確定您具有包含影像的目錄的完整URL。

步驟2:選擇匯入行為

資料匯入行為 {width="600" modal="regular"}

  1. 設定 Import Behavior 變更為下列其中一項:

    • Add/Update (對於產品,您可以透過匯入來更新除SKU以外的所有欄位。)
    • Replace
    • Delete
  2. 若要判斷匯入資料時遇到錯誤時會發生什麼情況,請選擇下列其中一項:

    • Stop on Error
    • Skip error entries
  3. Allowed Errors Count,輸入匯入取消前可能發生的錯誤數。

    預設值為10。

  4. 接受逗號(,)用於 Field separator.

  5. 接受逗號(,)用於 Multiple value separator.

    在CSV檔案中,逗號是預設分隔符號。 若要使用其他字元,請確定CSV檔案中的資料符合您指定的字元。

  6. 接受預設值 _EMPTY_VALUE_Empty attribute value constant.

  7. 如果您想要將資料中可能找到的任何特殊字元括為 逸出序列,選取 Fields Enclosure 核取方塊。

步驟3:識別匯入檔案

資料匯入檔案 {width="600" modal="regular"}

  1. 按一下 Choose File 以選取要匯入的檔案。

  2. 尋找您準備匯入的CSV檔案,然後按一下  Open.

  3. Images File Directory,輸入儲存已上傳影像之Commerce伺服器位置的相對路徑。

    例如: product_images.

    note note
    NOTE
    開始使用Adobe Commerce和Magento Open Source 2.3.2 版本,中指定的路徑 Images File Directory ​串連以匯入至影像基礎目錄: <Magento-root-folder>/var/import/images. 例如,將 product_images 中的檔案 <Magento-root-directory>/var/import/images/product_images 資料夾。 匯入影像基本目錄可在以下位置設定: \Magento\ImportExport\etc\config.xml 檔案。 如果已啟用遠端儲存模組,請將檔案匯入 <remote-storage-root-directory>/var/import/images/product_images 資料夾。

    若要進一步瞭解如何匯入產品影像,請參閱 匯入產品影像.

步驟4:檢查匯入資料

  1. 在右上角,按一下  Check Data.

  2. 請稍候片刻,等候驗證程式完成。

    如果匯入資料有效,會顯示下列訊息:

    成功訊息 — 檔案有效 {width="600"}

  3. 如果檔案有效,請按一下 Import.

    否則,請修正訊息中所列資料的每個問題,然後再次嘗試匯入檔案。

  4. 匯入程式會持續到資料結尾,除非發生錯誤。

    如果「驗證結果」中出現錯誤訊息,請更正資料中的問題並再次匯入檔案。

    錯誤訊息 — URL索引鍵已存在 {width="600"}

    當匯入完成時,會出現一則訊息。

匯入歷史記錄

Commerce會維護已匯入至您商店的資料記錄,包括開始日期和時間、使用者、執行時間,以及匯入檔案的連結。 此 執行時間 是匯入流程的持續時間。

若要檢視匯入歷史記錄,請執行下列動作:

管理員 側欄,前往 System > Data Transfer>Import History.

資料匯入歷史記錄 {width="600" modal="regular"}

NOTE
依預設,匯入歷史記錄檔案位於 <Magento-root-directory>/var/import_history 資料夾。 如果已啟用遠端儲存模組,則匯入歷史記錄檔案位於 <remote-storage-root-directory>/import_export/import_history 資料夾。
欄位
說明
ID
用於指定轉移的內部編號。
Start Date & Time
進行轉移的特定日期和時間。
User
進行轉移的客戶。
Imported file
下載匯入檔案的連結。
Error file
對應的錯誤檔案。
Execution Time
匯入流程的時間間隔。
Summary
建立、更新和刪除的專案數,或錯誤訊息。

若要下載 匯入/錯誤 檔案,按一下 Download.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1