DocumentaciónAEM as a Cloud ServiceGuía del usuario

Desarrollo de AEM Commerce para AEM as a Cloud Service develop

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Administrador

El desarrollo de proyectos de AEM Commerce, basados en Commerce integration framework (CIF) para AEM as a Cloud Service, sigue las mismas reglas y prácticas recomendadas que otros proyectos de AEM en AEM as a Cloud Service. Revise primero lo siguiente:

Desarrollo local con AEM as a Cloud Service SDK local

https://video.tv.adobe.com/v/347035/?quality=12&learn=on&captions=spa

Se recomienda contar con un entorno de desarrollo local para trabajar con proyectos CIF. El complemento de CIF proporcionado para AEM as a Cloud Service también está disponible para el desarrollo local. Se puede descargar desde el Portal de distribución de software.

El complemento CIF se proporciona como un archivo de funciones Sling. El archivo zip disponible en el portal de distribución de software incluye dos archivos de archivo de funciones Sling, uno para el Autor de AEM y otro para las instancias de AEM Publish.

TIP
Nuevo en AEM as a Cloud Service?
​>Consulte una guía más detallada para configurar un entorno de desarrollo local con AEM as a Cloud Service SDK.

Software requerido required-software

Lo siguiente debe instalarse de manera local:

Acceso al complemento de CIF accessing-add-on

El complemento de CIF se puede descargar como archivo zip desde el Portal de distribución de software. El archivo zip contiene el complemento de CIF como archivo de funciones Sling, no es un paquete de AEM. Se puede acceder a los anuncios de SDK con una licencia de AEM as a Cloud Service.

TIP
Asegúrese de utilizar siempre la última versión del complemento CIF.

Configuración local local-setup

Para el desarrollo de complementos locales de CIF mediante el uso de AEM as a Cloud Service SDK, realice los siguientes pasos:

  1. Obtenga la última versión de AEM as a Cloud Service SDK.

  2. Desempaquete el archivo .jar de AEM para poder crear la carpeta crx-quickstart. Ejecute el siguiente comando:

    code language-bash 
    java -jar <jar name> -unpack

  3. Crear una carpeta crx-quickstart/install.

  4. Copie el archivo de funciones Sling correcto del complemento CIF en la carpeta crx-quickstart/install .

    • El archivo zip del complemento de CIF contiene dos archivos del archivo de funciones Sling .far.
    • Asegúrese de utilizar el correcto para Autor de AEM o AEM Publish, según cómo vaya a ejecutar el SDK de AEM as a Cloud Service local.

  5. Cree una variable de entorno del sistema operativo local llamada COMMERCE_ENDPOINT que contenga el extremo de Adobe Commerce GraphQL.

    • AEM utiliza esta variable para conectarse a su sistema de comercio. El complemento de CIF incluye un proxy inverso local para que el extremo de Commerce GraphQL esté disponible localmente. Este proxy lo utilizan las herramientas de creación de CIF (consola de producto y selectores) y los componentes de cliente de CIF que realizan llamadas directas de GraphQL.

    • Esta variable también debe configurarse para el entorno de AEM as a Cloud Service. Para obtener más información sobre las variables, consulte Configuración de OSGi para AEM as a Cloud Service.

    • Ejemplo en macOS:

      code language-bash 
      export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql

    • Ejemplo en Windows:

      code language-bash 
      set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql

  6. (Opcional) Para habilitar las funciones de catálogo organizadas, debe crear un token de integración para la instancia de Adobe Commerce. Siga los pasos en Introducción para crear el token.

  7. Inicie AEM as a Cloud Service SDK.

NOTE
Asegúrese de iniciar AEM as a Cloud Service SDK en la misma ventana de terminal en la que se configuró la variable de entorno en el paso 5. Si la inicia en una ventana de terminal independiente o hace doble clic en el archivo .jar, asegúrese de que la variable de entorno esté visible.

Verifique la configuración a través de la consola OSGi: http://localhost:4502/system/console/osgi-installer. La lista debe incluir los paquetes relacionados con el complemento de CIF, el paquete de contenido y las configuraciones OSGi tal como se definen en el archivo del modelo de funciones.

Configuración del proyecto project

Existen dos maneras de crear un Bootstrap para su proyecto de CIF para AEM as a Cloud Service.

Uso del tipo de archivo del proyecto AEM project-archetype

El tipo de archivo del proyecto AEM es la herramienta principal para Bootstrap en un proyecto preconfigurado para comenzar con CIF. Los componentes principales de CIF y todas las configuraciones requeridas pueden incluirse en un proyecto generado con una opción adicional.

TIP
Use siempre la versión más reciente de AEM Project Archetype para poder generar el proyecto.

Consulte las instrucciones de uso del tipo de archivo del proyecto AEM para saber cómo generar un proyecto AEM. Para incluir CIF en el proyecto, use la opción includeCommerce.

Por ejemplo:

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=35 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D includeCommerce=y

Los componentes principales de CIF se pueden utilizar en cualquier proyecto incluido el paquete all proporcionado o utilizando individualmente el paquete de contenido de CIF y los paquetes OSGi relacionados. Para agregar manualmente componentes principales de CIF a un proyecto, utilice las siguientes dependencias:

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

Tienda de referencia Venia en AEM venia-reference

Una segunda opción para el inicio de un proyecto CIF es clonar y utilizar la Tienda de referencia de Venia de AEM. AEM Venia Reference Store es una aplicación de escaparate de referencia que muestra el uso de los componentes principales del CIF de AEM. Está diseñada como un conjunto de ejemplos de prácticas recomendadas y un punto de partida potencial para desarrollar su propia funcionalidad.

Para empezar con la Tienda de referencia de Venia, clone el repositorio Git y el inicio personalizando el proyecto según sus necesidades.

NOTE
El proyecto Tienda de referencia de Venia contiene dos perfiles de compilación para AEM as a Cloud Service y AEM 6.5. Compruebe readme.md del proyecto para ver cómo se utilizan.

Recursos adicionales additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab