Configuration du projet AEM Assets pour la prise en charge des métadonnées Commerce
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 :
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 Commerce et de schéma de métadonnées à 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é,
Commercepour identifier les propriétés liées à Commerce.-
Un type de métadonnées personnalisé
commerce:isCommerceavec le libelléEligible for Commercepour baliser les ressources Commerce associées à un projet Adobe Commerce. -
Un
commerce:skusde 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. {width="600" modal="regular"}
-
Un type de métadonnées personnalisé
commerce:rolesetcommerce:positionsdes 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 CommerceetProduct Datapour le balisage des ressources Commerce. Le formulaire fournit également des options pour afficher ou masquer les champsrolesetpositionde l’interface utilisateur d’AEM Assets.Onglet
{width="600" modal="regular"}
-
Un exemple de ressource Commerce balisée et approuvée
equipment_6.jpgpour prendre en charge la synchronisation initiale des ressources. Seules les ressources Commerce approuvées peuvent être synchronisées d’AEM Assets vers Adobe Commerce.
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 :
-
Accès au programme et aux environnements AEM Assets Cloud Manager avec les rôles Responsable de programme et de déploiement .
-
Un environnement de développement AEM local et une connaissance du processus de développement local d’AEM.
-
Découvrez la structure de projet AEM et comment déployer packages de contenu personnalisés à l’aide de Cloud Manager.
-
L’ID d’organisation IMS configuré pour votre instance Commerce.
Étape 1 : installer le package assets-commerce
-
Accédez à AEM Cloud Manager, sélectionnez un programme, puis créez des environnements de production et d’évaluation à intégrer à Adobe Commerce.
-
Configurez un pipeline de déploiement ou vérifiez que votre pipeline peut déployer les modifications dans l’environnement sélectionné.
-
Clonez le référentiel Git géré par Adobe pour le programme sélectionné.
-
À partir de GitHub, téléchargez le code du package à partir du référentiel AEM Assets Commerce.
-
À 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.
-
Dans tous les
filter.xmletpom.xml filesde votre projet, remplacez toutes les occurrences de<my-app>par le nom de votre application.
-
Validez les modifications et envoyez votre branche de développement local au référentiel Git de Cloud Manager.
-
Depuis AEM Cloud Manager, mettez à jour l’environnement AEM à l’aide du pipeline pour déployer votre code.
-
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 Commerce.
-
Les SKU de produit et les champs
Eligible for Commercesont visibles.
-
L’onglet Commerce n’est pas visible dans les propriétés
Si l’onglet Commerce n’apparaît pas dans les propriétés, vous devez en créer un manuellement dans l’éditeur de schéma de métadonnées.
-
Accédez à l’éditeur de schéma de métadonnées.
-
Cliquez sur Modifier pour modifier le formulaire de schéma de métadonnées par défaut.
-
Créez un onglet Commerce et sélectionnez-le.
-
Faites glisser et déposez le composant Product dans l’onglet Commerce et mappez-le à la
commerce:skusde propriété. -
Cochez la case Afficher les rôles et Afficher l’ordre.
-
Faites glisser et déposez un composant case à cocher dans l’onglet Commerce et mappez-le à l’
commerce:isCommercede 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
-
Connectez-vous à l’environnement de création de Adobe Experience Manager.
-
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 .
{width="600" modal="regular"}
-
Ouvrez les outils d’administration en sélectionnant l’icône en forme de marteau.
{width="600" modal="regular"}
-
Ouvrez la page de configuration du profil en cliquant sur Metadata Profiles.
-
Create un profil de métadonnées pour l’intégration de Commerce.
{width="600" modal="regular"}
-
Ajoutez un onglet pour les métadonnées Commerce.
-
Sur la gauche, cliquez sur Settings.
-
Cliquez sur + dans la section d’onglet, puis spécifiez le Tab Name,
Commerce.
-
-
Ajoutez le champ
Eligible for Commerceau formulaire. {width="600" modal="regular"}
-
Cliquez sur Build form.
-
Faites glisser le champ
Single Line textvers le formulaire. -
Ajoutez le texte
Eligible for Commercepour 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
-
-
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 Statusde l’onglet
Basicsurapproved. -
Enregistrez la mise à jour.
Application du profil de métadonnées au dossier source des ressources Commerce
-
Sur la page Metadata Profiles, sélectionnez le profil d’intégration de Commerce.
-
Dans le menu d’actions, sélectionnez Apply Metadata Profiles to Folders.
-
Sélectionnez le dossier contenant les ressources Commerce.
Créez un dossier Commerce s’il n’existe pas.
-
Cliquez sur Apply.
Étapes suivantes
-
[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.
-
[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)."} Configurez l’intégration à partir de l’administration Commerce.