मैगेंटो 2: बाहरी स्रोतों से उत्पाद आयात करना

Magento एक ई-कॉमर्स समाधान है, अर्थात्। इसका उद्देश्य वेयरहाउसिंग, लॉजिस्टिक्स या बिक्री के साथ वित्तीय लेखांकन की तुलना में उत्पादों को बेचना अधिक है। अन्य अनुप्रयोग (उदाहरण के लिए, ईआरपी सिस्टम) सहवर्ती अनुप्रयोगों के लिए बेहतर अनुकूल हैं। इसलिए, Magento का उपयोग करने के अभ्यास में अक्सर इन अन्य प्रणालियों (उदाहरण के लिए, 1C) के साथ एक स्टोर को एकीकृत करने का कार्य उत्पन्न होता है।

कुल मिलाकर, एकीकरण को डेटा प्रतिकृति तक कम किया जा सकता है:

• कैटलॉग (उत्पाद, श्रेणियां);
• इन्वेंट्री डेटा (गोदामों और कीमतों में उत्पाद संतुलन);
• ग्राहक;
• आदेश;

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

ग्राहकों और ऑर्डरों को आम तौर पर दूसरी दिशा में दोहराया जाता है - मैगेंटो से बाहरी ईआरपी सिस्टम तक। इसलिए, उनके साथ यह आसान है, 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);

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

उत्पाद का नाम उत्पाद वर्चर विशेषता तालिका में संग्रहीत है (catalog_product_entity_varchar), कीमत - तालिका में catalog_product_entity_decimal. किसी उत्पाद को जोड़ने से पहले, यह स्पष्ट रूप से इंगित करना उचित है कि हम डेटा आयात करने के लिए प्रशासनिक स्टोरफ्रंट का उपयोग कर रहे हैं:

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

अतिरिक्त गुण

Magento का उपयोग करके अतिरिक्त उत्पाद विशेषताओं को संसाधित करना एक खुशी की बात है। मुख्य संस्थाओं के लिए ईएवी डेटा मॉडल (तालिका देखें)। 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);

मीडिया

एक नियम के रूप में, किसी स्टोर (ई-कॉमर्स) में किसी ग्राहक के लिए किसी उत्पाद के लिए मीडिया समर्थन आंतरिक लेखा प्रणाली (ईआरपी) में किसी कर्मचारी के लिए उसी उत्पाद के लिए मीडिया समर्थन से भिन्न होता है। पहले मामले में, उत्पाद को आमने-सामने दिखाने की सलाह दी जाती है; दूसरे में, यह उत्पाद का एक सामान्य विचार देने के लिए पर्याप्त है। हालाँकि, किसी उत्पाद की कम से कम प्राथमिक छवि को स्थानांतरित करना काफी सामान्य है। 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-आयात.

आयात की गति बढ़ाने के लिए एक मौलिक समाधान डेटाबेस में सीधे प्रवेश हो सकता है, लेकिन इस मामले में मैगेंटो की विस्तारशीलता के संबंध में सभी "उपहार" खो गए हैं - आपको सब कुछ "उन्नत" स्वयं करना होगा। हालाँकि, यह इसके लायक है। यदि यह काम करता है, तो मैं अगले लेख में डेटाबेस पर सीधे लिखने के दृष्टिकोण पर विचार करूंगा।

स्रोत: www.habr.com