Magento 2: 外部ソースから製品をインポートする

Magento は電子商取引ソリューションです。 販売に伴う倉庫管理や物流、財務会計よりも製品の販売を目的としています。 他のアプリケーション (ERP システムなど) は、付随するアプリケーションに適しています。 したがって、Magento を使用する際には、ストアをこれらの他のシステム (1C など) と統合する作業が頻繁に発生します。

一般に、統合は次のようにしてデータ レプリケーションに集約できます。

• カタログ (製品、カテゴリ);
• 在庫データ（倉庫内の製品残高と価格）。
• クライアント。
• 命令。

Magento は、データベース内のデータを操作するためのオブジェクトの別のクラスを提供します。 リポジトリ。 Magento の特性により、リポジトリを介してデータベースにデータを追加するのはコーディングが簡単ですが、たとえば、時間がかかります。 この出版物では、リポジトリ クラスを使用する「古典的な」方法でプログラムによって Magento 2 に製品を追加する主な段階について考察します。

顧客と注文は通常、Magento から外部 ERP システムへという逆方向に複製されます。 したがって、Magento 側では適切なデータを選択して、「私たちの側から銃弾が飛び出した"

データをデータベースに記録する原則

現時点では、Magento でプログラムによってデータベースに保存されたオブジェクトを作成するには、 工場:

function __construct (MagentoCmsModelBlockFactory $blockFactory) {
    $this->blockFactory = $blockFactory;
}

/** @var MagentoCmsModelBlock $block */
$block = $this->blockFactory->create();

データベースへの書き込みは、 倉庫:

function __construct (MagentoCmsApiBlockRepositoryInterface $blockRepo) {
    $this->blockRepo = $blockRepo;
}

$this->blockRepo->save($block);

「ファクトリー」と「リポジトリ」のアプローチは、Magento 2 ドメインのすべての主要モデルに使用できます。

製品基本情報

Magento 2.3のバージョンと一致するデータ構造を検討しています。 製品に関する最も基本的な情報は表に記載されています catalog_product_entity (製品登録):

entity_id
attribute_set_id
type_id
sku
has_options
required_options
created_at
updated_at

商品はXNUMX種類に限らせていただきます(type_id='simple')、デフォルト属性のセット (attribute_set_id=4) 属性を無視します has_options и required_options。 属性があるので、 entity_id, created_at и updated_at は自動的に生成されるため、実際に新しい製品を追加するには、設定するだけで済みます。 sku。 私はこれをします：

/** @var MagentoCatalogApiDataProductInterfaceFactory $factProd */
/** @var MagentoCatalogApiProductRepositoryInterface $repoProd */
/** @var MagentoCatalogApiDataProductInterface $prod */
$prod = $factProd->create();
$prod->setAttributeSetId(4);
$prod->setTypeId('simple');
$prod->setSku($sku);
$repoProd->save($prod);

そして例外が発生します:

The "Product Name" attribute value is empty. Set the attribute and try again.

リクエストに製品名を追加すると、属性が欠落しているというメッセージが表示されます Price。 価格を追加すると、製品がデータベースに追加されます。

$prod = $factProd->create();
$prod->setAttributeSetId(4);
$prod->setTypeId('simple');
$prod->setSku($sku);
$prod->setName($name);
$prod->setPrice($price);
$repoProd->save($prod);

製品名は製品の varchar 属性テーブル (catalog_product_entity_varchar)、価格 - 表内 catalog_product_entity_decimal。 製品を追加する前に、データのインポートに管理ストアフロントを使用していることを明示的に示すことをお勧めします。

/** @var MagentoStoreModelStoreManagerInterface $manStore */
$manStore->setCurrentStore(0);

追加属性

Magento を使用して追加の製品属性を処理するのは楽しいことです。 主要エンティティの EAV データ モデル (表を参照) eav_entity_type) は、このプラットフォームの重要な機能の XNUMX つです。 適切な属性を製品モデルに追加するだけです。

$prodEntity->setData('description', $desc);
$prodEntity->setData('short_description', $desc_short);
// или
$prodEntity->setDescription($desc);
$prodEntity->setShortDescription($desc_short);

リポジトリ オブジェクトを介してモデルを保存する場合:

$repoProd->save($prod);

追加の属性も、対応するデータベース テーブルに格納されます。

インベントリデータ

簡単に言えば、製品の在庫量です。 Magento 2.3 では、インベントリ データを保存するための形式を記述するデータベース内の構造は次のとおりです。 大きく異なる 以前に起こったことから。 ただし、製品モデルを介して製品の在庫数量を追加することは、他の属性を追加することよりもそれほど難しいことではありません。

/** @var MagentoCatalogModelProduct $prodEntity */
/** @var MagentoCatalogApiProductRepositoryInterface $repoProd */
$inventory = [
    'is_in_stock' => true,
    'qty' => 1234
];
$prodEntity->setData('quantity_and_stock_status', $inventory);
$repoProd->save($prodEntity);

メディア

一般に、店舗 (電子商取引) での顧客に対する製品のメディア サポートは、社内会計システム (ERP) での従業員に対する同じ製品のメディア サポートとは異なります。 前者の場合は、製品を対面で見せることをお勧めしますが、後者の場合は、製品の一般的なアイデアを伝えるだけで十分です。 ただし、少なくとも製品の主要イメージを転送することは非常に一般的です。 case データをインポートするとき。

管理パネルから画像を追加すると、画像は最初に一時ディレクトリ (./pub/media/tmp/catalog/product)、製品を保存するときのみ、メディア ディレクトリ (./pub/media/catalog/product）。 また、管理パネルから追加すると画像にタグが付けられます image, small_image, thumbnail, swatch_image.

/** @var MagentoCatalogApiProductRepositoryInterface $repoProd */
/** @var MagentoCatalogModelProductGalleryCreateHandler $hndlGalleryCreate */
/* $imagePath = '/path/to/file.png';  $imagePathRelative = '/f/i/file.png' */
$imagePathRelative = $this->imagePlaceToTmpMedia($imagePath);
/* reload product with gallery data */
$product = $repoProd->get($sku);
/* add image to product's gallery */
$gallery['images'][] = [
    'file' => $imagePathRelative,
    'media_type' => 'image'
    'label' => ''
];
$product->setData('media_gallery', $gallery);
/* set usage areas */
$product->setData('image', $imagePathRelative);
$product->setData('small_image', $imagePathRelative);
$product->setData('thumbnail', $imagePathRelative);
$product->setData('swatch_image', $imagePathRelative);
/* create product's gallery */
$hndlGalleryCreate->execute($product);

何らかの理由で、最初に製品を保存し、リポジトリから再度取得した後にのみメディアがリンクされます。 そして、属性を指定する必要があります label 製品メディア ギャラリーにエントリを追加するとき (そうでない場合は例外が発生します) Undefined index: label in .../module-catalog/Model/Product/Gallery/CreateHandler.php on line 516).

Категории

多くの場合、ストアとバックエンド アプリケーションのカテゴリ構造、またはストア内の製品の配置は大幅に異なる場合があります。 カテゴリとそのカテゴリ内の製品に関するデータを移行する戦略は、多くの要因によって異なります。 この例では、次のことにこだわります。

• バックエンド カテゴリとストア カテゴリは名前で比較されます。
• ストアにないカテゴリがインポートされた場合、そのカテゴリはルート カテゴリの下に作成されます (Default Category)、ストア カタログ内でのその後の位置は手動で想定されます。
• 製品は、ストアで作成されたとき (最初のインポート時) にのみカテゴリに割り当てられます。

カテゴリに関する基本情報は表に記載されています catalog_category_entity (カテゴリのカタログ)。 Magento でカテゴリーを作成する:

/** @var MagentoCatalogApiDataCategoryInterfaceFactory $factCat */
/** @var MagentoCatalogApiCategoryRepositoryInterface $repoCat */
$cat = $factCat->create();
$cat->setName($name);
$cat->setIsActive(true);
$repoCat->save($cat);

製品をカテゴリにリンクするには、カテゴリ ID と製品 SKU を使用します。

/** @var MagentoCatalogModelCategoryProductLinkFactory $factCatProdLink */
/** @var MagentoCatalogApiCategoryLinkRepositoryInterface $repoCatLink */
$link = $factCatProdLink->create();
$link->setCategoryId($catMageId);
$link->setSku($prodSku);
$repoCatLink->save($link);

合計で

製品をプログラムで Magento 2 に追加するコードを記述するのは非常に簡単です。 上記のすべてをデモ モジュールに結合しました。」フランサー32/mage2_ext_demo_import」。 モジュールにはコンソール コマンドが XNUMX つだけあります fl32:import:prod、JSON ファイルに記述されている製品をインポートします。./etc/data/products.json「：

[
  {
    "sku": "...",
    "name": "...",
    "desc": "...",
    "desc_short": "...",
    "price": ...,
    "qty": ...,
    "categories": ["..."],
    "image_path": "..."
  }
]

輸入用の写真はカタログにあります ./etc/data/img.

この方法を使用して 10 個の製品をインポートする時間は、私のラップトップでは約 10 秒です。 この考えをさらに発展させると、3600 時間あたり約 100 個の製品を輸入でき、30 万個の製品を輸入するには約 XNUMX 時間かかるという結論に達するのは容易です。 ラップトップをサーバーに置き換えることで、状況をある程度スムーズにすることができます。 もしかしたら数回もあるかもしれない。 しかし、桁違いではありません。 おそらく、この速さと遅さは、ある程度、プロジェクトが誕生した理由のXNUMXつです。 マジェント/非同期インポート.

インポート速度を上げる根本的な解決策は、データベースに直接入力することかもしれませんが、この場合、Magento の拡張性に関するすべての「利点」が失われます。すべてを「高度な」自分で行う必要があります。 ただし、それだけの価値はあります。 それがうまくいったら、次の記事でデータベースに直接書き込むアプローチを検討します。

出所： habr.com