🥇Magento 2: toodete importimine välistest allikatest

Magento on e-kaubanduse lahendus, mis on rohkem suunatud toodete müügile kui sellega seotud laondus-, logistika- või rahanduse haldamisele. Nende ülesannete tegemiseks sobivad paremini teised rakendused (näiteks ERP-süsteemid). Seetõttu tekib Magento kasutamisel üsna tihti vajadus kaupluse integreerimiseks nende teiste süsteemidega (näiteks 1C-ga).

Suuresti saab integreerimise vähendada andmete replikatsiooniks järgmistele:

kataloogile (tooted, kategooriad);
inventariandmetele (toodete jäägid laos ja hinnad);
klientidele;
tellimustele;

Magento pakub andmete manustamiseks andmebaasis eraldi objektiklassi — hoidlad. Magento spetsiifika tõttu on andmete lisamine andmebaasi repodega suhteliselt kooditav, kuid toimub, ütleme nii, mitte väga kiiresti. Selles publikatsioonis käsitlen Magento 2-s toote „klassikalise” lisamise põhietappe — kasutades repo klasse.

Kliente ja tellimusi replitakse tavaliselt teise suunda — Magento’st väliste ERP-süsteemide juurde. Seetõttu on nendega lihtsam, Magento poolel tuleb lihtsalt valida vastavad andmed ja edasi — “meie poolt tulid kuulid välja«.

Andmete salvestamise põhimõtted

Praegu tehakse salvestatavate objektide loomine programmilisel viisil Magento-s läbi Factory:

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

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

ja andmebaasi kirjutamine toimub läbi Repository:

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

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

„Factory” ja „Repository” lähenemist saab rakendada kõigi peamiste mudelite puhul Magento 2 teema valdkonnas.

Toote põhiteave

Käsitlen andmestruktuuri, mis vastab versioonile Magento 2.3. Kõige põhjalikum teave toote kohta asub tabelis catalog_product_entity (toodete register):

entity_id
attribute_set_id
type_id
sku
has_options
required_options
created_at
updated_at

Piirdun ühe tootetüübiga (type_id='simple'), vaikimisi atribuutide kogumiga (attribute_set_id=4) ja jätn silma alt attribuudid has_options ja required_options. Kuna atribuudid entity_id, created_at ja updated_at genereeritakse automaatselt, piisab, et uue toote lisamiseks tuleb lihtsalt määrata sku. Teen nii:

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

ja saan tõrke:

Atribuudi "Toote nimi" väärtus on tühi. Määrake atribuut ja proovige uuesti.

Lisab tootele nime ja saan teate, et atribuut on puudu Hind. Pärast hinna lisamist lisatakse toode andmebaasi:

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

Toote nimi salvestatakse varchar-attribuutide tabelisse (catalog_product_entity_varchar), hind — tabelisse catalog_product_entity_decimal. Enne toote lisamist on soovitatav selgelt näidata, et kasutame andmete toimetamiseks haldusteenust:

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

Täiendavad atribuudid

Täiendavate tooteatribuutide töötlemine Magento abil on tõeline nauding. EAV-andmemudel peamiste üksuste jaoks (vt tabelit eav_entity_type) — on üks selle platvormi võtmeomadusi. Lihtsalt lisame vastavad atribuudid toote mudelisse:

$prodEntity->setData('description', $desc);
$prodEntity->setData('short_description', $desc_short);
// või
$prodEntity->setDescription($desc);
$prodEntity->setShortDescription($desc_short);

ja mudeli salvestamisel kaudu repo-objekti:

$repoProd->save($prod);

täiendavad atribuudid salvestatakse ka vastavatesse andmebaasi tabelitesse.

Inventariandmed

Lihtsalt öeldes — toote kogus laos. Magento 2.3-s kirjeldavad andmebaasi struktuurid, mis käsitlevad inventariandmete salvestamise formaati, on märkimisväärselt erinevad selle eelkäijast. Siiski, laos oleva toote arvu lisamine toote mudeli kaudu ei ole palju keerulisem kui teiste atribuutide lisamine:

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

Meedia

Üldiselt erineb toote meedia toetamine kliendi jaoks poes (e-kaubandus) sama toote meedia toetamisest töötaja jaoks sise-ERP süsteemis. Esimeses juhul on soovitatav näidata "kaupa näoga", teises — piisab, kui anda toote kohta üldine ülevaade. Siiski, vähemalt algse toote pildi edastamine on üsna levinud case andmete importimisel.

Pildi lisamisel administraatoris salvestatakse pilt esmalt ajutisse katalooge (./pub/media/tmp/catalog/product) ja alles toote salvestamisel liigub see meedia katalooge (./pub/media/catalog/product). Samuti, pildi lisamisel administreerimise kaudu määratakse pildile sildid 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);

Miks on meedia seotav alles toote eelneva salvestamise ja selle uuesti repo-st saamise järel? Ja atribuut tuleb määrata label toote meediagalerii kirje lisamisel (vastasel juhul saame erandi Määramata indeks: label faili .../module-catalog/Model/Product/Gallery/CreateHandler.php real 516).

Kategooriad

Sageli võib poe kategooriate struktuur ja taustarakenduse vahel erineda märkimisväärselt. Kategooriate ja neis olevate toodete andmete edastamise strateegiad sõltuvad paljusid teguritest. Käesolevas näites järgnen järgmisele:

taustarakenduse ja poe kategooriad vastavad nime järgi;
kui imporditakse kategooria, mida poes ei ole, siis luuakse see juurkategooria alla (Default Category) ja selle edasine positsioneerimine poe kataloogis on ette nähtud käsitsi;
toote sidumine kategooriaga toimub ainult toote loomisel poes (esimese impordi korral);

Kategooria põhiteave asub tabelis catalog_category_entity (kategooriate kataloog). Kategooria loomine Magento-s:

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

Toote sidumine kategooriaga toimub kategooria ID ja toote SKU põhjal:

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

Kokkuvõttes

Koodi kirjutamine toote lisamiseks Magento 2-s programmiliselt ei ole keeruline. Kõik eelnevalt väljendatu olen kokku võtnud demomodulis «flancer32/mage2_ext_demo_import«. Moodulis on ainult üks konsooli käsk fl32:import:prod, mis impordib tooteid, mis on kirjeldatud JSON-failis «./etc/data/products.json«:

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

Imporditavad pildid asuvad kataloogis . /etc/data/img.

Kümne toote importimise aeg antud viisil on umbes 10 sekundit minu sülearvutil. Kui seda mõtet edasi arendada, siis on lihtne järeldada, et tunnis võib importida umbes 3600 toodet ja 100K toote importimiseks võib kuluda umbes 30 tundi. Sülearvuti asendamine serveriga võib olukorda oluliselt parandada. Võib-olla isegi mitu korda. Kuid mitte järjest. Ehkki see kiirus võib mingil määral olla üks põhjusi projekti tekkimiseks magento/async-import.

Otsene kirjutamine andmebaasi võib olla radikaalne lahendus importimise kiirusel, kuid sel juhul kaotatakse kõik Magento laiendatavuse eelised — tuleb kõik „laiendatud“ ise teha. Sellegipoolest väärt seda. Kui võimalik, siis kaalun järgmises artiklis lähenemist, kus andmebaasi kirjutatakse otse.

Allikas: habr.com

Magento 2: toodete import välistest allikatest