DocumentaciónCommerceIntegración de AEM Assets

Metadatos de Commerce en AEM Assets

Última actualización: 30 de septiembre de 2026

Creado para:

  • Usuario

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.

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. Los cuatro roles estándar (image, small_image, thumbnail y swatch_image) siguen siendo compatibles. A partir de la versión 1.4.6 de la extensión de integración de AEM Assets, también puede establecer una función de imagen personalizada en commerce:roles, como hero o custom_role_1, para sincronizar una función que Commerce no defina de forma predeterminada. Consulte Coincidencia automática personalizada para ver cómo se incorporan los roles de imagen personalizados.

      note
      NOTE
      Commerce crea automáticamente un atributo de estilo media_image que falta para un rol personalizado.

    • 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.

Ejemplo de valores de metadatos:

commerce:altTextStoreViews = ["en_US", "fr_FR"]
commerce:altTextValues = ["Running shoe", "Chaussure de course"]

Cuando estos recursos se sincronizan con Adobe Commerce, cada valor de texto alternativo se escribe en el campo de imagen estándar de Commerce Label para el código de vista de tienda coincidente. La integración no rellena una columna de base de datos alt_text creada por el cliente.

El texto alternativo se localiza por vista de tienda, pero la asignación de imagen de producto y la asignación de galería subyacentes permanecen sin cambios. Una sola asignación de imagen sigue aplicándose según el comportamiento existente en la galería de Commerce.

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