Documentación Commerce Guía de integración de AEM Assets

Migrar archivos de medios al DAM de AEM Assets

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

Temas:
CMS

Creado para:

Usuario

Tanto Adobe Commerce como Adobe Experience Manager (AEM) proporcionan características integradas para optimizar la migración de archivos multimedia de Commerce al sistema de administración de recursos digitales (DAM) de los AEM Assets. También puede migrar archivos multimedia de otras fuentes.

Requisitos previos

Categoría

Requisito

Requisitos del sistema

Entorno de AEM as a Cloud Service aprovisionado con AEM Assets
Capacidad de almacenamiento suficiente
Ancho de banda de red para transferencias de archivos grandes

Acceso y permisos requeridos

Acceso de administrador a AEM Assets as a Cloud Service
Acceso al sistema de origen donde se almacenan los archivos multimedia (Adobe Commerce o sistema externo)
Permisos adecuados para acceder a los servicios de almacenamiento en la nube

Cuenta de almacenamiento en la nube

Cuenta de AWS S3 o Azure Blob Storage
Configuración de contenedor/contenedor privado
Credenciales de autenticación

Contenido de Source

Archivos de medios organizados listos para la migración
Archivos de imagen y vídeo en formatos admitidos por los AEM Assets.
Recursos limpios y duplicados

Preparación de metadatos

Perfil de metadatos de AEM Assets configurado para recursos de Commerce
Valores de metadatos asignados para cada recurso
Editor de archivos CSV (por ejemplo, Microsoft Excel)

Prácticas recomendadas de migración

Elimine el contenido no utilizado y duplicado para depurar los recursos antes de la migración.
Organice los recursos lógicamente por tamaño, formato o caso de uso.
Considere la posibilidad de dividir migraciones grandes en lotes más pequeños.
Programar importaciones que consuman muchos recursos durante las horas de menor actividad.
Valide la asignación de metadatos antes de la importación completa.

Flujo de trabajo migración

Siga el flujo de trabajo de migración para exportar archivos de medios desde Adobe Commerce u otro sistema externo e importarlos en el DAM de AEM Assets.

Paso 1: Exportación de contenido desde la fuente de datos existente

[Solo PaaS]{class="badge informative" title="Solo se aplica a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe)."}

Para los comerciantes de Adobe Commerce, el módulo de almacenamiento remoto puede facilitar la importación y exportación de archivos multimedia. Este módulo permite a las empresas almacenar y administrar archivos multimedia mediante servicios de almacenamiento remoto como AWS S3. Para configurar el almacenamiento remoto de su instancia de Commerce, consulte Configuración del almacenamiento remoto en la Guía de configuración de Commerce.

Si tiene archivos multimedia almacenados fuera de Adobe Commerce, cárguelos directamente a una de las fuentes de datos compatibles con AEM as a Cloud Service.

Paso 2: Crear un archivo CSV para la asignación de metadatos

Después de exportar los archivos multimedia, cree un archivo CSV para asignar estos recursos con los metadatos necesarios para la automatización. El CSV debe incluir campos para product, position y role mapping, lo que garantiza la alineación con el perfil de metadatos de AEM Assets.

Para cada archivo multimedia que planee migrar, proporcione valores para los campos de metadatos incluidos en el perfil de metadatos de AEM Assets para los recursos de Commerce, tal como se describe en la tabla siguiente.

Metadatos

Descripción

Valor

assetPath

Ruta de acceso completa en la que se almacenará el recurso en el repositorio de AEM Assets.

Utilice la ruta de acceso para crear subcarpetas para organizar los recursos de Commerce, por ejemplo content/dam/commerce/<brand>/<type>.

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

commerce:positions

La posición/orden del recurso en las galerías de productos

Varios valores numéricos separados por barra vertical ("Número: multi")

commerce:isCommerce

Indicador que indica si el recurso se utiliza en el comercio

Yes

commerce:skus

SKU de producto asociadas a este recurso

Varios valores de cadena separados por barra vertical (cadena: multi)

commerce:roles

Los roles o tipos de imágenes para el recurso (por ejemplo, thumbnail, main image, swatch)

Valores múltiples separados por punto y coma (por ejemplo, "thumbnail; image; swatch_image; small_image")

Código CSV

Utilice este código CSV de ejemplo para crear el archivo en un editor de código o una aplicación de hoja de cálculo como 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

Paso 3: Importación masiva de Assets en AEM Assets

Después de crear el archivo de asignación de metadatos, utilice la herramienta de importación masiva de AEM Assets para importar los recursos.

A continuación se ofrece una descripción general de alto nivel sobre el uso de la herramienta.

Inicie sesión en el entorno de as a Cloud Service Author para AEM Assets.
En la vista Herramientas de Experience Manager, seleccione Assets > Bulk Import.

{width="600" modal="regular"}
En Configuraciones de importación masiva, seleccione Create para abrir el formulario de configuración.

{width="600" modal="regular"}
Configure y guarde la configuración.

Necesitará lo siguiente:
- Credenciales de autenticación para la fuente de datos
- Carpeta de destino en los AEM Assets donde se almacenarán los archivos importados
- Opcional. Información sobre los tipos MIME, el tamaño de archivo y otros parámetros para personalizar la configuración de importación
- La ruta al archivo CSV de asignación de metadatos que ha cargado en la instancia de almacenamiento de Cloud.
Para ver los pasos detallados, consulte Configuración de la herramienta de importación masiva en la Guía del usuario de as a Cloud Service para AEM Assets.
Después de guardar la configuración, utilice las herramientas de importación masiva para probar y ejecutar la operación de importación.

recommendation-more-help

d5b74cdc-d9a8-404d-9105-1e69985d7e1b