DocumentationCommerceIntégration AEM Assets

Configuration du projet AEM Assets

Dernière mise à jour : 11 mai 2026

Créé pour :

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

Cette rubrique décrit comment configurer votre projet AEM Assets pour que l’espace de noms Commerce, le schéma de métadonnées et l’onglet Commerce soient disponibles dans l’environnement de création AEM. Pour plus d’informations sur ces ressources, voir Métadonnées Commerce dans AEM Assets.

Vous disposez de deux options pour configurer le projet AEM Assets :

  • [Recommandé]{class="badge positive"} Intégration en libre-service — Dans les versions 2026.5.26309 et ultérieures d’AEM, activez l’intégration dans Cloud Manager en définissant une variable d’environnement et en activant Dynamic Media avec les fonctionnalités OpenAPI. Aucun déploiement de code personnalisé n’est requis. Voir Activation de l’intégration de Commerce (libre-service).

  • Configuration manuelle — Déployez le package assets-commerce via un pipeline Cloud Manager. Utilisez ces étapes manuelles lorsque vous devez déployer le code de package personnalisé ou si vous utilisez une version d’AEM antérieure à 2026.5.26309. Voir ​ Installation manuelle du package Assets-Commerce.

TIP
Vous pouvez vérifier la version actuelle d’AEM dans le menu supérieur droit : Help > About AEM.

Activer l’intégration de Commerce (libre-service) enable-aem-commerce-self-service

[prise en charge]{class="badge informative" title="Pris en charge"} version 2026.5.26309 et ultérieure d’AEM.

Dans les versions d’AEM prises en charge, vous activez l’intégration de Commerce à partir de Cloud Manager sans déployer de code personnalisé. L’espace de noms Commerce, le schéma de métadonnées et l’onglet Commerce sont automatiquement configurés lorsque vous activez l’intégration sur le service de création.

Conditions préalables relatives au libre-service

  • Accès au programme et aux environnements AEM Cloud Manager avec les rôles Responsable de programme et de déploiement .

  • Un programme AEM à la version 2026.5.26309 ou ultérieure.

  • L’ID d’organisation IMS pour votre instance Commerce.

    Votre instance Commerce et votre environnement de création AEM Assets doivent se trouver dans la même organisation IMS.

Étape 1 : créer le programme et les environnements

La création d’un programme dans Cloud Manager est un processus à assistant unique : le programme et ses environnements sont configurés en plusieurs étapes et enregistrés ensemble à la fin.

  1. Dans Cloud Manager, sélectionnez Add Program.

  2. Choisissez Set up for production, saisissez un nom de programme, puis sélectionnez Continue.

  3. À l’étape Solutions & Add-ons, sélectionnez les solutions et modules complémentaires dont votre projet a besoin, y compris Dynamic Media, puis sélectionnez Continue.

    Étape Solutions et modules complémentaires Cloud Manager avec Dynamic Media sélectionnée {width="600" modal="regular"}

  4. À l’étape Add Environment, saisissez les noms des environnements de production et d’évaluation, puis sélectionnez une région.

    Boîte de dialogue Cloud Manager Ajouter un environnement avec les détails de Production et d’Évaluation {width="600" modal="regular"}

  5. Sélectionnez Save pour créer le programme avec ses environnements.

Étape 2 : activer la variable d’intégration Commerce

Dans Cloud Manager, ouvrez l’environnement créé à l’étape 1, puis :

  1. Sélectionnez l’onglet Configuration .

  2. Ajoutez une variable d’environnement avec les valeurs suivantes, puis sélectionnez Add et Save :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Champ Valeur
    Nom COMMERCE_INTEGRATION_ENABLED
    Valeur true
    Service appliqué Auteur
    Type Variable

    Configuration de l’environnement Cloud Manager avec la variable COMMERCEINTEGRATIONENABLED appliquée au service de création {width="600" modal="regular"}

    L’environnement se met à jour pour appliquer la configuration. Patientez jusqu’à ce que le statut de l’environnement revienne à Running.

Étape 3 : activation de Dynamic Media avec les fonctionnalités OpenAPI

  1. Dans l’onglet General de l’environnement, recherchez Dynamic Media.

  2. En regard de Les fonctionnalités OpenAPI sont disponibles, sélectionnez Click to activate.

    Onglet Général de l’environnement affichant le lien d’activation de l’API OpenAPI Dynamic Media {width="600" modal="regular"}

    L’activation s’exécute en arrière-plan. Une fois l’opération terminée, l’environnement est prêt pour l’intégration de Commerce.

    note
    NOTE
    Si Click to activate n’est pas disponible, ouvrez un ticket de support pour activer Dynamic Media avec les fonctionnalités OpenAPI.

Étape 4 : valider la configuration

Basculez vers l’environnement de création ​​puis ouvrez n’importe quelle ressource. Modifiez ses propriétés et vérifiez que le schéma de métadonnées par défaut inclut l’onglet Commerce et que les champs Product Data et Eligible for Commerce sont visibles.

Installation manuelle du package Assets-Commerce

NOTE
Utilisez cette méthode manuelle pour déployer le code de package personnalisé ou, si vous utilisez des versions d’AEM antérieures à 2026.5.26309. Dans les versions prises en charge, utilisez Activer l’intégration de Commerce (libre-service) à la place.

Conditions préalables

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

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 : activer 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 nécessaires, telles que l’identifiant du client IMS, pour que vous puissiez poursuivre l’intégration.

Etapes d’installation

  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.

Configuration d’un profil de métadonnées (facultatif)

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. Pour utiliser automatiquement ces valeurs par défaut, appliquez le nouveau profil aux dossiers AEM Asset. 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