DocumentationCommerceGuide d’intégration d’AEM Assets

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

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice

Pour gérer les fichiers de ressources Commerce dans AEM Assets, procédez comme suit pour configurer le projet AEM Assets avec le code standard et les métadonnées nécessaires pour gérer les ressources Commerce à partir de l’environnement de création AEM.

  • Étape 1 : installez un modèle de projet AEM avec le code standard pour ajouter les 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.
  • Étape 2 : configurer le profil de métadonnées à appliquer aux fichiers de ressources Commerce

Ajouter le code standard à votre projet AEM

Adobe fournit un modèle AEM Commerce, assets-commerce, pour ajouter des ressources d’espace de noms Commerce et de schéma de métadonnées à la configuration de l’environnement Experience Manager Assets as a Cloud Service. Déployez ce code dans votre environnement en tant que package Maven. Configurez ensuite les métadonnées Commerce dans l’environnement de création AEM Assets pour terminer la configuration.

Le modèle standard 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.

  • 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 pour plus d'informations sur le modèle AEM Commerce ​.

Conditions préalables

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

Installation du package commerce-assets

  1. Dans AEM Cloud Manager, créez des environnements de production et d’évaluation pour votre projet AEM Assets, si nécessaire.

  2. Configurez un pipeline de déploiement, si nécessaire.

  3. À partir de GitHub, téléchargez le code à partir du fichier standard AEM Commerce 🔗.

  4. À partir de votre environnement de développement AEM local, installez le code personnalisé dans la configuration de votre environnement AEM Assets sous la forme d’un package Maven ou en copiant manuellement le code dans la configuration du projet existant.

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

  6. Depuis AEM Cloud Manager, déployez votre code pour mettre à jour l’environnement AEM.

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 AEM Assets {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. Cliquez sur Apply.

Étape suivante

[PaaS uniquement]{class="badge informative" title="S’applique uniquement à Adobe Commerce sur les projets cloud (infrastructure PaaS gérée par Adobe)."} installer les packages Adobe Commerce

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