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

Медиуми

Како по правило, медиумската поддршка за производ за клиент во продавница (е-трговија) ​​се разликува од медиумската поддршка за истиот производ за вработен во внатрешен сметководствен систем (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).

Категории

Често, структурата на категоријата на продавницата и апликацијата за заднина или сместувањето на производите во нив може значително да се разликуваат. Стратегиите за мигрирање на податоци за категориите и производите во нив зависат од многу фактори. Во овој пример се задржувам на следново:

• Категориите на заднината и продавницата се споредуваат по име;
• ако е увезена категорија која не е во продавницата, тогаш таа се креира под категоријата root (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 часа за увоз на 30 илјади производи. Заменувањето на лаптопот со сервер ви овозможува малку да ја измазнете ситуацијата. Можеби дури и неколку пати. Но, не по наредби на големина. Можеби оваа брзина и бавност е до одреден степен една од причините за појавата на проектот магенто/асинк-увоз.

Радикално решение за зголемување на брзината на увоз би можело да биде директен влез во базата на податоци, но во овој случај сите „добри“ во однос на екстензивноста на Magento се изгубени - ќе мора да направите сè „напредно“ сами. Сепак, вреди. Ако успее, ќе го разгледам пристапот со директно пишување во базата во следната статија.

Извор: www.habr.com