匯入資料
所有產品型別的資料都可匯入存放區。 此外,您可以匯入產品、進階定價資料、客戶資料、客戶地址資料和產品影像。 匯入支援下列作業:
- 新增/更新
- 取代
- 刪除
匯入准則
新實體
- 實體會以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:準備資料
-
在 管理員 側邊欄上,移至 System > Data Transfer>Import。
-
在 匯入設定 下,將 Entity Type 設定為下列其中一項:
Advanced Pricing
Products
Customer Finances
Customers and Addresses
Customers Main File
Customer Addresses
Stock Sources
-
按一下 Download Sample File。
-
在網頁瀏覽器的下載位置找到匯出檔案,然後開啟檔案。
範例檔案包含具有產品型別預留位置資料的欄標題。
{width="600" modal="regular"}
-
檢查範例檔案的結構,並使用它來準備CSV匯入檔案,確保欄標題拼寫正確。
-
確認匯入檔案的大小沒有超過訊息中所顯示的限制。
{width="600"}
-
如果匯入資料包含產品影像的路徑,請確定影像檔案已上傳至適當位置。
Commerce伺服器上的預設位置為:
pub/media/import
。如果影像位於外部伺服器上,請確定您具有包含影像的目錄的完整URL。
步驟2:選擇匯入行為
-
將 Import Behavior 設定為下列其中一項:
Add/Update
(對於產品,您可以透過匯入來更新除SKU以外的所有欄位。)Replace
Delete
-
若要判斷匯入資料時遇到錯誤時會發生什麼情況,請選擇下列其中一項:
Stop on Error
Skip error entries
-
針對 Allowed Errors Count,輸入在取消匯入之前可能發生的錯誤數目。
預設值為10。
-
接受 Field separator 的逗號(
,
)預設值。 -
接受 Multiple value separator 的逗號(
,
)預設值。在CSV檔案中,逗號是預設分隔符號。 若要使用其他字元,請確定CSV檔案中的資料符合您指定的字元。
-
接受 Empty attribute value constant 的預設值
_EMPTY_VALUE_
。 -
如果要將資料中可能找到的任何特殊字元括為 逸出序列,請選取 Fields Enclosure 核取方塊。
步驟3:識別匯入檔案
-
按一下 Choose File 以選取要匯入的檔案。
-
尋找您準備匯入的CSV檔案,然後按一下 Open。
-
針對 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:檢查匯入資料
-
按一下右上角的 Check Data。
-
請稍候片刻,等候驗證程式完成。
如果匯入資料有效,會顯示下列訊息:
{width="600"}
-
如果檔案有效,請按一下 Import。
否則,請修正訊息中所列資料的每個問題,然後再次嘗試匯入檔案。
-
匯入程式會持續到資料結尾,除非發生錯誤。
如果「驗證結果」中出現錯誤訊息,請更正資料中的問題並再次匯入檔案。
{width="600"}
當匯入完成時,會出現一則訊息。
匯入歷史記錄
Commerce會維護已匯入至您存放區的資料記錄,包括開始日期和時間、使用者、執行時間,以及匯入檔案的連結。 執行時間 是匯入程式的期間。
若要檢視匯入歷程記錄:
在 管理員 側邊欄上,移至 System > Data Transfer>Import History。
<Magento-root-directory>/var/import_history
資料夾中。 如果已啟用遠端儲存模組,則匯入記錄檔案位於<remote-storage-root-directory>/import_export/import_history
資料夾中。若要下載 匯入/錯誤 檔案,請按一下 Download。