Magento 2: 외부 소스에서 제품 가져오기

Magento는 전자상거래 솔루션입니다. 판매에 수반되는 창고, 물류 또는 재무회계보다는 제품 판매를 더 목표로 합니다. 다른 애플리케이션(예: ERP 시스템)은 동반 애플리케이션에 더 적합합니다. 따라서 Magento를 사용하는 경우 매장을 다른 시스템(예: 1C)과 통합하는 작업이 자주 발생합니다.

대체로 통합은 다음을 통해 데이터 복제로 축소될 수 있습니다.

• 카탈로그(제품, 카테고리);
• 재고 데이터(창고의 제품 잔고 및 가격)
• 클라이언트;
• 명령;

Magento는 데이터베이스의 데이터를 조작하기 위한 별도의 객체 클래스를 제공합니다. 저장소. Magento의 특성상 리포지토리를 통해 데이터베이스에 데이터를 추가하는 것은 코딩하기 쉽지만 느리다고 할 수 있습니다. 이 간행물에서는 repo 클래스를 사용하여 "고전적인" 방식으로 Magento 2에 제품을 프로그래밍 방식으로 추가하는 주요 단계를 고려합니다.

고객과 주문은 일반적으로 Magento에서 외부 ERP 시스템으로 다른 방향으로 복제됩니다. 따라서 더 간단합니다. 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);

"Factory" 및 "Repository" 접근 방식은 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);

추가 속성도 해당 데이터베이스 테이블에 저장됩니다.

재고 데이터

간단히 말해서 - 재고가 있는 제품의 양입니다. 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);

제품을 카테고리에 연결하는 것은 카테고리 ID와 제품 SKU를 사용하여 수행됩니다.

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

전체로

프로그래밍 방식으로 Magento 2에 제품을 추가하는 코드를 작성하는 것은 매우 쉽습니다. 위에서 언급한 모든 내용을 데모 모듈로 결합했습니다.lancer32/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의 확장성과 관련된 모든 "좋은 기능"이 손실됩니다. 모든 "고급"을 직접 수행해야 합니다. 그러나 그만한 가치가 있습니다. 성공하면 다음 기사에서 데이터베이스에 직접 쓰는 접근 방식을 고려할 것입니다.

출처 : habr.com