Configuration de l’intégration

Configurez l’intégration en connectant Commerce à l’instance AEM Assets et en sélectionnant la stratégie correspondante pour la synchronisation des ressources.

Après avoir identifié le projet AEM Assets, sélectionnez la règle correspondante pour synchroniser les ressources entre Adobe Commerce et AEM Assets.

  • Match by product SKU : règle par défaut qui associe le SKU dans les métadonnées de ressource au SKU de produit Commerce pour s’assurer que les ressources sont associées aux produits appropriés.

  • Custom match : règle de correspondance pour les scénarios plus complexes ou pour les besoins spécifiques de l'entreprise qui nécessitent une logique de correspondance personnalisée. L’implémentation d’une correspondance personnalisée nécessite le développement d’un code personnalisé dans Adobe Developer App Builder pour définir la manière dont les ressources sont associées aux produits. Plus de détails bientôt disponibles…

Pour la configuration initiale, utilisez la règle par défaut Correspondance par sku de produit.

Conditions préalables

  • Configuration du projet AEM Assets

  • [PaaS uniquement]{class="badge informative" title="S’applique uniquement à Adobe Commerce sur les projets cloud (infrastructure PaaS gérée par Adobe)."} Installez les packages Adobe Commerce pour ajouter l’extension et générer les informations d’identification et les connexions requises pour utiliser l’extension.

  • Suivez les étapes décrites dans la rubrique activation de l’API Open Dynamic Media. Insérez les informations suivantes pour l’équipe d’assistance :

    • AEM Program ID
    • Adobe Commerce URL
    • AEM Environment ID,
    • IMS Org ID pour l’environnement de création AEM Assets auquel vous souhaitez vous connecter à Commerce.

Configurer la connexion

  1. Obtenez l’identifiant de projet et d’environnement AEM Assets Authoring Environment.

    1. Ouvrez l’AEM Cloud Manager et sélectionnez Assets.

    2. Copiez et enregistrez les identifiants de projet et d’environnement à partir de l’URL
      https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

  2. Ouvrez la configuration de l’intégration AEM Assets à partir de l’Administration Commerce.

    1. Accédez à Store > Configuration > ADOBE SERVICES > AEM Assets Integration.

      L’intégration AEM Assets active l’intégration {width="600" modal="regular"}

  3. Saisissez les Program ID et Environment ID de l’environnement AEM Assets.

    Modifiez les valeurs de configuration en supprimant la sélection de Use system value.

  4. Saisissez le Asset Selector IMS Client ID.

    Pour plus d’informations sur le sélecteur de ressources, voir Sélection manuelle des ressources

  5. [PaaS uniquement]{class="badge informative" title="S’applique uniquement à Adobe Commerce sur les projets cloud (infrastructure PaaS gérée par Adobe)."} sélectionnez les Commerce integration d’authentification des requêtes entre Commerce et le service de correspondance des ressources.

  6. Définissez la Commerce integration sur assets-integration pour sélectionner l’intégration Commerce à utiliser avec AEM Assets.

  7. Définissez Synchronization enabled sur Yes pour permettre à Commerce d’accepter les mises à jour entrantes en provenance d’AEM Assets.

    Après avoir activé l’intégration, des options de configuration supplémentaires sont disponibles pour spécifier les critères de correspondance des ressources.

  8. Sélectionnez l’une des règles de correspondance de ressources pour la synchronisation des ressources dans la liste déroulante Asset matching rule .

  9. Ajoutez le nom du champ de métadonnées AEM Assets défini pour les SKU de produit Commerce dans le champ Match by product SKU attribute name, commerce:skus par défaut.

  10. Sélectionnez Save Config pour appliquer des mises à jour et lancer la synchronisation des ressources.

    La mise à jour de la configuration déclenche le processus de synchronisation initial, ce qui permet à Commerce d’accepter les mises à jour entrantes provenant d’AEM Assets. Le temps nécessaire à la synchronisation dépend du volume de ressources et de configurations spécifiques. L’intégration tire parti de processus automatisés afin de réduire le temps nécessaire à la synchronisation.

SLA de synchronisation

L’intégration garantit les niveaux de performances de synchronisation suivants :

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

Cela permet de s’assurer que les pages produit affichent toujours les images les plus récentes, en préservant la précision et l’attrait visuel du contenu du storefront.

Configuration du propriétaire de la visualisation

Le paramètre Propriétaire de la visualisation détermine le système qui diffuse les images de produit dans l’intégration :

  • Adobe Commerce - Utilise des images hébergées dans Commerce.
  • AEM Assets - Utilise des images synchronisées à partir d’AEM.

L’administrateur affiche les images disponibles pour ce propriétaire, tandis que le reste des images est grisé et affiché avec un libellé masqué.

Voir la rubrique Définition des détails de l’image pour plus d’informations sur le comportement d’affichage des images.

TIP
Lors d’une migration de Commerce vers AEM Assets, définissez le Propriétaire de la visualisation sur Commerce afin d’éviter la rupture des liens d’image. Une fois tous les produits synchronisés avec AEM Assets, basculez vers le propriétaire d’AEM Assets pour terminer la transition. Cela garantit la disponibilité continue des images tout au long du processus.
  1. Accédez à Store > Configuration > ADOBE SERVICES > AEM Assets Integration.

    Fonction du propriétaire de la visualisation d’intégration AEM Assets {width="400" modal="regular"}

  2. Sélectionnez la source Propriétaire de la visualisation pour afficher les images.

  3. Cliquez sur Save Config pour appliquer les mises à jour et lancer la synchronisation des ressources.

Facultatif. Configuration de l’URL du domaine personnalisé

Si le projet AEM Assets as a Cloud Service a été configuré avec un nom de domaine personnalisé, vous devez ajouter le nom de domaine à la configuration du magasin Commerce afin que l’intégration AEM Assets pour Commerce puisse l’utiliser.

  1. Accédez à Store > Configuration > ADOBE SERVICES > AEM Assets Integration.

    L’intégration AEM Assets active l’intégration {width="700" modal="regular"}

  2. Ajoutez l’URL de domaine personnalisé au champ Asset Custom Domain .

  3. Cliquez sur Save Config pour appliquer les mises à jour et lancer la synchronisation des ressources.

Étape suivante

Gestion des ressources Commerce

recommendation-more-help
1e1bf82b-b08f-47bf-a397-ef30dbe31665