DocumentaciónCommerceIntegración de AEM Assets

Configuración del proyecto de AEM Assets para que admita metadatos de Commerce

Última actualización: 11 de mayo de 2026

Creado para:

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

Cuando utiliza AEM Assets como sistema de administración de recursos digitales (DAM) para Commerce, la instalación del paquete assets-commerce le permite administrar imágenes y vídeos para productos de Commerce desde el entorno de creación de AEM.

Complete los siguientes pasos para configurar el proyecto de AEM Assets con el código de paquete y los metadatos necesarios para administrar los recursos de Commerce desde el entorno de creación de AEM:

  1. Obtenga información acerca del contenido del paquete assets-commerce

  2. Complete los pasos de instalación para configurar el proyecto de AEM Assets para que admita metadatos de Commerce

Contenido del paquete de AEM Commerce assets-commerce

Adobe proporciona un código de paquete de AEM Commerce assets-commerce para agregar recursos de espacio de nombres de Commerce y esquema de metadatos a la configuración del entorno de as a Cloud Service de Experience Manager Assets.

Este código de paquete añade los siguientes recursos al entorno de creación de AEM Assets:

  • Un espacio de nombres personalizado, Commerce para identificar propiedades relacionadas con Commerce.

    • Un tipo de metadatos personalizado commerce:isCommerce con la etiqueta Eligible for Commerce para etiquetar recursos de Commerce asociados con un proyecto de Adobe Commerce.

    • Un tipo de metadatos personalizado commerce:skus y un componente de interfaz de usuario correspondiente para agregar una propiedad Product Data. Los datos de producto incluyen las propiedades de metadatos para asociar un recurso de Commerce con los SKU de producto.

      Control de IU de datos de productos personalizados {width="600" modal="regular"}

    • Atributos de tipo de metadatos personalizados commerce:roles y commerce:positions para mostrar cómo se visualiza el recurso en Commerce.

    • Metadatos de varios campos de texto alternativo (Alt texts) para que los editores puedan introducir texto alternativo escrito con clave por el código de vista de la tienda Commerce. Esto no cambia la forma en que las imágenes de producto se asignan o asignan en el ámbito del catálogo. Ver texto alternativo en los metadatos de los AEM Assets.

  • Un formulario de esquema de metadatos con una pestaña de Commerce que incluye los campos Eligible for Commerce y Product Data para etiquetar recursos de Commerce. El formulario también proporciona opciones para mostrar u ocultar los campos roles y position de la interfaz de usuario de AEM Assets.

    Ficha Commerce para el formulario de esquema de metadatos de AEM Assets {width="600" modal="regular"}

  • Un recurso de ejemplo etiquetado y aprobado por Commerce equipment_6.jpg para admitir la sincronización inicial de recursos. Solo los recursos de Commerce aprobados se pueden sincronizar de AEM Assets a Adobe Commerce.

NOTE
Consulte la página readme en GitHub para obtener más información sobre el código de paquete de AEM Commerce.

Texto alternativo en metadatos de AEM Assets

El multicampo Alt texts​está disponible en el editor de metadatos de recursos de AEM Assets en la pestaña Commerce​cuando edita una imagen elegible.

IMPORTANT
El comportamiento de vista por tienda se aplica solo a texto alternativo. La integración de AEM Assets no sincroniza diferentes imágenes de productos por vista de tienda de Adobe Commerce. Las imágenes de producto de AEM se siguen sincronizando con Commerce con el mismo comportamiento de asignación de galerías que antes de esta versión.

El multicampo contiene una fila por cada vista de tienda de Commerce. Cada fila tiene dos entradas:

  • Store View Code: el identificador de vista de almacén (por ejemplo default o en_US).

  • Alt Text: texto alternativo para esa vista de almacén, con un límite de 255 caracteres.

Seleccione Add para agregar más filas para vistas de tienda adicionales. Para quitar una fila, seleccione el icono Delete de esa fila para quitarla.

Varios campos de texto alternativo con entradas de código de vista de tienda y texto alternativo {width="600" modal="regular"}

Al guardar, la validación del lado del cliente bloquea el envío si alguna fila tiene un elemento Store View Code​vacío o si dos filas utilizan el mismo código de vista de almacén (sin distinción de mayúsculas y minúsculas).

Las entradas de texto alternativas persisten en los metadatos de recursos JCR como dos propiedades String[] alineadas con el índice:

  • commerce:altTextStoreViews: almacena el código de vista de cada fila.
  • commerce:altTextValues: texto alternativo coincidente en el mismo índice que cada entrada de commerce:altTextStoreViews.

Cuando estos recursos se sincronizan con Adobe Commerce, el texto alternativo de vista por tienda se escribe en la galería de medios del producto para los códigos de vista de tienda coincidentes. La asignación de imágenes subyacente no se ha modificado.

Requisitos previos

Necesita los siguientes recursos y permisos para implementar el código de paquete assets-commerce en el entorno as a Cloud Service AEM de AEM Assets:

Imágenes del producto

[Solo SaaS]{class="badge positive" title="Solo se aplica a los proyectos de Adobe Commerce as a Cloud Service y Adobe Commerce Optimizer (infraestructura de SaaS administrada por Adobe)."} Dynamic Media con capacidades OpenAPI es autoservicio para elementos visuales de productos con tecnología de AEM Assets.

  1. Vaya a Cloud Manager.

  2. Seleccione el entorno que desee.

  3. Habilite Dynamic Media con las funciones de OpenAPI.

    Si el botón Dynamic Media con funciones OpenAPI no está activo, abre un ticket de asistencia.

AEM Assets

[Solo PaaS]{class="badge informative" title="Solo se aplica a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe)."} En AEM as a Cloud Service, envía un ticket de asistencia de Adobe con la siguiente información:

  • Título: Habilite Dynamic Media OpenAPI para integrar completamente Adobe Commerce con los AEM Assets

    • Contenido del ticket de asistencia:

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

Una vez enviado el vale de soporte, Adobe habilita Dynamic Media con las capacidades de OpenAPI en su entorno de Cloud Services y comparte los detalles, como el ID de cliente de IMS, para que pueda continuar con la integración.

Paso 1: Instalación del paquete de assets-commerce

  1. Vaya a AEM Cloud Manager, seleccione un programa y cree entornos de producción y ensayo que desee integrar con Adobe Commerce.

  2. Clonar el repositorio de Git administrado por Adobe para el programa seleccionado.

    Credenciales del repositorio de Cloud Manager y comando para clonar {width="600" modal="regular"}

    En Cloud Manager Canalizaciones, seleccione Access Repo Info para abrir Repository Info. Copie el valor URL o Git command line, genere una contraseña de acceso si es necesario y luego clone localmente con su cliente Git.

  3. En GitHub, descargue el código del paquete del repositorio Commerce de AEM Assets.

  4. Desde su entorno de desarrollo local de AEM, copie manualmente el código descargado en el repositorio administrado de Adobe existente.

  5. En todos los archivos de filter.xml y pom.xml del proyecto, reemplace todas las apariciones de <my-app> por el nombre de su aplicación.

    note
    NOTE
    También puede instalar el código personalizado en la configuración de su proyecto de AEM Assets como un paquete de Maven.

  6. Confirme los cambios e inserte la rama de desarrollo local en el repositorio de Git de Cloud Manager.

  7. Configure una canalización de implementación o verifique que su canalización pueda implementar cambios en el entorno seleccionado.

    Canalizaciones de Cloud Manager {width="600" modal="regular"}

    Cuando exista la canalización, abra el menú de acciones (…) para Run, Edit, View/Edit variables u otras acciones; consulte la documentación de canalización de Cloud Manager vinculada anteriormente.

  8. Desde AEM Cloud Manager, actualice el entorno de AEM mediante la canalización para implementar su código.

  9. Vaya a cualquier recurso y edite sus propiedades para validar los cambios:

    • El esquema de metadatos predeterminado incluye la ficha Commerce.

    • Los SKU del producto y los campos Eligible for Commerce están visibles.

La pestaña Commerce no está visible en las propiedades

Si la pestaña Commerce no aparece en las propiedades, debe completar manualmente los siguientes pasos en el editor de esquemas de metadatos:

  1. Vaya al editor de esquemas de metadatos.

  2. Seleccione Editar para modificar el formulario de esquema de metadatos predeterminado.

  3. Cree una ficha Commerce y selecciónela.

  4. Arrastre y suelte el componente Product en la ficha Commerce y asígnelo a la propiedad commerce:skus.

  5. Seleccione la casilla de verificación para mostrar roles y mostrar pedido.

  6. Arrastre y suelte un componente checkbox en la ficha Commerce y asígnelo a la propiedad commerce:isCommerce. Defina Yes y No como las opciones.

Si tiene algún otro problema, cree un ticket de asistencia o póngase en contacto con su representante de ventas de integración de AEM Assets para obtener ayuda.

Paso 2: Opcional. Configuración de un perfil de metadatos

En el entorno de creación de AEM Assets, establezca los valores predeterminados para los metadatos de recursos de Commerce creando un perfil de metadatos. A continuación, aplique el nuevo perfil a las carpetas de recursos de AEM para utilizar automáticamente estos valores predeterminados. Esta configuración optimiza el procesamiento de recursos al reducir los pasos manuales.

Al configurar el perfil de metadatos, solo debe configurar los siguientes componentes:

  • Agregue una pestaña Commerce. Esta pestaña habilita las opciones de configuración específicas de Commerce que agrega la plantilla.

  • Agregue el campo Eligible for Commerce a la ficha Commerce.

El componente de interfaz de usuario de datos del producto se agrega automáticamente en función de la plantilla.

Definición del perfil de metadatos

  1. Inicie sesión en el entorno de creación de Adobe Experience Manager.

  2. En Adobe Experience Manager Workspace, vaya al espacio de trabajo Administración de contenido de autor para AEM Assets haciendo clic en el icono Adobe Experience Manager.

    AEM Assets creando {width="600" modal="regular"}

  3. Abra las Herramientas de administración seleccionando el icono de martillo.

    Administrador de autor de AEM administra perfiles de metadatos {width="600" modal="regular"}

  4. Abra la página de configuración del perfil haciendo clic en Metadata Profiles.

  5. Create un perfil de metadatos para la integración de Commerce.

    El administrador de autores de AEM agregó perfiles de metadatos {width="600" modal="regular"}

  6. Agregue una pestaña para los metadatos de Commerce.

    1. A la izquierda, haga clic en Settings.

    2. Haga clic en + en la sección de la ficha y, a continuación, especifique Tab Name, Commerce.

  7. Agregue el campo Eligible for Commerce al formulario.

    El administrador de autores de AEM agregó campos de metadatos al perfil {width="600" modal="regular"}

    • Haga clic en Build form.

    • Arrastre el campo Single Line text al formulario.

    • Agregue el texto Eligible for Commerce para la etiqueta haciendo clic en Field Label.

    • En la pestaña Configuración, agregue el texto de la etiqueta a Etiqueta de campo.

    • Establezca el texto del marcador de posición en yes.

    • En el campo Map to Property, copie y pegue el siguiente valor

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. Opcional. Para sincronizar automáticamente los recursos de Commerce aprobados a medida que se cargan en el entorno de AEM Assets, establezca el valor predeterminado del campo Review Status​en la pestaña Basic en approved.

  9. Guarde la actualización.

Aplicar el perfil de metadatos a la carpeta de origen de los recursos de Commerce

  1. En la página Metadata Profiles, seleccione el perfil de integración de Commerce.

  2. En el menú de acción, seleccione Apply Metadata Profiles to Folders.

  3. Seleccione la carpeta que contiene los recursos de Commerce.

    Cree una carpeta de Commerce si no existe.

  4. Seleccione Apply.

Pasos siguientes

recommendation-more-help
commerce-help-aem-assets-integration