Magento 2: बाह्य स्त्रोतांकडून उत्पादने आयात करणे

Magento एक ई-कॉमर्स उपाय आहे, म्हणजे. वेअरहाऊसिंग, लॉजिस्टिक किंवा विक्रीसोबत आर्थिक लेखाजोखा यापेक्षा उत्पादने विकणे हे अधिक उद्दिष्ट आहे. इतर ऍप्लिकेशन्स (उदाहरणार्थ, ERP सिस्टीम) सोबत असलेल्या ऍप्लिकेशन्ससाठी अधिक योग्य आहेत. म्हणून, बऱ्याचदा मॅजेन्टो वापरण्याच्या सरावात या इतर सिस्टमसह स्टोअर समाकलित करण्याचे कार्य उद्भवते (उदाहरणार्थ, 1C).

मोठ्या प्रमाणावर, डेटा प्रतिकृतीमध्ये एकत्रीकरण कमी केले जाऊ शकते:

• कॅटलॉग (उत्पादने, श्रेणी);
• इन्व्हेंटरी डेटा (वेअरहाऊस आणि किंमतींमधील उत्पादन शिल्लक);
• ग्राहक;
• आदेश;

Magento डेटाबेसमधील डेटा हाताळण्यासाठी ऑब्जेक्ट्सचा एक वेगळा वर्ग ऑफर करतो - भांडार. मॅजेंटोच्या वैशिष्ट्यांमुळे, रेपॉजिटरीजद्वारे डेटाबेसमध्ये डेटा जोडणे कोड करणे सोपे आहे, परंतु ते हळू हळू आहे. या प्रकाशनात, मी रेपो क्लासेसचा वापर करून - "क्लासिक" मार्गाने Magento 2 मध्ये प्रोग्रॅमॅटिकरित्या उत्पादन जोडण्याच्या मुख्य टप्प्यांचा विचार करतो.

ग्राहक आणि ऑर्डर सामान्यतः दुसऱ्या दिशेने - Magento पासून बाह्य ERP सिस्टीमपर्यंत प्रतिरूपित केल्या जातात. म्हणून, त्यांच्यासाठी हे सोपे आहे, मॅजेन्टो बाजूला आपल्याला फक्त योग्य डेटा निवडण्याची आवश्यकता आहे आणि नंतर “आमच्या बाजूने गोळ्या निघाल्या".

डेटाबेसमध्ये डेटा रेकॉर्ड करण्याची तत्त्वे

या क्षणी, 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);

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

श्रेण्या

बऱ्याचदा, स्टोअरची श्रेणी रचना आणि बॅकएंड ऍप्लिकेशन किंवा त्यातील उत्पादनांची प्लेसमेंट लक्षणीय भिन्न असू शकते. त्यामधील श्रेण्या आणि उत्पादनांबद्दल डेटा स्थलांतरित करण्याच्या धोरणे अनेक घटकांवर अवलंबून असतात. या उदाहरणात मी खालील गोष्टींना चिकटून आहे:

• बॅकएंड आणि स्टोअर श्रेणींची तुलना नावाने केली जाते;
• स्टोअरमध्ये नसलेली श्रेणी आयात केली असल्यास, ती मूळ श्रेणी अंतर्गत तयार केली जाते (Default Category) आणि स्टोअर कॅटलॉगमध्ये त्याची पुढील स्थिती व्यक्तिचलितपणे गृहीत धरली जाते;
• एखादे उत्पादन स्टोअरमध्ये तयार केल्यावरच श्रेणीला नियुक्त केले जाते (प्रथम आयात);

श्रेणीबद्दल मूलभूत माहिती टेबलमध्ये आहे catalog_category_entity (श्रेणींचा कॅटलॉग). Magento मध्ये श्रेणी तयार करणे:

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

श्रेणी आयडी आणि उत्पादन 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 उत्पादने आयात केली जाऊ शकतात आणि 100K उत्पादने आयात करण्यासाठी सुमारे 30 तास लागू शकतात. सर्व्हरसह लॅपटॉप बदलणे आपल्याला परिस्थिती थोडीशी सहजतेने करण्यास अनुमती देते. कदाचित अनेक वेळा. पण मोठेपणाच्या आदेशाने नाही. कदाचित हा वेग आणि संथपणा हे काही प्रमाणात प्रकल्पाच्या उदयाचे एक कारण आहे. magento/async-import.

आयातीचा वेग वाढवण्याचा मूलगामी उपाय म्हणजे डेटाबेसमध्ये थेट प्रवेश असू शकतो, परंतु या प्रकरणात मॅजेंटोच्या विस्तारिततेशी संबंधित सर्व "गुडीज" गमावल्या आहेत - तुम्हाला सर्वकाही "प्रगत" करावे लागेल. तथापि, तो वाचतो आहे. जर ते कार्य करत असेल तर, मी पुढील लेखात डेटाबेसवर थेट लेखन करण्याच्या दृष्टिकोनाचा विचार करेन.

स्त्रोत: www.habr.com