DocumentaciónCommerceIntegración de AEM Assets

Configuración del proyecto de AEM Assets

Última actualización: 11 de mayo de 2026

Creado para:

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

En este tema se describe cómo configurar el proyecto de AEM Assets para que el espacio de nombres de Commerce, el esquema de metadatos y la ficha Commerce estén disponibles en el entorno de creación de AEM. Para obtener información general sobre estos recursos, consulte Metadatos de Commerce en AEM Assets.

Tiene dos opciones para configurar el proyecto de AEM Assets:

  • [Recomendado]{class="badge positive"} Incorporación de autoservicio: en las versiones de AEM 2026.5.26309 y posteriores, habilite la integración en Cloud Manager configurando una variable de entorno y activando Dynamic Media con las capacidades de OpenAPI. No se requiere una implementación de código personalizado. Consulte Habilitar la integración de Commerce (autoservicio).

  • Configuración manual: implemente el paquete assets-commerce a través de una canalización de Cloud Manager. Siga estos pasos manuales cuando deba implementar código de paquete personalizado o si está en una versión de AEM anterior a 2026.5.26309. Consulte Instalar el paquete de assets-commerce manualmente.

TIP
Puede comprobar la versión actual de AEM en el menú superior derecho: Help > About AEM.

Habilitar la integración de Commerce (autoservicio) enable-aem-commerce-self-service

[Compatible]{class="badge informative" title="Admitido"} con la versión de AEM 2026.5.26309 y posterior.

En las versiones de AEM admitidas, se habilita la integración de Commerce desde Cloud Manager sin implementar ningún código personalizado. El área de nombres de Commerce, el esquema de metadatos y la ficha Commerce se aprovisionan automáticamente al habilitar la integración en el servicio de creación.

Requisitos previos de autoservicio

  • Acceso al programa AEM Cloud Manager y a los entornos con los roles de Administrador de implementación y Programa.

  • Un programa de AEM en la versión 2026.5.26309 o posterior.

  • La ID de organización de IMS para su instancia de Commerce.

    Tanto la instancia de Commerce como el entorno de creación de AEM Assets deben estar en la misma organización de IMS.

Paso 1: Crear el programa y los entornos

La creación de un programa en Cloud Manager es un único proceso de asistente: el programa y sus entornos se configuran en varios pasos y se guardan juntos al final.

  1. En Cloud Manager, seleccione Add Program.

  2. Elija Set up for production, escriba un nombre de programa y seleccione Continue.

  3. En el paso Solutions & Add-ons, seleccione las soluciones y los complementos que requiere su proyecto, incluido Dynamic Media, y después seleccione Continue.

    Paso de soluciones y complementos de Cloud Manager con Dynamic Media seleccionado {width="600" modal="regular"}

  4. En el paso Add Environment, escriba nombres para los entornos Production y Staging y, a continuación, seleccione una región.

    Cuadro de diálogo Agregar entorno de Cloud Manager con detalles de Producción y Ensayo {width="600" modal="regular"}

  5. Seleccione Save para crear el programa con sus entornos.

Paso 2: Habilitar la variable de integración de Commerce

En Cloud Manager, abra el entorno que creó en el paso 1 y, a continuación:

  1. Seleccione la ficha Configuration.

  2. Agregue una variable de entorno con los siguientes valores y, a continuación, seleccione Add y Save:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo Valor
    Nombre COMMERCE_INTEGRATION_ENABLED
    Valor true
    Servicio aplicado Autor
    Tipo Variable

    Configuración del entorno de Cloud Manager con la variable COMMERCEINTEGRATIONENABLED aplicada al servicio de creación {width="600" modal="regular"}

    El entorno se actualiza para aplicar la configuración. Espere hasta que el estado del entorno vuelva a Running.

Paso 3: Activar Dynamic Media con las capacidades de OpenAPI

  1. En la ficha del entorno General, busque Dynamic Media.

  2. Junto a Las funcionalidades de OpenAPI están disponibles, seleccione Click to activate.

    Pestaña General de entorno que muestra el vínculo de activación de Dynamic Media OpenAPI {width="600" modal="regular"}

    La activación se ejecuta en segundo plano. Cuando se complete, el entorno estará listo para la integración de Commerce.

    note
    NOTE
    Si Click to activate no está disponible, abra un ticket de asistencia para habilitar Dynamic Media con las funcionalidades de OpenAPI.

Paso 4: Validar la configuración

Cambie al entorno de creación de AEM Assets y abra cualquier recurso. Edite sus propiedades y confirme que el esquema de metadatos predeterminado incluye la pestaña Commerce y que los campos Product Data y Eligible for Commerce están visibles.

Instalación manual del paquete de assets-commerce

NOTE
Utilice este método manual para implementar el código de paquete personalizado o si está en versiones de AEM anteriores a 2026.5.26309. En las versiones compatibles, use Habilitar la integración de Commerce (autoservicio).

Requisitos previos

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

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 esta información:

  • Título: Habilite la API de apertura de Dynamic Media para integrar Adobe Commerce completamente 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.

Pasos de instalación

  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.

Configuración de un perfil de metadatos (opcional)

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. Para utilizar estos valores predeterminados automáticamente, aplique el nuevo perfil a las carpetas de recursos de AEM. 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 ficha 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