データの読み込み
すべての商品タイプのデータをストアに読み込むことができます。 さらに、製品、詳細な価格データ、顧客データ、顧客アドレスデータ、製品画像をインポートできます。 インポートでは、次の操作をサポートしています。
- 追加/更新
- 置換
- 削除
読み込みガイドライン
新規エンティティ
- エンティティは、CSV ファイルで指定された属性値で追加されます。
- デフォルト値が設定されていない必須属性では、値がないか無効な値の場合、エンティティ(対応する行)をインポートできません。
- デフォルト値が設定されている必須属性の場合、エンティティ(対応する 1 行)がインポートされ、値がない場合または無効な値がある場合は、属性のデフォルト値が設定されます。
- 複合データが有効でない場合、エンティティ(対応する 1 つまたは複数の行)をインポートできません。
既存のエンティティ
- 複雑なデータではない属性の場合、インポート・ファイルの値は、不要な属性の空の値を含めて、既存の値を置き換えます。
- 必須の属性に値がない場合や、無効な値がある場合、既存の値は置き換えられません。
- エンティティの複合データが無効な場合は、インポート動作ドロップダウンメニューで「エンティティを削除」を選択した場合を除き、エンティティ(対応する行)をインポートできません。
複雑なデータ
インポートファイルで指定された属性が存在し、その値が定義済みの値のセットから派生する場合は、次の処理が適用されます。
- 値が定義された値のセットにまだ含まれていない場合、行をインポートして、属性のデフォルト値(定義されている場合)を設定できます。
- 値が定義済みのセットに既に含まれている場合、対応する行はインポートできません。
- 読み込みファイルに、システムで定義されていない属性名が指定されている場合、その属性名は作成されず、その値は読み込まれません。
無効なファイル
- すべての行が無効な場合、ファイルをインポートすることはできません。
- 存在しないサービスデータまたは複合データ名(を含む列など)がインポートファイルで指定されている。
_<non-existing name>
見出し。
Adobe Commerceのインポートプロセスでは、UTF-8 でエンコードされ、バイト順マーク(BOM)を使用するファイルが正しく認識されない場合があります。 BOM を含むファイルは、インポート処理中に問題やエラーが発生する可能性があります。
インポート操作
sku
を更新できます。インポートデータで指定された新しい税クラスは、自動的に作成されます。
インポートファイルで指定された新しい製品カテゴリが自動的に作成されます。
インポートファイルで指定された新しい SKU が自動的に作成されます
注意: 製品の場合は、読み込みを通じて、SKU を除くすべてのフィールドを更新できます。
重要: Web サイトやカテゴリなど、複数のフィールド値は、 追加/更新 読み込み動作。 これらのフィールドが CSV ファイルにリストされていない場合、読み込み後もデータベースに残ります。
重要: データを置き換える際は、既存の製品データが消去され、システム内のすべての参照が失われるので、注意が必要です。
インポートデータの SKU が既存のエンティティの SKU と一致する場合、SKU を含むすべてのフィールドが削除され、CSV データを使用して新しいレコードが作成されます。 CSV ファイルが参照している SKU がデータベースに存在しない場合、エラーが発生します。 データを確認すると、エラーを表示できます。
削除では、SKU を除く、インポートデータ内のすべての列が無視されます。 データ内のその他すべての属性は無視できます。
CSV ファイルが参照している SKU がデータベースに存在しない場合、エラーが発生します。 データを確認すると、エラーを表示できます。
読み込みプロセス
読み込みファイルのサイズは、 php.ini
ファイルをサーバー上に置きます。 に関するシステムメッセージ インポート ページは、現在のサイズ制限を示します。 デフォルトサイズは 2 MB です。
特殊文字(等号、記号より大きいまたは小さい、一重引用符と二重引用符、バックスラッシュ、パイプ、アンパサンド記号など)は、データ転送中に問題を引き起こす可能性があります。 このような特殊文字を正しく解釈するには、 エスケープシーケンス. 例えば、データに次のようなテキスト文字列が含まれている場合 code="str"
, code="str2"
を選択してテキストを二重引用符で囲むと、元の二重引用符がデータの一部と理解されます。 システムが二重引用符の二重セットに遭遇すると、外側の二重引用符セットが実際のデータを囲んでいることを認識します。
製品データをインポートすると、新しい製品データがデータベース内の既存の製品データエントリに追加されます。 SKU を除くすべてのフィールドは、読み込みを通じて更新できます。 既存の製品データはすべて、読み込んだ新しいデータに置き換えられます。 データを置き換える際は注意が必要です。 既存の製品データがすべて消去され、システム内のすべての参照が失われます。
手順 1:データを準備
-
日 Admin サイドバー、に移動 System > Data Transfer>Import.
-
次の下 設定を読み込み、設定 Entity Type を次のいずれかに変更します。
Advanced Pricing
Products
Customer Finances
Customers and Addresses
Customers Main File
Customer Addresses
Stock Sources
-
クリック Download Sample File.
-
Web ブラウザーのダウンロード先にあるエクスポートファイルを探して開きます。
サンプルファイルには、製品タイプのプレースホルダーデータを含んだ列見出しが含まれています。
-
サンプルファイルの構造を調べ、それを使用して CSV インポートファイルを準備します。列見出しが正しく入力されていることを確認します。
-
インポートファイルのサイズが、メッセージに表示される制限を超えていないことを確認します。
-
読み込みデータに製品画像へのパスが含まれている場合は、画像ファイルが適切な場所にアップロードされていることを確認してください。
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_VALUE_
(用) Empty attribute value constant. -
データに含まれる可能性のある特殊文字を エスケープシーケンス を選択し、 Fields Enclosure チェックボックス。
手順 3:インポートファイルの特定
-
クリック Choose File 読み込むファイルを選択します。
-
読み込む CSV ファイルを見つけて、クリックします Open.
-
の場合 Images File Directory:アップロードされた画像が保存されるCommerce サーバー上の場所の相対パスを入力します。
例:
product_images
.note note NOTE Adobe CommerceとMagento Open Sourceの概要 2.3.2
release、で指定されたパス 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.
-
検証プロセスが完了するまで、しばらくお待ちください。
インポートデータが有効な場合は、次のメッセージが表示されます。
-
ファイルが有効な場合、 Import.
それ以外の場合は、メッセージにリストされているデータの各問題を修正し、ファイルを再度インポートしてください。
-
エラーが発生しない限り、読み込みプロセスはデータの最後まで続行されます。
検証結果にエラーメッセージが表示された場合は、データの問題を修正し、ファイルを再度読み込みます。
読み込みが完了すると、メッセージが表示されます。
履歴を読み込み
Commerceには、ストアに読み込まれたデータ(開始日時、ユーザー、実行時刻、読み込まれたファイルへのリンクなど)の記録が保持されます。 この 実行時間 は、読み込みプロセスの期間です。
読み込み履歴を表示するには:
日 Admin サイドバー、に移動 System > Data Transfer>Import History.
<Magento-root-directory>/var/import_history
フォルダー。 リモートストレージモジュールが有効な場合、インポート履歴ファイルは <remote-storage-root-directory>/import_export/import_history
フォルダー。をダウンロードします インポート/エラー ファイル、クリック Download.