DocumentationCommerceIntégration AEM Assets

Métadonnées Commerce dans AEM Assets

Dernière mise à jour : 15 juillet 2026

Créé pour :

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

Les métadonnées Commerce sont le contrat entre AEM Assets et Commerce. Il indique à Commerce quelles ressources sont destinées à Commerce, à quels produits elles appartiennent et comment elles doivent être utilisées ou affichées. Ces métadonnées permettent à l’intégration d’AEM Assets de mapper et de synchroniser correctement les fichiers de ressource.

Les métadonnées Commerce offrent les fonctionnalités suivantes :

  • Marquer une ressource comme éligible pour Commerce via le champ commerce:isCommerce.
  • Associer une ressource à un ou plusieurs SKU de produit via le champ commerce:skus .
  • Définissez la manière dont la ressource s’affiche dans Commerce à l’aide des champs commerce:roles et commerce:positions.
  • Ajoutez du texte secondaire spécifique à Commerce indexé par vue de magasin via les champs commerce:altTextStoreViews et commerce:altTextValues.
  • Exposez ces champs dans l’interface utilisateur des propriétés d’AEM Assets par le biais d’un onglet Commerce et d’un formulaire de schéma.
IMPORTANT
La fonctionnalité de texte secondaire spécifique à ​​n’est pas encore disponible via l’intégration en libre-service 🔗. Il n’est actuellement fourni que lorsque vous déployez le package de code personnalisé assets-commerce (voir Installation manuelle du package assets-commerce). Une prise en charge native est prévue pour une prochaine version d’AEM.

Pour configurer ces ressources dans votre projet AEM, voir Configurer le projet AEM Assets. Le reste de cette rubrique décrit comment les métadonnées sont fournies.

Contenu du package AEM Commerce assets-commerce

Adobe fournit le package de code AEM Commerce assets-commerce pour ajouter des espaces de noms Commerce et des ressources de schéma de métadonnées à la configuration 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 commerce:roles de type de métadonnées personnalisé et des attributs de commerce:positions qui montrent comment la ressource est visualisée dans Commerce.

    • Métadonnées à plusieurs champs de texte secondaire (Alt texts) afin que les éditeurs puissent saisir un texte secondaire pour chaque code d’affichage de la boutique Commerce. Le multichamp persiste dans deux propriétés String[] alignées sur l’index :

      • commerce:altTextStoreViews — stocker le code d’affichage pour chaque ligne.
      • commerce:altTextValues : texte de remplacement correspondant au même index que chaque entrée dans commerce:altTextStoreViews.

      Les implémentations d’App Builder utilisant un mappeur externe peuvent intercepter ces propriétés lors de la transformation des payloads des ressources. Cela ne modifie pas la manière dont les images de produit sont affectées ou la portée dans le catalogue. Voir ​ Texte secondaire localisé 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 secondaire localisé 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é.

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