מג'נטו 2: ייבוא ​​מוצרים ממקורות חיצוניים

Magento הוא פתרון מסחר אלקטרוני, כלומר. מכוון יותר למכירת מוצרים מאשר למחסנים, לוגיסטיקה או חשבונאות פיננסית הנלווית למכירות. יישומים אחרים (למשל, מערכות ERP) מתאימות יותר ליישומים נלווים. לכן, לעתים קרובות למדי בתרגול השימוש במג'נטו מתעוררת המשימה של שילוב חנות עם מערכות אחרות אלה (לדוגמה, 1C).

בגדול, ניתן לצמצם את האינטגרציה לשכפול נתונים על ידי:

• קטלוג (מוצרים, קטגוריות);
• נתוני מלאי (יתרות מוצרים במחסנים ומחירים);
• לקוחות;
• הזמנות;

מג'נטו מציעה מחלקה נפרדת של אובייקטים למניפולציה של נתונים במסד הנתונים - מאגרים. בשל הפרטים הספציפיים של Magento, הוספת נתונים למסד הנתונים דרך מאגרים קלה לקוד, אבל היא, נניח, איטית. בפרסום זה, אני שוקל את השלבים העיקריים של הוספת מוצר באופן פרוגרמטי למג'נטו 2 בצורה ה"קלאסית" - שימוש במחלקות ריפו.

לקוחות והזמנות משוכפלות בדרך כלל לכיוון השני - ממג'נטו ועד למערכות ERP חיצוניות. לכן, זה פשוט יותר איתם, בצד המג'נטו אתה רק צריך לבחור את הנתונים המתאימים, ואז "כדורים עפו מהצד שלנו".

עקרונות רישום נתונים למסד נתונים

נכון לעכשיו, יצירת אובייקטים שנשמרו במסד הנתונים באופן פרוגרמטי במג'נטו מתבצעת באמצעות בית חרושת:

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

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

והכתיבה למסד הנתונים מתבצעת באמצעות Repository:

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

וכאשר שומרים את המודל דרך אובייקט ה-repo:

$repoProd->save($prod);

תכונות נוספות יאוחסנו גם בטבלאות מסד הנתונים המתאימות.

נתוני מלאי

במילים פשוטות - כמות המוצר במלאי. במג'נטו 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 או מיקום המוצרים בהם יכולים להיות שונים באופן משמעותי. אסטרטגיות להעברת נתונים על קטגוריות ומוצרים בתוכם תלויות בגורמים רבים. בדוגמה זו אני נצמד לדברים הבאים:

• קטגוריות קצה וחנות מושוות לפי שם;
• אם מיובאת קטגוריה שאינה בחנות, היא נוצרת תחת קטגוריית השורש (Default Category) ומיקומו הנוסף בקטלוג החנות מונחה באופן ידני;
• מוצר מוקצה לקטגוריה רק ​​כאשר הוא נוצר בחנות (יבוא ראשון);

מידע בסיסי על הקטגוריה נמצא בטבלה catalog_category_entity (קטלוג קטגוריות). יצירת קטגוריה במג'נטו:

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

קישור מוצר לקטגוריה מתבצע באמצעות מזהה הקטגוריה ומק"ט המוצר:

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

בסך הכל

כתיבת קוד להוספת מוצר באופן פרוגרמטי למג'נטו 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 שעות לייבא 30K מוצרים. החלפת מחשב נייד בשרת מאפשרת להחליק מעט את המצב. אולי אפילו כמה פעמים. אבל לא בסדרי גודל. אולי המהירות והאטיות הזו היא במידה מסוימת אחת הסיבות להופעתו של הפרויקט ייבוא ​​מג'נטו/אסינכרון.

פתרון קיצוני להגברת מהירות הייבוא ​​יכול להיות כניסה ישירה למסד הנתונים, אבל במקרה זה כל ה"טובות" לגבי ההרחבה של מג'נטו הולכים לאיבוד - תצטרך לעשות הכל "מתקדם" בעצמך. עם זאת, זה שווה את זה. אם זה יצליח, אשקול את הגישה עם כתיבה ישירה למאגר במאמר הבא.

מקור: www.habr.com