SaaS 데이터 내보내기 피드 데이터 확장 및 사용자 지정

Commerce Data Export 확장을 사용하면 Commerce 응용 프로그램에서 Live Search, Catalog Service 및 Product Recommendations와 같은 Commerce 서비스로 데이터를 내보낼 수 있습니다. 필요한 경우 피드 데이터를 확장 및 사용자 정의하여 추가 속성 데이터를 포함하거나 수집된 데이터를 수정할 수 있습니다.

특성 데이터를 추가한 후 storefront 서비스를 위한 GraphQL 스키마의 특성 필드에서 액세스할 수 있습니다.

제품 피드의 시스템 속성 데이터 확장

제품 피드에는 제품 처리에 필요하거나 소비자가 일반적으로 사용하는 기본 시스템 속성이 포함됩니다. 추가 시스템 속성을 피드에 추가하여 제품 피드에 포함할 수 있습니다.

이 작업을 완료하려면 magento/catalog-data-exporter 모듈을 업데이트하여 종속성 삽입 구성 파일​(di.xml)에 추가 시스템 특성을 추가하십시오.

제품 특성 쿼리(Magento\CatalogDataExporter\Model\Query\ProductAttributeQuery)에 특성을 추가합니다.

예

    <type name="Magento\CatalogDataExporter\Model\Query\ProductAttributeQuery">
        <arguments>
            <argument name="systemAttributes" xsi:type="array">
                <item name="news_from_date" xsi:type="string">news_from_date</item>
                ...
                <item name="some_system_attribute_code">some_system_attribute_code</item>
            </argument>
        </arguments>
    </type>

Adobe Commerce에 제품 속성 추가

개발자는 다음 방법 중 하나를 사용하여 제품 특성 필드에서 액세스할 수 있는 제품 특성을 추가할 수 있습니다.

Adobe Commerce에 속성 추가

Commerce 관리자에서 제품 특성을 추가하거나 프로그래밍 방식으로 사용자 지정 PHP 모듈을 사용하여 특성을 정의하고 Adobe Commerce을 업데이트할 수 있습니다. 속성과 필요한 모든 메타데이터를 한 번에 추가할 수 있으므로 Commerce 관리자의 속성을 추가하는 것이 가장 간단한 방법입니다. 새 속성 및 해당 메타데이터 속성은 다음에 예약된 동기화 중에 자동으로 SaaS 서비스로 내보내집니다.

관리에서 제품 속성 만들기

Adobe Commerce 관리 안내서​에서 제품 특성 만들기를 참조하십시오.

프로그래밍 방식으로 제품 특성 만들기

DataPatchInterface을(를) 구현하는 데이터 패치를 만들어 프로그래밍 방식으로 제품 특성을 추가하고 생성자 내에서 EavSetup Factory 클래스의 복사본을 인스턴스화하여 특성 옵션을 구성합니다.

특성 옵션을 정의할 때 type, label 및 input을(를) 제외한 모든 특성 매개 변수는 선택 사항입니다. 다음 추가 매개 변수와 기본 설정과 다른 매개 변수를 정의합니다.

데이터 패치 만들기에 대한 자세한 내용은 PHP 개발자 안내서​에서 데이터 및 스키마 패치 개발을 참조하십시오.

제품 속성을 동적으로 추가

새 EAV 특성을 도입하지 않고 제품 특성을 동적으로 만드는 방법에 대한 자세한 내용은 제품 특성을 동적으로 추가를 참조하십시오.

피드 스키마 개요(et_schema.xml) feed-schema-overview

각 피드 데이터 구조는 간단한 XML DSL을 사용하여 etc/et_schema.xml에서 선언됩니다. 프레임워크는 이 파일을 읽어 수집할 필드와 호출할 PHP 공급자 클래스를 결정합니다.

<record name="Product">
  <field name="sku" type="ID" />
  <field name="name" type="String" />
  <field name="attributes" type="Attribute" repeated="true"
         provider="Magento\CatalogDataExporter\Model\Provider\Product\Attributes">
    <using field="productId" />
    <using field="storeViewCode" />
  </field>
</record>

주요 요소:

제출 후 데이터 관찰 observe-data-after-submission

SaaS Data Export은(는) SaaS 서비스에 일괄 처리 제출이 완료되면 data_sent_outside 이벤트를 발송합니다. 감사 로깅, 웹후크 트리거 또는 지표 수집에 이 이벤트를 사용합니다.

이벤트: data_sent_outside

사용 가능한 데이터:

예제 관찰자:

<?php
namespace My\Module\Observer;

use Magento\Framework\Event\Observer;
use Magento\Framework\Event\ObserverInterface;

class DataSentOutsideObserver implements ObserverInterface
{
    public function execute(Observer $observer): void
    {
        $feedName = $observer->getData('type');
        $timestamp = $observer->getData('timestamp');
        $data = $observer->getData('data');

        // Custom logic: audit logging, webhook, metrics
    }
}

etc/events.xml에서 관찰자 등록:

<event name="data_sent_outside">
    <observer name="my_module_data_sent_outside"
              instance="My\Module\Observer\DataSentOutsideObserver" />
</event>

이벤트 및 관찰자에 대한 일반적인 정보는 Adobe Commerce 개발자 설명서에서 이벤트 및 관찰자를 참조하십시오.

제출 전 데이터 필터링

SaaS 서비스로 데이터를 보내기 전에 중요한 필드를 수정하거나 특정 엔터티를 건너뛰려면 Magento\SaaSCommon\Model\DataFilter 확장 지점을 사용하십시오. 이 기능은 특정 필드가 Commerce 인스턴스를 벗어나지 않아야 하는 GDPR 또는 PCI와 같은 규정 준수 요구 사항에 유용합니다.

인터페이스를 구현하고 etc/di.xml에서 DI 환경 설정을 통해 연결합니다.

<preference for="Magento\SaaSCommon\Model\DataFilter"
            type="My\Module\Model\MyDataFilter" />