🥇Magento 2: Dovoz produktů z externích zdrojů

Magento je e-commerce řešení, což znamená, že se více zaměřuje na prodej produktů než na související skladování, logistiku nebo finanční účetnictví. Pro tyto úkoly jsou vhodnější jiné aplikace (například ERP systémy). Proto se v praxi poměrně často používá. Magento vyvstává úkol integrace obchodu s těmito dalšími systémy (například s 1C).

Celkově lze integraci zredukovat na replikaci dat:

katalog (produkty, kategorie);
inventární údaje (zůstatky produktů ve skladech a ceny);
klienti;
objednávky;

Magento Pro manipulaci s daty v databázi je k dispozici samostatná třída objektů - úložišťVzhledem ke specifikům Magento Přidávání dat do databáze prostřednictvím repozitářů je snadné naprogramovat, ale je to, řekněme, pomalé. V tomto příspěvku se budu zabývat hlavními kroky programově přidávaného přidávání dat do Magento 2 produkty „klasickým“ způsobem – pomocí repozitářových tříd.

Klienti a objednávky se obvykle replikují opačným směrem – z Magento do externích ERP systémů. Proto je to s nimi jednodušší, na straně Magento stačí vybrat relevantní data a pak - "kulky vylétly z naší strany".

Principy záznamu dat do databáze

V současné době je vytváření objektů uložených v databázi programově... Magento se provádí prostřednictvím Továrna:

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

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

a zápis do databáze se provádí přes sklad:

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

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

Přístup typu Factory and Repository lze použít pro všechny hlavní modely v dané oblasti. Magento 2.

Základní informace o produktu

Dívám se na datovou strukturu odpovídající verzi Magento 2.3. Nejzákladnější informace o produktu jsou uvedeny v tabulce catalog_product_entity (registr produktů):

entity_id
attribute_set_id
type_id
sku
has_options
required_options
created_at
updated_at

Jsem omezen na jeden typ produktu (type_id='simple'), sada výchozích atributů (attribute_set_id=4) a ignorovat atributy has_options и required_options. Od atributů entity_id, created_at и updated_at jsou generovány automaticky, pak ve skutečnosti pro přidání nového produktu stačí nastavit sku. Dělám to:

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

a dostávám výjimku:

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

Do požadavku přidám název produktu a zobrazí se mi zpráva, že atribut chybí Price. Po přidání ceny je produkt přidán do databáze:

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

Název produktu je uložen v tabulce atributů varchar produktu (catalog_product_entity_varchar), cena - v tabulce catalog_product_entity_decimal. Před přidáním produktu je vhodné výslovně uvést, že k importu dat používáme administrativní výlohu:

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

Další atributy

Zpracování dalších atributů produktu pomocí nástrojů Magento — potěšení. Datový model EAV pro klíčové entity (viz tabulka eav_entity_type) je jednou z klíčových funkcí této platformy. Jednoduše přidáme příslušné atributy do modelu produktu:

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

a při ukládání modelu přes objekt repo:

$repoProd->save($prod);

další atributy budou také uloženy v odpovídajících databázových tabulkách.

Údaje o zásobách

Jednoduše řečeno, jedná se o množství produktu na skladě. Magento 2.3 struktury v databázi popisující formát ukládání inventárních dat, výrazně odlišné z toho, co se stalo předtím. Přidání množství produktu na skladě prostřednictvím modelu produktu však není o mnoho obtížnější než přidání dalších atributů:

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

média

Mediální podpora produktu pro klienta na prodejně (e-commerce) se zpravidla liší od mediální podpory stejného produktu pro zaměstnance v interním účetním systému (ERP). V prvním případě je vhodné ukázat produkt tváří v tvář, ve druhém stačí poskytnout obecnou představu o produktu. Přenést alespoň primární image produktu je však zcela běžné. case při importu dat.

Při přidávání obrázku přes admin panel se obrázek nejprve uloží do dočasného adresáře (./pub/media/tmp/catalog/product) a pouze při ukládání se produkt přesune do adresáře médií (./pub/media/catalog/product). Po přidání prostřednictvím panelu administrátora je obrázek také označen 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);

Z nějakého důvodu je médium propojeno až po prvním uložení produktu a jeho opětovném načtení z úložiště. A musíte zadat atribut label při přidávání záznamu do galerie médií produktu (jinak dostaneme výjimku Undefined index: label in .../module-catalog/Model/Product/Gallery/CreateHandler.php on line 516).

kategorie

Často se může výrazně lišit struktura kategorií obchodu a backendové aplikace nebo umístění produktů v nich. Strategie migrace dat o kategoriích a produktech v nich závisí na mnoha faktorech. V tomto příkladu se držím následujícího:

kategorie backend a store jsou porovnány podle názvu;
pokud je importována kategorie, která není v obchodě, pak je vytvořena pod kořenovou kategorií (Default Category) a jeho další umístění v katalogu prodejen se předpokládá ručně;
produkt je zařazen do kategorie až při jeho vytvoření v obchodě (první import);

Základní informace o kategorii jsou v tabulce catalog_category_entity (katalog kategorií). Vytvořte kategorii v Magento:

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

Propojení produktu s kategorií se provádí pomocí ID kategorie a SKU produktu:

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

Celkem

Napište kód pro přidání Magento 2 produkty se velmi snadno programují. Všechno výše popsané jsem shrnul do demo modulu.flancer32/mage2_ext_demo_import". V modulu je pouze jeden konzolový příkaz fl32:import:prod, který importuje produkty popsané v souboru JSON "./etc/data/products.json„:

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

Obrázky pro import jsou v katalogu ./etc/data/img.

Čas na import 10 produktů pomocí této metody je na mém notebooku asi 10 sekund. Pokud tuto myšlenku dále rozvineme, snadno dojdeme k závěru, že lze dovézt asi 3600 produktů za hodinu a import 100 30 produktů může trvat asi XNUMX hodin. Nahrazení notebooku serverem vám umožní situaci poněkud vyhladit. Možná i několikrát. Ale ne řádově. Možná je tato rychlost a pomalost do jisté míry jedním z důvodů vzniku projektu magento/async-import.

Radikálním řešením pro zvýšení rychlosti importu by mohl být přímý zápis do databáze, ale v tomto případě se ztrácejí všechny výhody spojené s rozšiřitelností. Magento — Všechny ty „pokročilé“ věci si budu muset udělat sám. Přesto to stojí za to. Pokud to půjde, podívám se na přístup přímého zápisu do databáze v příštím článku.

Zdroj: www.habr.com