Magento 2: პროდუქტების იმპორტი გარე წყაროებიდან

Magento არის ელექტრონული კომერციის გადაწყვეტა, ე.ი. უფრო მეტად მიმართულია პროდუქციის გაყიდვაზე, ვიდრე გაყიდვების თანმხლები სასაწყობო, ლოგისტიკის ან ფინანსური აღრიცხვისთვის. სხვა აპლიკაციები (მაგალითად, ERP სისტემები) უფრო შესაფერისია თანმხლები აპლიკაციებისთვის. ამიტომ, Magento–ს გამოყენების პრაქტიკაში საკმაოდ ხშირად ჩნდება მაღაზიის ამ სხვა სისტემებთან (მაგალითად, 1C) ინტეგრირების ამოცანა.

მთლიანობაში, ინტეგრაცია შეიძლება შემცირდეს მონაცემთა რეპლიკაციამდე:

• კატალოგი (პროდუქტები, კატეგორიები);
• ინვენტარიზაციის მონაცემები (პროდუქტის ნაშთები საწყობებში და ფასები);
• კლიენტები;
• შეკვეთები;

Magento გთავაზობთ ობიექტების ცალკეულ კლასს მონაცემთა მანიპულირებისთვის მონაცემთა ბაზაში - საცავები. Magento-ს სპეციფიკიდან გამომდინარე, მონაცემთა ბაზაში მონაცემთა დამატება საცავებში ადვილია კოდირება, მაგრამ, ვთქვათ, ნელია. ამ პუბლიკაციაში განვიხილავ Magento 2-ში პროდუქტის პროგრამულად დამატების ძირითად ეტაპებს "კლასიკური" გზით - რეპო კლასების გამოყენებით.

მომხმარებლები და შეკვეთები ჩვეულებრივ მეორდება სხვა მიმართულებით - მაგენტოდან გარე ERP სისტემებამდე. ამიტომ, მათთან უფრო მარტივია, მაგენტოს მხარეს თქვენ უბრალოდ უნდა აირჩიოთ შესაბამისი მონაცემები და შემდეგ "ჩვენი მხრიდან ტყვიები გადმოფრინდა".

მონაცემთა ბაზაში ჩაწერის პრინციპები

ამ დროისთვის, მონაცემთა ბაზაში შენახული ობიექტების შექმნა პროგრამულად მაგენტოში ხდება Factory:

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

მე შემოიფარგლება ერთი ტიპის პროდუქტით (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).

კატეგორია

ხშირად, მაღაზიის კატეგორიის სტრუქტურა და backend აპლიკაცია ან მათში პროდუქციის განთავსება შეიძლება მნიშვნელოვნად განსხვავდებოდეს. კატეგორიებისა და მათში შემავალი პროდუქტების შესახებ მონაცემების მიგრაციის სტრატეგიები მრავალ ფაქტორზეა დამოკიდებული. ამ მაგალითში მე ვიცავ შემდეგს:

• backend და store კატეგორიები შედარებულია სახელით;
• თუ კატეგორიაში იმპორტირებულია, რომელიც არ არის მაღაზიაში, მაშინ ის იქმნება 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