匯入資料

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

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

匯入准則

新實體

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

現有實體

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

複雜資料

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

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

無效的檔案

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

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

匯入作業

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

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

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

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

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

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

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

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

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

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

匯入程式

匯入檔案的大小是由伺服器上php.ini檔案中的設定所決定。 匯入 ​頁面上的系統訊息指出目前的大小限制。 預設大小為2 MB。

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

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

資料匯入

步驟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:選擇匯入行為

資料匯入行為

  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 attribute value constant ​的預設值_EMPTY_VALUE_

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

步驟3:識別匯入檔案

資料匯入檔案

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

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

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

    例如: product_images

    note note
    NOTE
    從Adobe Commerce和Magento Open Source2.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

資料匯入歷程記錄

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