Extension et personnalisation des données de flux d’exportation SaaS

L’extension Commerce Data Export permet d’exporter des données de l’application Commerce vers les services Commerce tels que Live Search, Catalog Service et Product Recommendations. Si nécessaire, vous pouvez étendre et personnaliser les données de flux pour inclure des données d’attribut supplémentaires ou modifier les données collectées.

Après avoir ajouté des données d’attribut, elles sont accessibles à partir du champ attributes dans le schéma GraphQL pour les services de storefront.

Étendre les données d’attributs système dans le flux de produits

Le flux de produits comprend des attributs système par défaut qui sont requis pour le traitement des produits ou généralement utilisés par les consommateurs. Vous pouvez inclure des attributs système supplémentaires dans le flux de produits en les ajoutant au flux.

Pour terminer cette tâche, mettez à jour le module magento/catalog-data-exporter pour ajouter les attributs système supplémentaires au fichier de configuration de l’injection de dépendance (di.xml).

Ajoutez les attributs à la ou aux requête(Magento\CatalogDataExporter\Model\Query\ProductAttributeQuery) d’attributs de produit.

Exemple

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

Ajout d’attributs de produit à Adobe Commerce

L’équipe de développement peut ajouter des attributs de produit accessibles à partir du champ attributs de produit en utilisant l’une des méthodes suivantes :

Ajouter l’attribut à Adobe Commerce

Vous pouvez ajouter un attribut de produit à partir de l’administration Commerce ou par programmation à l’aide d’un module PHP personnalisé pour définir l’attribut et mettre à jour Adobe Commerce. L’ajout de l’attribut à partir de l’administration Commerce est la méthode la plus simple, car vous pouvez ajouter l’attribut et toutes les métadonnées requises en même temps. Le nouvel attribut et ses propriétés de métadonnées sont automatiquement exportés vers les services SaaS lors de la prochaine synchronisation planifiée.

Créer l’attribut de produit à partir de l’administrateur

Voir Créer des attributs de produit dans le Guide d’administration d’Adobe Commerce.

Créer l’attribut de produit par programmation

Ajoutez un attribut de produit par programmation en créant un correctif de données qui implémente le DataPatchInterface et instanciez une copie de la classe EavSetup Factory dans le constructeur pour configurer les options d’attribut.

Lorsque vous définissez les options d’attribut, tous les paramètres d’attribut, à l’exception de type, label et input, sont facultatifs. Définissez les paramètres supplémentaires suivants et tous les autres paramètres qui diffèrent des paramètres par défaut.

Pour plus d’informations sur la création de patchs de données, voir Developer data and schema patchs dans le PHP Developer Guide.

Ajout dynamique de l’attribut de produit

Pour plus d’informations sur la création dynamique d’attributs de produit sans introduire de nouveaux attributs EAV, voir Ajouter dynamiquement des attributs de produit.

Présentation du schéma de flux (et_schema.xml) feed-schema-overview

Chaque structure de données de flux est déclarée dans etc/et_schema.xml à l’aide d’un simple DSL XML. Le framework lit ce fichier pour déterminer les champs à collecter et les classes de fournisseur PHP à appeler.

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

Éléments clés :

Observer les données après envoi observe-data-after-submission

SaaS Data Export distribue l’événement data_sent_outside après chaque envoi par lots réussi à un service SaaS. Utilisez cet événement pour la journalisation d’audit, les déclencheurs webhook ou la collecte de mesures.

Event: data_sent_outside

Données disponibles :

Exemple d’observateur :

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

Enregistrez l’observateur dans etc/events.xml :

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

Pour obtenir des informations générales sur les événements et les observateurs, voir Événements et observateurs dans la documentation destinée aux développeurs Adobe Commerce.

Filtrer les données avant envoi

Utilisez le point d’extension Magento\SaaSCommon\Model\DataFilter pour supprimer les champs sensibles ou ignorer des entités spécifiques avant l’envoi des données au service SaaS. Cela s’avère utile pour les exigences de conformité telles que le RGPD ou PCI, où certains champs ne doivent pas quitter l’instance Commerce.

Implémentez l’interface et connectez-la via une préférence d’identifiant dans etc/di.xml :

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