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);

Подходът „Factory“ и „Repository“ може да се използва за всички основни модели в домейна на Magento 2.

Основна информация за продукта

Гледам структура от данни, която съответства на версия на Magento 2.3. Най-основната информация за продукта е в таблицата catalog_product_entity (продуктов регистър):

entity_id
attribute_set_id
type_id
sku
has_options
required_options
created_at
updated_at

Ограничен съм до един вид продукт (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) е една от ключовите характеристики на тази платформа. Ние просто добавяме подходящите атрибути към продуктовия модел:

$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);

Средства

По правило медийната поддръжка на продукт за клиент в магазин (e-commerce) се различава от медийната поддръжка на същия продукт за служител във вътрешна счетоводна система (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).

Категории

Често категорийната структура на магазина и бекенд приложението или разположението на продуктите в тях могат да се различават значително. Стратегиите за мигриране на данни за категории и продукти в тях зависят от много фактори. В този пример се придържам към следното:

• backend и store категориите се сравняват по име;
• ако се импортира категория, която не е в магазина, тогава тя се създава под основната категория (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 е доста лесно. Комбинирах всичко изброено по-горе в демо модул “flancer32/mage2_ext_demo_import". В модула има само една конзолна команда 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 часа за импортиране на 30K продукта. Замяната на лаптоп със сървър ви позволява донякъде да изгладите ситуацията. Може би дори няколко пъти. Но не по порядъци. Може би тази бързина и мудност до известна степен е една от причините за възникването на проекта magento/async-импортиране.

Радикално решение за увеличаване на скоростта на импортиране може да бъде директно влизане в базата данни, но в този случай всички „благини“ по отношение на разширяемостта на Magento се губят - ще трябва да направите всичко „напреднало“ сами. Въпреки това си заслужава. Ако се получи, ще разгледам подхода с директно писане в базата данни в следващата статия.

Източник: www.habr.com