В מאמר קודם את תהליך ייבוא ​​המוצרים למג'נטו 2 תיארתי בדרך הרגילה – דרך דגמים ומאגרים. לשיטה הרגילה יש מהירות עיבוד נתונים נמוכה מאוד. המחשב הנייד שלי ייצר בערך מוצר אחד בשנייה. בהמשך זה אני שוקל דרך חלופית לייבא מוצר - בכניסה ישירה לבסיס הנתונים, עקיפת מנגנוני מג'נטו 2 הסטנדרטיים (דגמים, מפעלים, מאגרים). ניתן להתאים את רצף השלבים לייבוא ​​מוצרים לכל שפת תכנות שיכולה לעבוד עם MySQL.

כתב ויתור: למג'נטו יש פונקציונליות מוכנה עבור ייבוא ​​נתונים וסביר להניח שזה יספיק לך. עם זאת, אם אתה צריך שליטה מלאה יותר על תהליך הייבוא, לא רק הכנת קובץ CSV למה שיש לך, ברוך הבא לחתול.

ניתן לראות את הקוד הנובע מכתיבת שני המאמרים במודול Magento "flancer32/mage2_ext_demo_import". הנה כמה הגבלות שפעלתי בהן כדי לפשט את קוד מודול ההדגמה:

• מוצרים נוצרים רק, לא מעודכנים.
• מחסן אחד
• רק שמות קטגוריות מיובאים, ללא המבנה שלהם
• מבני נתונים תואמים לגרסה 2.3

JSON לייבוא ​​מוצר בודד:

{
  "sku": "MVA20D-UBV-3",
  "name": "Заглушка для пломбировки ВА47-29 IEK",
  "desc": "Обеспечение доступа к устройствам ...",
  "desc_short": "Заглушка для пломбировки ВА47-29 IEK предназначена для ...",
  "price": 5.00,
  "qty": 25,
  "categories": ["Категория 1", "Категория 2"],
  "image_path": "mva20d_ubv_3.png"
}

סקירה כללית של השלבים העיקריים של הייבוא

• רישום המוצר עצמו
• חיבור בין מוצר לאתר
• תכונות מוצר בסיסיות (EAV)
• נתוני מלאי (כמות המוצר במלאי)
• מדיה (תמונות)
• חיבור לקטגוריות קטלוגיות

רישום המוצר

מידע בסיסי על המוצר ניתן למצוא ב catalog_product_entity:

CREATE TABLE `catalog_product_entity` (
  `entity_id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT 'Entity Id',
  `attribute_set_id` smallint(5) unsigned NOT NULL DEFAULT '0' COMMENT 'Attribute Set ID',
  `type_id` varchar(32) NOT NULL DEFAULT 'simple' COMMENT 'Type ID',
  `sku` varchar(64) DEFAULT NULL COMMENT 'SKU',
  `has_options` smallint(6) NOT NULL DEFAULT '0' COMMENT 'Has Options',
  `required_options` smallint(5) unsigned NOT NULL DEFAULT '0' COMMENT 'Required Options',
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'Creation Time',
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'Update Time',
  PRIMARY KEY (`entity_id`),
  KEY `CATALOG_PRODUCT_ENTITY_ATTRIBUTE_SET_ID` (`attribute_set_id`),
  KEY `CATALOG_PRODUCT_ENTITY_SKU` (`sku`)
)

המידע המינימלי הנדרש ליצירת ערך במרשם המוצר הוא:

• attribute_set_id
• sku

נוֹסָף:

• type_id - אם לא נציין זאת, ייעשה שימוש ב'פשוט'

כדי לכתוב ישירות למסד הנתונים, אני משתמש במתאם ה-DB של Magento עצמו:

function create($sku, $typeId, $attrSetId)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_product_entity');
    $bind = [
        'sku' => $sku,
        'type_id' => $typeId,
        'attribute_set_id' => $attrSetId
    ];
    $conn->insert($table, $bind);
    $result = $conn->lastInsertId($table);
    return $result;
}

לאחר רישום המוצר עם catalog_product_entity זה הופך להיות גלוי בפאנל הניהול, ברשת המוצר (קטלוג/מוצרים).

קשר בין מוצר לאתר

השיוך של המוצר לאתר קובע באילו חנויות ותצוגות המוצר יהיה זמין בחזית.

function linkToWebsite($prodId, $websiteId)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_product_website');
    $bind = [
        'product_id' => $prodId,
        'website_id' => $websiteId
    ];
    $conn->insert($table, $bind);
}

תכונות מוצר בסיסיות

למוצר שנרשם לאחרונה אין עדיין שם או תיאור. כל זה נעשה באמצעות תכונות EAV. להלן רשימה של תכונות מוצר בסיסיות הדרושות על מנת שהמוצר יוצג בצורה נכונה בחזית:

• name
• price
• description
• short_description
• status
• tax_class_id
• url_key
• visibility

למוצר כזה מתווספת תכונה נפרדת (הפרטים של קבלת המזהה וסוג התכונה מהקוד שלו נשמטים):

public function create($prodId, $attrCode, $attrValue)
{
    $attrId = /* get attribute ID by attribute code */
    $attrType = /* get attribute type [datetime|decimal|int|text|varchar]) by attribute code */
    if ($attrId) {
        /** @var MagentoFrameworkAppResourceConnection $this->resource */
        /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
        $conn = $this->resource->getConnection();
        $tblName = 'catalog_product_entity_' . $attrType;
        $table = $this->resource->getTableName($tblName);
        $bind = [
            'attribute_id' => $attrId,
            'entity_id' => $prodId,
            /* put all attributes to default store view with id=0 (admin) */
            'store_id' => 0,
            'value' => $attrValue
        ];
        $conn->insert($table, $bind);
    }
}

באמצעות קוד התכונה, אנו קובעים את המזהה וסוג הנתונים שלו (datetime, decimal, int, text, varchar), ולאחר מכן כתוב את הנתונים עבור חלון הניהול לטבלה המתאימה (store_id = 0).

לאחר הוספת המאפיינים לעיל למוצר, אתה מקבל את התמונה הזו בפאנל הניהול:

נתוני מלאי

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

• cataloginventory_*: מבנה ישן;
• inventory_*: מבנה חדש (MSI - Multi Source Inventory);

אתה צריך להוסיף נתוני מלאי לשני המבנים, כי המבנה החדש עדיין לא עצמאי לחלוטין מהישן (סביר מאוד שעבור default מחסן במבנה החדש מעורב שולחן cataloginventory_stock_status כמו inventory_stock_1).

קטלוגמלאי_

בעת פריסת Magneto 2.3 יש לנו בתחילה 2 כניסות store_website, המתאים לשני אתרים - מנהלי ולקוח ראשי:

website_id|code |name        |sort_order|default_group_id|is_default|
----------|-----|------------|----------|----------------|----------|
         0|admin|Admin       |         0|               0|         0|
         1|base |Main Website|         0|               1|         1|

בטבלה cataloginventory_stock יש לנו רק כניסה אחת:

stock_id|website_id|stock_name|
--------|----------|----------|
       1|         0|Default   |

כלומר, במבנה הישן שלנו יש רק "מחסן" אחד (stock) והוא מקושר לאתר הניהולי. הוספת חדשים דרך פאנל הניהול sources/stocks ב-MSI (מבנה חדש) אינו גורם לערכים חדשים ב cataloginventory_stock.

נתוני מלאי על מוצרים במבנה הישן נרשמים תחילה בטבלאות:

• cataloginventory_stock_item
• cataloginventory_stock_status

cataloginventory_stock_item

function createOldItem($prodId, $qty)
{
    $isQtyDecimal = (((int)$qty) != $qty);
    $isInStock = ($qty > 0);
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('cataloginventory_stock_item');
    $bind = [
        'product_id' => $prodId,
        /* we use one only stock in 'cataloginventory' structure by default */
        'stock_id' => 1,
        'qty' => $qty,
        'is_qty_decimal' => $isQtyDecimal,
        'is_in_stock' => $isInStock,
        /* default stock is bound to admin website (see `cataloginventory_stock`) */
        'website_id' => 0
    ];
    $conn->insert($table, $bind);
}

סטטוס_מלאי_קטלוג

function createOldStatus($prodId, $qty)
{
    $isInStock = ($qty > 0);
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('cataloginventory_stock_status');
    $bind = [
        'product_id' => $prodId,
        /* we use one only stock in 'cataloginventory' structure by default */
        'stock_id' => 1, 
        'qty' => $qty,
        'stock_status' => MagentoCatalogInventoryApiDataStockStatusInterface::STATUS_IN_STOCK,
        /* default stock is bound to admin website (see `cataloginventory_stock`) */
        'website_id' => 0 
    ];
    $conn->insert($table, $bind);
}

מְלַאי_

בתחילה, המבנה החדש לאחסון נתוני מלאי מכיל 1 "מקור"(inventory_source):

source_code|name          |enabled|description   |latitude|longitude|country_id|...|
-----------|--------------|-------|--------------|--------|---------|----------|...|
default    |Default Source|      1|Default Source|0.000000| 0.000000|US        |...|

ואחד "מחסן"(inventory_stock):

stock_id|name         |
--------|-------------|
       1|Default Stock|

«מקור» מייצג את האחסון הפיזי של מוצרים (הרשומה מכילה קואורדינטות פיזיות וכתובת דואר). "הרכב"הוא איחוד לוגי של כמה "מקורות" (inventory_source_stock_link)

link_id|stock_id|source_code|priority|
-------|--------|-----------|--------|
      1|       1|default    |       1|

ברמה שבה מתרחש החיבור לערוץ המכירה (inventory_stock_sales_channel)

type   |code|stock_id|
-------|----|--------|
website|base|       1|

אם לשפוט לפי מבנה הנתונים, מניחים סוגים שונים של ערוצי מכירה, אך כברירת מחדל רק החיבור "מניות"-"אתר אינטרנט"(הקישור לאתר עוקב אחר קוד האתר - base).

אחד "מחסן"ניתן לקשר לכמה"מקורות"ואחד "מקור" - לכמה "מחסנים"(מערכת יחסים של רבים לרבים). החריגים הם ברירת מחדל "מקור"ו"מחסן". הם אינם מקושרים מחדש לישויות אחרות (הגבלה ברמת הקוד - השגיאה "לא ניתן לשמור קישור הקשור למקור ברירת המחדל או למלאי ברירת המחדל"). פרטים נוספים על מבנה MSI במג'נטו 2 ניתן למצוא במאמר "מערכת ניהול מחסן באמצעות CQRS ו- Event Sourcing. לְעַצֵב".

אני אשתמש בתצורת ברירת המחדל ואוסיף את כל מידע המלאי למקור default, המעורב בערוץ המכירה המשויך לאתר עם הקוד base (מתאים לקצה הקדמי של החנות - ראה store_website):

function createNewItem($sku, $qty)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('inventory_source_item');
    $bind = [
        'source_code' => 'default',
        'sku' => $sku,
        'quantity' => $qty,
        'status' => MagentoInventoryApiApiDataSourceItemInterface::STATUS_IN_STOCK
    ];
    $conn->insert($table, $bind);
}

לאחר הוספת נתוני מלאי למוצר בפאנל הניהול, אתה מקבל את התמונה הבאה:

מדיה

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

• catalog_product_entity_media_gallery: רישום מדיה (תמונות וקבצי וידאו);
• catalog_product_entity_media_gallery_value: קישור מדיה למוצרים וחלונות ראווה (לוקליזציה);
• catalog_product_entity_media_gallery_value_to_entity: קישור מדיה למוצרים בלבד (ככל הנראה תוכן מדיה ברירת מחדל עבור המוצר);
• catalog_product_entity_varchar: התפקידים שבהם נעשה שימוש בתמונה מאוחסנים כאן;

והתמונות עצמן נשמרות בספרייה ./pub/media/catalog/product/x/y/איפה x и y - האות הראשונה והשנייה של שם קובץ התמונה. למשל, קובץ image.png צריך להישמר בתור ./pub/media/catalog/product/i/m/image.png, כדי שהפלטפורמה תוכל להשתמש בה כתמונה בעת תיאור מוצרים מהקטלוג.

catalog_product_enity_media_gallery

ההרשמה פורסם ב ./pub/media/catalog/product/ קובץ מדיה (תהליך הצבת הקובץ עצמו אינו נדון במאמר זה):

function createMediaGallery($imgPathPrefixed)
{
    $attrId = /* get attribute ID by attribute code 'media_gallery' */
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_product_entity_media_gallery');
    $bind = [
        'attribute_id' => $attrId,
        'value' => $imgPathPrefixed,
        /* 'image' or 'video' */
        'media_type' => 'image',
        'disabled' => false
    ];
    $conn->insert($table, $bind);
    $result = $conn->lastInsertId($table);
    return $result;
}

כאשר נרשם, לקובץ מדיה חדש מוקצה מזהה.

ערך_גלריית_מדיה_מוצר_קטלוג

אנו משייכים את קובץ המדיה הרשום למוצר המתאים עבור חלון הראווה של ברירת המחדל:

function createGalleryValue($mediaId, $prodId)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_product_entity_media_gallery_value');
    $bind = [
        'value_id' => $mediaId,
        /* use admin store view by default */
        'store_id' => 0,
        'entity_id' => $prodId,
        'label' => null,
        /* we have one only image */
        'position' => 1,
        'disabled' => false
    ];
    $conn->insert($table, $bind);
}

catalog_product_entity_media_gallery_value_to_entity

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

function createGalleryValueToEntity($mediaId, $prodId)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_product_entity_media_gallery_value_to_entity');
    $bind = [
        'value_id' => $mediaId,
        'entity_id' => $prodId
    ];
    $conn->insert($table, $bind);
}

catalog_product_entity_varchar

ניתן להשתמש בקובץ מדיה עם תפקידים שונים (קוד התכונה המתאים מצוין בסוגריים):

• בסיס(image)
• תמונה קטנה (small_image)
• תמונה ממוזערת (thumbnail)
• תמונת דוגמית (swatch_image)

קישור תפקידים לקובץ מדיה זה בדיוק מה שקורה בו catalog_product_entity_varchar. הקוד המחייב דומה לקוד ב-"תכונות מוצר בסיסיות".

לאחר הוספת תמונה למוצר בפאנל הניהול זה נראה כך:

קטגוריות

טבלאות עיקריות המכילות נתונים לפי קטגוריות:

• catalog_category_entity: רישום קטגוריות;
• catalog_category_product: חיבור בין מוצרים וקטגוריות;
• catalog_category_entity_*: ערכי תכונת EAV;

בתחילה, באפליקציית מג'נטו ריקה, רישום הקטגוריות מכיל 2 קטגוריות (קיצרתי את שמות העמודות: crt - created_at, upd - updated_at):

entity_id|attribute_set_id|parent_id|crt|upd|path|position|level|children_count|
---------|----------------|---------|---|---|----|--------|-----|--------------|
        1|               3|        0|...|...|1   |       0|    0|             1|
        2|               3|        1|...|...|1/2 |       1|    1|             0|

הקטגוריה עם id=1 היא השורש של כל קטלוג מג'נטו ואינה זמינה לא בפאנל הניהול ולא בעמוד הראשון. קטגוריה עם id=2 (קטגורית ברירת מחדל) היא קטגוריית השורש של החנות הראשית של האתר הראשי (חנות האתר הראשית) נוצר בעת פריסת היישום (ראה. מנהל / חנויות / כל החנויות). יתרה מכך, גם קטגוריית השורש של החנות עצמה אינה זמינה בחזית, אלא רק תת הקטגוריות שלה.

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

function create($prodId, $catId)
{
    /** @var MagentoFrameworkAppResourceConnection $this->resource */
    /** @var MagentoFrameworkDBAdapterPdoMysql $conn */
    $conn = $this->resource->getConnection();
    $table = $this->resource->getTableName('catalog_category_product');
    $bind = [
        'category_id' => $catId,
        'product_id' => $prodId,
    ];
    $conn->insert($table, $bind);
}

לאחר הוספת קישור למוצר לקטגוריות "קטגוריה 1" ו-"קטגוריה 2", פרטי המוצר בפאנל הניהול נראים בערך כך:

פעולות נוספות

לאחר השלמת ייבוא ​​הנתונים, עליך לבצע את השלבים הנוספים הבאים:

• אינדקס נתונים: התקשר במסוף ./bin/magento indexer:reindex;
• יצירת כתובות URL מחדש עבור מוצרים/קטגוריות: אתה יכול להשתמש בתוסף "elgentos/regenerate-catalog-urls«

מוצרים בפאנל הניהול לאחר ביצוע פעולות נוספות:

ובחזית:

תקציר

אותו סט מוצרים (10 חתיכות) כמו בכתבה הקודמת מיובא לפחות בסדר גודל מהיר יותר (שנייה אחת לעומת 1). כדי להעריך בצורה מדויקת יותר את המהירות, אתה צריך מספר גדול יותר של מוצרים - כמה מאות, או טוב יותר אלפים. עם זאת, גם עם גודל כה קטן של נתוני קלט, אנו יכולים להסיק שהשימוש בכלים שמספקת Magento (מודלים ומאגרים) הוא משמעותי (אני מדגיש - הרבה!) להאיץ את פיתוח הפונקציונליות הנדרשת, אך בו זמנית באופן משמעותי (אני מדגיש - הרבה!) להפחית את המהירות שבה נתונים נכנסים למסד הנתונים.

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

מקור: www.habr.com