DocumentationCommerceData Export Guide pour les services SaaS

Synchronisation des données avec l’exportation des données SaaS

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration
  • Développeur

Lorsque vous installez un service Commerce qui requiert l’exportation de données, tel que Catalog Service, Live Search ou Product Recommendations, une collection de modules d’exportation de données Saas est installée pour gérer le processus de collecte et de synchronisation des données.

L’exportation des données SaaS déplace en continu les données de produit d’une instance Adobe Commerce vers la plateforme Commerce Services pour maintenir les données à jour. Par exemple, le Recommendations de produit nécessite des informations de catalogue actuelles pour renvoyer avec précision des recommandations avec les noms, les tarifs et la disponibilité corrects. Utilisez le tableau de bord de Data Management pour observer et gérer le processus de synchronisation, ou l’interface de ligne de commande pour déclencher une synchronisation et réindexer les données de produit à utiliser par les services Commerce.

Le diagramme suivant illustre le flux d’exportation des données SaaS.

Flux de collecte et de synchronisation d’exportation des données SaaS pour Adobe Commerce {width="900" modal="regular"}

Les principaux composants du flux d’exportation des données SaaS sont les suivants :

  • Les modules d’exportation de données SaaS qui collectent les données pour les flux d’Adobe Commerce, assemblent les éléments de flux, écoutent les mises à jour et conservent l’état du flux.
  • SaaS exporte les modules qui exportent des données, configurent le routage et publient les flux sur les services connectés.
  • Le service Adobe Commerce gère le processus d’ingestion des données pour valider les flux entrants et conserver les mises à jour des services connectés.

Modes de synchronisation

L’exportation des données SaaS a deux modes pour traiter les flux d’entité :

  • Mode d’exportation immédiat : dans ce mode, les données sont collectées et envoyées immédiatement au service Commerce en une seule itération. Ce mode accélère la remise des mises à jour des entités au service Commerce et réduit la taille de stockage des tables de flux.

  • Mode d’exportation hérité : dans ce mode, les données sont collectées dans un seul processus. Ensuite, une tâche cron envoie les données collectées aux services de commerce connectés. Dans les entrées de journal d’exportation des données, les flux qui utilisent le mode hérité sont étiquetés (legacy).

Types de synchronisation

L’exportation des données SaaS prend en charge trois types de synchronisation : synchronisation complète, synchronisation partielle et reprise de la synchronisation des éléments ayant échoué.

Synchronisation complète

Après la connexion d’une instance Adobe Commerce au service Commerce, effectuez une synchronisation complète pour envoyer les données de flux d’entité d’Adobe Commerce au service connecté.

NOTE
La synchronisation complète est principalement destinée à la phase d’intégration. Évitez toute utilisation régulière pour éviter la surcharge de la base de données. Après la synchronisation initiale, les modifications en cours sont synchronisées automatiquement à l’aide d’une synchronisation partielle.

Synchronisation partielle

Avec une synchronisation partielle, l’exportation des données SaaS envoie automatiquement les mises à jour de l’application Commerce, telles que les modifications de nom de produit ou les mises à jour de prix, aux services commerciaux connectés.

Le processus d’exportation des données utilise les tâches cron suivantes pour automatiser l’opération de synchronisation partielle.

  • "index" tâches du groupe cron :

    • La tâche indexer_reindex_all_invalid réindexe tous les flux non valides. Il s’agit d’une tâche Adobe Commerce cron standard.
    • La tâche saas_data_exporter est destinée aux flux d’exportation hérités.
    • La tâche sales_data_exporter est spécifique au flux d’exportation des données de vente.

Ces tâches s’exécutent toutes les minutes.

Pour que la synchronisation partielle fonctionne, l’application Commerce requiert la configuration suivante :

  • La planification des tâches est activée via les tâches cron

  • Tous les indexeurs d’exportation de données SaaS sont configurés en mode Update by Schedule.

    Dans la version 103.1.0 et ultérieure de l’exportation des données SaaS, le mode Update by Schedule est activé par défaut. Vous pouvez vérifier la configuration de l’index sur le serveur à l’aide de la commande d’interface de ligne de commande de Commerce, bin/magento indexer:show-mode | grep -i feed

Retry Failed Items sync

La synchronisation Retry failed items sync utilise un processus distinct pour renvoyer les éléments qui n’ont pas pu être synchronisés en raison d’erreurs au cours du processus de synchronisation, par exemple une erreur d’application, une interruption réseau ou une erreur de service SaaS. L’implémentation de cette synchronisation est également basée sur les tâches cron.

  • resync_failed_feeds_data_exporter tâches de groupe cron :
    • La tâche <feed name>_feed_resend_failed_feeds_items renvoie les éléments qui n’ont pas pu être synchronisés, par exemple products_feed_resend_failed_items.

Afficher et gérer le processus de synchronisation

La plupart des activités de synchronisation sont traitées automatiquement en fonction du paramétrage de l'application. Cependant, l’exportation des données SaaS fournit également des outils pour gérer le processus.

  • Les utilisateurs administrateurs peuvent afficher et suivre la progression de la synchronisation et obtenir des informations sur les données à partir du tableau de bord de Data Management.

  • Les développeurs, les intégrateurs système ou les administrateurs ayant accès au serveur d’applications Commerce peuvent gérer le processus de synchronisation et les flux de données à l’aide de l’outil de ligne de commande Adobe Commerce (CLI). Voir Référence de commande d’exportation de données.

Vérification de la configuration des applications Commerce

La synchronisation partielle et la reprise des éléments ayant échoué fonctionnent uniquement si l’instance Commerce a été configurée correctement. En règle générale, la configuration est effectuée lors de la configuration du service Commerce. Si l'export des données ne fonctionne pas correctement, vérifiez la configuration suivante.

  • Vérifiez que les tâches cron sont en cours d’exécution.

  • Vérifiez que les indexeurs s’exécutent à partir de Admin ou à l’aide de la commande d’interface de ligne de commande Commerce bin/magento indexer:info.

  • Vérifiez que les indexeurs des flux suivants sont définis sur Update by Schedule : Attributs de catalogue, Produit, Remplacements de produit et Variante de produit. Vous pouvez vérifier les indexeurs à partir de la gestion des index dans l’administrateur ou à l’aide de l’interface de ligne de commande (bin/magento indexer:show-mode | grep -i feed).

Notifications de gestionnaire d’événements pour la journalisation du transfert de données

Dans les versions 103.3.4 et ultérieures, l’exportation de données SaaS distribue l’événement data_sent_outside lorsque des données sont envoyées de l’instance Commerce aux services Adobe Commerce.

$this->eventManager->dispatch(
   "data_sent_outside",
   [
       "timestamp" => time(),
       "type" => $metadata->getFeedName(),
       "data" => $data
   ]
);
NOTE
Pour plus d’informations sur les événements et sur la manière de s’y abonner, voir Événements et observateurs dans la documentation Adobe Commerce Developer.
recommendation-more-help
6183eb5c-cb5c-49fa-bd7b-cd38576b727c