Documentation Commerce Guide d’intégration d’AEM Assets

Migrer des fichiers multimédias vers la gestion des ressources numériques AEM Assets

Last update: Thu Dec 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
CMS

Créé pour :

Utilisateur ou utilisatrice

Adobe Commerce et Adobe Experience Manager (AEM) fournissent des fonctionnalités intégrées pour rationaliser la migration des fichiers multimédias de Commerce vers AEM Assets système de gestion des ressources numériques (DAM). Vous pouvez également migrer des fichiers multimédias provenant d’autres sources.

Conditions préalables

Catégorie

Exigence

Configuration requise

Environnement AEM as a Cloud Service configuré avec AEM Assets
Capacité de stockage suffisante
Bande passante réseau pour les transferts de fichiers volumineux

Accès et autorisations requis

Accès des administrateurs à AEM Assets as a Cloud Service
Accès au système source où sont stockés les fichiers multimédias (Adobe Commerce ou système externe)
Autorisations appropriées pour accéder aux services de stockage dans le cloud

Compte d’espace de stockage

Compte de stockage Blob AWS S3 ou Azure
Configuration de conteneur/compartiment privé
Informations d’identification d’authentification

Contenu Source

Fichiers multimédias organisés prêts pour la migration
Fichiers image et vidéo dans des formats pris en charge par AEM Assets.
Nettoyer les ressources dupliquées

Préparation des métadonnées

Profil de métadonnées AEM Assets configuré pour les ressources Commerce
Valeurs de métadonnées mappées pour chaque ressource
Éditeur de fichier CSV (par exemple, Microsoft Excel)

Bonnes pratiques de migration

Traitez les ressources avant la migration en supprimant le contenu inutilisé et en double.
Organisez les ressources de manière logique par taille, format ou cas d’utilisation.
Envisagez de diviser les migrations importantes en lots plus petits.
Planifiez les importations gourmandes en ressources pendant les heures creuses.
Validez le mappage des métadonnées avant l’importation complète.

Workflow de migration

Suivez le workflow de migration pour exporter des fichiers multimédias depuis Adobe Commerce ou un autre système externe et les importer dans la gestion des ressources numériques d’AEM Assets.

Étape 1 : Exporter le contenu de la source de données existante

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

Pour les commerçants Adobe Commerce, le module de stockage à distance peut faciliter l’importation et l’exportation de fichiers multimédias. Ce module permet aux entreprises de stocker et de gérer des fichiers multimédias à l’aide de services de stockage à distance tels qu’AWS S3. Pour configurer le stockage distant de votre instance Commerce, consultez Configurer le stockage distant dans le Guide de configuration de Commerce.

Si des fichiers multimédias sont stockés en dehors d’Adobe Commerce, chargez-les directement vers l’une des sources de données prises en charge par AEM as a Cloud Service.

Étape 2 : créer un fichier CSV pour le mappage des métadonnées

Après avoir exporté les fichiers multimédias, créez un fichier CSV pour mapper ces ressources avec les métadonnées nécessaires à l’automatisation. Le fichier CSV doit inclure des champs pour product, position et role mapping, pour garantir l’alignement avec le profil de métadonnées AEM Assets.

Pour chaque fichier multimédia que vous prévoyez de migrer, saisissez les valeurs des champs de métadonnées inclus dans le profil de métadonnées AEM Assets pour les ressources Commerce comme décrit dans le tableau suivant.

Métadonnées

Description

Valeur

assetPath

Chemin d’accès complet où la ressource sera stockée dans le référentiel AEM Assets.

Utilisez le chemin d’accès pour créer des sous-dossiers afin d’organiser les ressources Commerce, par exemple les content/dam/commerce/<brand>/<type>.

/content/dam/commerce/<sub-folder>/..<filename>

commerce:positions

Position/ordre de la ressource dans les galeries de produits

Valeurs numériques multiples séparées par une barre verticale (« Number: multi »)

commerce:isCommerce

Indicateur signalant si la ressource est utilisée dans Commerce

Yes

commerce:skus

SKU de produit associés à cette ressource

Plusieurs valeurs de chaîne séparées par une barre verticale (chaîne : multi)

commerce:roles

Les rôles ou types d’images pour la ressource (par exemple, thumbnail, main image, swatch)

Plusieurs valeurs séparées par des points-virgules (par exemple, « miniature ; image ; image_échantillon ; image_petite »)

Code CSV

Utilisez cet exemple de code CSV pour créer le fichier dans un éditeur de code ou une tableur telle que Microsoft Excel.

code language-csv

code language-csv
`assetPath,commerce:positions{{Number: multi}},commerce:isCommerce{{String}},commerce:skus{{String: multi}},commerce:roles{{String: multi}} /content/dam/commerce/sample1.jpg,1,Yes,sku1,thumbnail; image; swatch_image; small_image /content/dam/commerce/sample2.jpg,1\|1\|1,Yes,sku1\|sku2\|sku3,thumbnail; image; swatch_image; small_image\|image\|image; small_change`

assetPath,commerce:positions{{Number: multi}},commerce:isCommerce{{String}},commerce:skus{{String: multi}},commerce:roles{{String: multi}}
/content/dam/commerce/sample1.jpg,1,Yes,sku1,thumbnail; image; swatch_image; small_image
/content/dam/commerce/sample2.jpg,1|1|1,Yes,sku1|sku2|sku3,thumbnail; image; swatch_image; small_image|image|image; small_change

Étape 3 : Importer en bloc Assets dans AEM Assets

Après avoir créé le fichier de mappage de métadonnées, utilisez l’outil d’importation en bloc AEM Assets pour importer vos ressources.

Voici un aperçu général de l’utilisation de l’outil.

Connectez-vous à votre environnement de création AEM Assets as a Cloud Service.
Dans la vue Outils Experience Manager, sélectionnez Assets > Bulk Import.

{width="600" modal="regular"}
Dans les configurations d’importation en bloc, sélectionnez Create pour ouvrir le formulaire de configuration.

{width="600" modal="regular"}
Configurez et enregistrez la configuration.

Vous aurez besoin de :
- Informations d’authentification pour la source de données
- Le dossier cible dans AEM Assets où seront stockés les fichiers importés
- Facultatif. Informations sur les types MIME, la taille de fichier et d’autres paramètres permettant de personnaliser la configuration de l’importation
- Chemin d’accès au fichier CSV de mappage de métadonnées que vous avez chargé dans l’instance d’espace de stockage.
Pour obtenir des instructions détaillées, consultez Configuration de l’outil d’importation en bloc dans le Guide de l’utilisateur d’AEM Assets as a Cloud Service.
Après avoir enregistré la configuration, utilisez les outils d’importation en bloc pour tester et exécuter l’opération d’importation.

recommendation-more-help

1e1bf82b-b08f-47bf-a397-ef30dbe31665