Magento 2: বাহ্যিক উত্স থেকে পণ্য আমদানি করা

Magento হল একটি ই-কমার্স সমাধান, যেমন গুদামজাতকরণ, লজিস্টিকস বা আর্থিক অ্যাকাউন্টিং বিক্রয়ের সাথে বিক্রির চেয়ে পণ্য বিক্রির লক্ষ্য বেশি। অন্যান্য অ্যাপ্লিকেশনগুলি (উদাহরণস্বরূপ, ইআরপি সিস্টেমগুলি) সহগামী অ্যাপ্লিকেশনগুলির জন্য আরও উপযুক্ত। অতএব, প্রায়শই ম্যাজেন্টো ব্যবহার করার অনুশীলনে এই অন্যান্য সিস্টেমগুলির সাথে একটি স্টোরকে একীভূত করার কাজটি দেখা দেয় (উদাহরণস্বরূপ, 1C)।

ব্যাপকভাবে, ইন্টিগ্রেশন ডেটা প্রতিলিপিতে হ্রাস করা যেতে পারে:

• ক্যাটালগ (পণ্য, বিভাগ);
• ইনভেন্টরি ডেটা (গুদাম এবং দামে পণ্যের ভারসাম্য);
• ক্লায়েন্ট;
• আদেশ;

Magento ডাটাবেসে ডেটা ম্যানিপুলেট করার জন্য বস্তুর একটি পৃথক শ্রেণী অফার করে - সংগ্রহস্থল. Magento এর সুনির্দিষ্টতার কারণে, সংগ্রহস্থলের মাধ্যমে ডাটাবেসে ডেটা যোগ করা কোড করা সহজ, তবে এটি ধীর গতির। এই প্রকাশনায়, আমি রেপো ক্লাস ব্যবহার করে - "ক্লাসিক" উপায়ে ম্যাজেন্টো 2-এ একটি প্রোডাক্ট যোগ করার প্রধান পর্যায়গুলি বিবেচনা করি।

গ্রাহক এবং অর্ডার সাধারণত অন্য দিকে প্রতিলিপি করা হয় - Magento থেকে বাহ্যিক ERP সিস্টেমে। অতএব, এটি তাদের সাথে সহজ, ম্যাজেন্টো দিকে আপনাকে কেবল উপযুক্ত ডেটা নির্বাচন করতে হবে এবং তারপরে "আমাদের পাশ থেকে গুলি উড়ে গেল"।

ডাটাবেসে ডেটা রেকর্ড করার নীতি

এই মুহুর্তে, ম্যাজেন্টোতে প্রোগ্রাম্যাটিকভাবে ডেটাবেসে সংরক্ষিত বস্তু তৈরি করা হয় কারখানা:

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