DocumentationCommerceIntégration AEM Assets

Configuration du projet AEM Assets pour la prise en charge des métadonnées Commerce

Dernière mise à jour : 11 mai 2026

Créé pour :

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Lorsque vous utilisez AEM Assets en tant que système de gestion des ressources numériques (DAM) pour Commerce, l’installation du package assets-commerce vous permet de gérer les images et les vidéos pour les produits Commerce à partir de l’environnement de création AEM.

Suivez les étapes ci-dessous pour configurer le projet AEM Assets avec le code et les métadonnées de package requis pour gérer les ressources Commerce à partir de l’environnement de création AEM :

  1. En savoir plus sur le contenu du package assets-commerce

  2. Suivez les étapes d’installation pour configurer le projet AEM Assets afin de prendre en charge les métadonnées Commerce

Contenu du package AEM Commerce assets-commerce

Adobe fournit un assets-commerce de code de package AEM Commerce pour ajouter des ressources d’espace de noms et de schéma de métadonnées Commerce à la configuration de l’environnement Experience Manager Assets as a Cloud Service.

Ce code de package ajoute les ressources suivantes à l’environnement de création AEM Assets :

  • Un espace de noms personnalisé, Commerce pour identifier les propriétés liées à Commerce.

    • Un type de métadonnées personnalisé commerce:isCommerce avec le libellé Eligible for Commerce pour baliser les ressources Commerce associées à un projet Adobe Commerce.

    • Un commerce:skus de type de métadonnées personnalisé et un composant d’interface utilisateur correspondant pour ajouter une propriété Product Data. Les données de produit incluent les propriétés de métadonnées pour associer une ressource Commerce aux SKU de produit.

      Contrôle personnalisé de l’interface utilisateur des données du produit {width="600" modal="regular"}

    • Un type de métadonnées personnalisé commerce:roles et commerce:positions des attributs pour montrer comment la ressource est visualisée dans Commerce.

    • Métadonnées à plusieurs champs de texte secondaire (Alt texts) pour permettre aux éditeurs de saisir un texte secondaire indexé par le code d’affichage de la boutique Commerce. Cela ne modifie pas la manière dont les images de produit sont affectées ou la portée dans le catalogue. Voir ​ Texte de remplacement dans les métadonnées AEM Assets.

  • Formulaire de schéma de métadonnées avec un onglet Commerce contenant les champs Eligible for Commerce et Product Data pour le balisage des ressources Commerce. Le formulaire fournit également des options pour afficher ou masquer les champs roles et position de l’interface utilisateur d’AEM Assets.

    Onglet Commerce du formulaire de schéma de métadonnées AEM Assets {width="600" modal="regular"}

  • Un exemple de ressource Commerce balisée et approuvée equipment_6.jpg pour prendre en charge la synchronisation initiale des ressources. Seules les ressources Commerce approuvées peuvent être synchronisées d’AEM Assets vers Adobe Commerce.

NOTE
Voir la page readme sur GitHub pour plus d’informations sur le code du package AEM Commerce.

Texte de remplacement dans les métadonnées AEM Assets

Le multichamp Alt texts​est disponible dans l’éditeur de métadonnées de ressource d’AEM Assets dans l’onglet Commerce​lorsque vous modifiez une image éligible.

IMPORTANT
Le comportement d’affichage par magasin s’applique uniquement au texte secondaire. L’intégration d’AEM Assets ne synchronise pas les différentes images des produits par vue de magasin Adobe Commerce. Les images de produit d’AEM continuent à se synchroniser dans Commerce avec le même comportement d’affectation de galerie qu’avant cette version.

Le multichamp contient une ligne par vue de magasin Commerce. Chaque ligne comporte deux entrées :

  • Store View Code — Identifiant de vue de magasin (par exemple default ou en_US).

  • Alt Text : texte secondaire pour cette vue de magasin, limité à 255 caractères.

Sélectionnez Add pour ajouter d’autres lignes pour les vues de magasin supplémentaires. Pour supprimer une ligne, sélectionnez l’icône Delete de cette ligne pour la supprimer.

Plusieurs champs Texte de remplacement avec des entrées Code d’affichage de magasin et Texte de remplacement {width="600" modal="regular"}

Lors de l’enregistrement, la validation côté client bloque l’envoi si une ligne a un Store View Code​vide ou si deux lignes utilisent le même code d’affichage du magasin (non-respect de la casse).

Les entrées de texte secondaire sont conservées dans les métadonnées de ressource JCR sous la forme de deux propriétés String[] alignées sur l’index :

  • commerce:altTextStoreViews : Stocker le code d’affichage pour chaque ligne.
  • commerce:altTextValues : Correspondance du texte secondaire au même index que chaque entrée dans commerce:altTextStoreViews.

Lorsque ces ressources se synchronisent avec Adobe Commerce, le texte secondaire d’affichage par magasin est écrit dans la galerie de médias du produit pour les codes d’affichage de magasin correspondants. Le mapping d’images sous-jacent reste inchangé.

Conditions préalables

Vous avez besoin des ressources et autorisations suivantes pour déployer le code du package assets-commerce dans l’environnement AEM Assets as a Cloud Service AEM :

Visuels du produit

[SaaS uniquement]{class="badge positive" title="S’applique uniquement aux projets Adobe Commerce as a Cloud Service et Adobe Commerce Optimizer (infrastructure SaaS gérée par Adobe)."} Dynamic Media avec fonctionnalités OpenAPI est en libre-service pour les visuels de produit optimisés par AEM Assets.

  1. Accédez à votre Cloud Manager.

  2. Sélectionnez l’environnement souhaité.

  3. Activez Dynamic Media avec les fonctionnalités OpenAPI.

    Si le bouton Dynamic Media avec fonctionnalités OpenAPI n’est pas actif, ouvrez un ticket de support.

Tab

[PaaS uniquement]{class="badge informative" title="S’applique uniquement à Adobe Commerce sur les projets cloud (infrastructure PaaS gérée par Adobe)."} Sur AEM as a Cloud Service, envoyez un ticket d’assistance Adobe avec les informations suivantes :

  • Titre : activez l’OpenAPI Dynamic Media pour intégrer entièrement Adobe Commerce à AEM Assets.

    • Contenu du ticket d’assistance :

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

Une fois que vous avez envoyé le ticket d’assistance, Adobe active Dynamic Media avec les fonctionnalités OpenAPI dans votre environnement Cloud Services et partage les informations, telles que l’identifiant du client IMS, pour que vous puissiez poursuivre l’intégration.

Étape 1 : installer le package assets-commerce

  1. Accédez à AEM Cloud Manager, sélectionnez un programme, puis créez des environnements de production et d’évaluation à intégrer à Adobe Commerce.

  2. Clonez le référentiel Git géré par Adobe pour le programme sélectionné.

    Informations d’identification du référentiel Cloud Manager et commande de clonage {width="600" modal="regular"}

    Dans Cloud Manager Pipelines, sélectionnez Access Repo Info pour ouvrir la Repository Info. Copiez la valeur URL ou Git command line, générez un mot de passe d’accès si nécessaire, puis clonez localement avec votre client Git.

  3. À partir de GitHub, téléchargez le code du package à partir du référentiel AEM Assets Commerce.

  4. À partir de votre environnement de développement AEM local, copiez manuellement le code téléchargé dans le référentiel géré par Adobe existant.

  5. Dans tous les fichiers filter.xml et pom.xml de votre projet, remplacez toutes les occurrences de <my-app> par le nom de votre application.

    note
    NOTE
    Vous pouvez également installer le code personnalisé dans la configuration de votre projet AEM Assets sous la forme d’un package Maven.

  6. Validez les modifications et envoyez votre branche de développement local au référentiel Git de Cloud Manager.

  7. Configurez un pipeline de déploiement ou vérifiez que votre pipeline peut déployer les modifications dans l’environnement sélectionné.

    Pipelines ​ {width="600" modal="regular"}

    Lorsque le pipeline existe, ouvrez le menu d’actions (…) pour Run, Edit, View/Edit variables ou d’autres actions, consultez la documentation sur le pipeline Cloud Manager liée ci-dessus.

  8. Depuis AEM Cloud Manager, mettez à jour l’environnement AEM à l’aide du pipeline pour déployer votre code.

  9. Accédez à n’importe quelle ressource et modifiez ses propriétés pour valider les modifications :

    • Le schéma de métadonnées par défaut inclut l’onglet ​.

    • Les SKU de produit et les champs Eligible for Commerce sont visibles.

L’onglet Commerce n’est pas visible dans les propriétés

Si l’onglet ​​n’apparaît pas dans les propriétés, vous devez effectuer manuellement les étapes suivantes dans l’éditeur de schéma de métadonnées :

  1. Accédez à l’éditeur de schéma de métadonnées.

  2. Sélectionnez Modifier pour modifier le formulaire de schéma de métadonnées par défaut.

  3. Créez un onglet ​​et sélectionnez-le.

  4. Faites glisser et déposez le composant Product dans l’onglet Commerce et mappez-le à la commerce:skus de propriété.

  5. Cochez la case Afficher les rôles et Afficher l’ordre.

  6. Faites glisser et déposez un composant case à cocher dans l’onglet Commerce et mappez-le à l’commerce:isCommerce de propriété. Définissez Oui et Non comme options.

Si vous rencontrez d’autres problèmes, créez un ticket d’assistance ou contactez votre représentant commercial pour l’intégration AEM Assets pour obtenir de l’aide.

Étape 2 : Facultatif. Configuration d’un profil de métadonnées

Dans l’environnement de création AEM Assets, définissez les valeurs par défaut des métadonnées de ressources Commerce en créant un profil de métadonnées. Appliquez ensuite le nouveau profil aux dossiers AEM Assets pour utiliser automatiquement ces paramètres par défaut. Cette configuration simplifie le traitement des ressources en réduisant les étapes manuelles.

Lorsque vous configurez le profil de métadonnées, il vous suffit de configurer les composants suivants :

  • Ajoutez un onglet Commerce . Cet onglet active les paramètres de configuration spécifiques à Commerce ajoutés par le modèle.

  • Ajoutez le champ Eligible for Commerce à l’onglet Commerce .

Le composant d’interface utilisateur des données de produit est ajouté automatiquement en fonction du modèle.

Définition du profil de métadonnées

  1. Connectez-vous à l’environnement de création de Adobe Experience Manager.

  2. Dans l’espace de travail Adobe Experience Manager , accédez à l’espace de travail Créer une administration de contenu pour AEM Assets en cliquant sur l’icône Adobe Experience Manager .

    Création ​ {width="600" modal="regular"}

  3. Ouvrez les outils d’administration en sélectionnant l’icône en forme de marteau.

    L’administrateur de création AEM gère les profils de métadonnées {width="600" modal="regular"}

  4. Ouvrez la page de configuration du profil en cliquant sur Metadata Profiles.

  5. Create un profil de métadonnées pour l’intégration de Commerce.

    L’administrateur de création AEM ajoute des profils de métadonnées {width="600" modal="regular"}

  6. Ajoutez un onglet pour les métadonnées Commerce.

    1. Sur la gauche, cliquez sur Settings.

    2. Cliquez sur + dans la section d’onglet, puis spécifiez le Tab Name, Commerce.

  7. Ajoutez le champ Eligible for Commerce au formulaire.

    L’administrateur de création AEM ajoute des champs de métadonnées au profil {width="600" modal="regular"}

    • Cliquez sur Build form.

    • Faites glisser le champ Single Line text vers le formulaire.

    • Ajoutez le texte Eligible for Commerce pour le libellé en cliquant sur Field Label.

    • Dans l’onglet Paramètres , ajoutez le texte du libellé à Libellé du champ.

    • Définissez le texte d’espace réservé sur yes.

    • Dans le champ Map to Property , copiez et collez la valeur suivante :

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. Facultatif. Pour synchroniser automatiquement les ressources Commerce approuvées lors de leur chargement dans l’environnement AEM Assets, définissez la valeur par défaut du champ Review Status​de l’onglet Basic sur approved.

  9. Enregistrez la mise à jour.

Application du profil de métadonnées au dossier source des ressources Commerce

  1. Sur la page Metadata Profiles , sélectionnez le profil d’intégration de Commerce.

  2. Dans le menu d’actions, sélectionnez Apply Metadata Profiles to Folders.

  3. Sélectionnez le dossier contenant les ressources Commerce.

    Créez un dossier Commerce s’il n’existe pas.

  4. Sélectionnez Apply.

Étapes suivantes

recommendation-more-help
commerce-help-aem-assets-integration