DocumentaciónCommerceGuía de integración de AEM Assets

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

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario

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 de ​

  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 Experience Manager Assets as a Cloud Service.

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.

  • 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 para obtener más información sobre el código de paquete de AEM Commerce.

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:

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. Configure una canalización de implementación o verifique que su canalización pueda implementar cambios en el entorno seleccionado.

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

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

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

  6. En todos los filter.xml y pom.xml files de su proyecto, reemplace todas las ocurrencias de <my-app> con el nombre de su aplicación.

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

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

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

  3. 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 ficha Commerce no aparece en las propiedades, debe crear manualmente una en el editor de esquemas de metadatos.

  1. Vaya al editor de esquemas de metadatos.

  2. Haga clic en 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. Haga clic en Apply.

Pasos siguientes

recommendation-more-help
d5b74cdc-d9a8-404d-9105-1e69985d7e1b