DocumentaciónCommerceIntegración de AEM Assets

Metadatos de Commerce en AEM Assets

Última actualización: 15 de julio de 2026

Creado para:

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

Los metadatos de Commerce son el contrato entre los AEM Assets y Commerce. Indica a Commerce qué recursos son para Commerce, a qué productos pertenecen y cómo deben utilizarse o mostrarse. Estos metadatos permiten a la integración de AEM Assets asignar y sincronizar correctamente los archivos de recursos.

Los metadatos de Commerce habilitan las siguientes funciones:

  • Marcar un recurso como apto para Commerce mediante el campo commerce:isCommerce.
  • Asocie un recurso con uno o más SKU de producto a través del campo commerce:skus.
  • Defina cómo aparece el recurso en Commerce mediante los campos commerce:roles y commerce:positions.
  • Agregar texto alternativo específico de Commerce con clave de vista de tienda a través de los campos commerce:altTextStoreViews y commerce:altTextValues.
  • Exponga estos campos en la interfaz de usuario de las propiedades de los AEM Assets a través de una ficha y un formulario de esquema de Commerce.
IMPORTANT
La funcionalidad Texto alternativo específico de Commerce aún no está disponible a través de la incorporación de autoservicio. Actualmente solo se proporciona al implementar el paquete de código personalizado assets-commerce (consulte Instalar el paquete de assets-commerce manualmente). La compatibilidad nativa está planificada para una próxima versión de AEM.

Para configurar estos recursos en su proyecto de AEM, consulte Configuración del proyecto de AEM Assets. El resto de este tema describe cómo se proporcionan los metadatos.

Contenido del paquete de AEM Commerce assets-commerce

Adobe proporciona el paquete de código AEM Commerce assets-commerce para agregar recursos de esquemas de metadatos y áreas de nombres de Commerce a la configuración 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 que muestran cómo se visualiza el recurso en Commerce.

    • Metadatos de varios campos de texto alternativo (Alt texts) para que los editores puedan escribir texto alternativo para cada código de vista de la tienda Commerce. El multicampo persiste en 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.

      Las implementaciones de App Builder que usan un coincidente externo pueden interceptar estas propiedades al transformar las cargas útiles de los recursos. 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 localizado 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 localizado 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.

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