Ampliación y personalización de los datos de exportación de fuentes de SaaS

La extensión Commerce Data Export proporciona una forma de exportar datos desde la aplicación Commerce a servicios de Commerce como Live Search, Servicio de catálogo y Recomendaciones de productos. Si es necesario, puede ampliar y personalizar los datos de fuente para incluir datos de atributo adicionales o modificar los datos recopilados.

Después de agregar los datos de atributo, se puede obtener acceso a ellos desde el campo de atributos en el esquema de GraphQL para los servicios de tienda.

Ampliar los datos de atributos del sistema en la fuente de productos

La fuente de productos incluye atributos de sistema predeterminados que son necesarios para el procesamiento del producto o que suelen utilizar los consumidores. Puede incluir atributos del sistema adicionales en la fuente de productos añadiéndolos a la fuente.

Para completar esta tarea, actualice el módulo magento/catalog-data-exporter para agregar los atributos de sistema adicionales al archivo de configuración de inyección de dependencia (di.xml).

Agregue los atributos a la consulta de atributos del producto (Magento\CatalogDataExporter\Model\Query\ProductAttributeQuery).

Ejemplo

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

Añadir atributos de producto a Adobe Commerce

Los desarrolladores pueden agregar atributos de producto a los que se puede tener acceso desde el campo de atributos de producto mediante uno de los métodos siguientes:

Añadir el atributo a Adobe Commerce

Puede añadir un atributo de producto desde el administrador de Commerce o, mediante programación, utilizar un módulo PHP personalizado para definir el atributo y actualizar Adobe Commerce. Añadir el atributo desde el administrador de Commerce es el método más sencillo, ya que puede añadir el atributo y todos los metadatos necesarios a la vez. El nuevo atributo y sus propiedades de metadatos se exportan automáticamente a los servicios SaaS durante la siguiente sincronización programada.

Cree el atributo de producto desde el administrador

Consulte Crear atributos de producto en la Guía de administración de Adobe Commerce.

Crear el atributo de producto mediante programación

Agregue un atributo product mediante programación creando un parche de datos que implemente DataPatchInterface e instancie una copia de la clase EavSetup Factory dentro del constructor para configurar las opciones del atributo.

Al definir las opciones de atributo, todos los parámetros de atributo excepto type, label y input son opcionales. Defina los siguientes parámetros adicionales y cualquier otro que difiera de la configuración predeterminada.

Para obtener información sobre cómo crear parches de datos, consulte Desarrollo de parches de datos y esquemas en la Guía para desarrolladores de PHP.

Añadir el atributo de producto de forma dinámica

Para obtener más información sobre cómo crear atributos de producto de forma dinámica sin introducir nuevos atributos EAV, consulte Agregar atributos de producto de forma dinámica.

Resumen del esquema de fuentes (et_schema.xml) feed-schema-overview

Cada estructura de datos de fuente se declara en etc/et_schema.xml mediante un DSL XML simple. El marco de trabajo lee este archivo para determinar qué campos recopilar y a qué clases de proveedor PHP llamar.

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

Elementos clave:

Observar datos después del envío observe-data-after-submission

SaaS Data Export distribuye el evento data_sent_outside después de cada envío de lotes correcto a un servicio SaaS. Utilice este evento para el registro de auditoría, los déclencheur de webhook o la recopilación de métricas.

Evento: data_sent_outside

Datos disponibles:

Observador de ejemplo:

<?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
    }
}

Registrar al observador en etc/events.xml:

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

Para obtener información general sobre eventos y observadores, consulte Eventos y observadores en la documentación para desarrolladores de Adobe Commerce.

Filtrado de datos antes del envío

Utilice el punto de extensión Magento\SaaSCommon\Model\DataFilter para redactar campos confidenciales u omitir entidades específicas antes de que se envíen datos al servicio SaaS. Esto resulta útil para los requisitos de cumplimiento, como RGPD o PCI, en los que determinados campos no deben salir de la instancia de Commerce.

Implemente la interfaz y conéctela a través de una preferencia de ID en etc/di.xml:

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