Desarrollo de AEM Commerce para AEM as a Cloud Service

El desarrollo de proyectos de AEM Commerce basados en Commerce Integration Framework (CIF) para AEM as a Cloud Service sigue las mismas reglas y recomendaciones como otros Proyectos AEM también en AEM as a Cloud Service. Primero revise estos:

Desarrollo local con SDK de AEM as a Cloud Service

Se recomienda contar con un entorno de desarrollo local para trabajar con proyectos CIF. El complemento CIF previsto para los entornos de 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.

¿Es novato en el uso de AEM as a Cloud Service? Consulte una guía más detallada sobre la configuración de un entorno de desarrollo local con el AEM como SDK de Cloud Service.

Software necesario

Lo siguiente debe instalarse de manera local:

Acceso al complemento CIF.

El complemento CIF se puede descargar como archivo zip desde el portal de distribución de software. El archivo zip contiene el complemento CIF como archivo de características de Sling, no es un paquete de AEM. Tenga en cuenta que el acceso a los listados de SDK está limitado a aquellos con una licencia de AEM as a Cloud Service.

CONSEJO

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

Configuración local

Para el desarrollo del complemento CIF local mediante el uso del SDK de AEM as a Cloud Service, realice los siguientes pasos:

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

  2. Desempaquete el archivo .jar de AEM para crear la carpeta crx-quickstart , ejecute:

    java -jar <jar name> -unpack
    
  3. Cree 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 CIF contiene dos .far archivos del archivo de funciones Sling. 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 con el nombre COMMERCE_ENDPOINT que mantenga el extremo Magento GraphQL.

    Ejemplo con Mac OSX:

    export COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    

    Ejemplo con Windows:

    set COMMERCE_ENDPOINT=https://demo.magentosite.cloud/graphql
    

    Esta variable es utilizada por AEM para conectarse a su sistema comercial. Además, el complemento CIF incluye un proxy inverso local para que el extremo de Magento GraphQL esté disponible localmente. Esto lo utilizan las herramientas de creación de CIF (consola de producto y selectores) y los componentes de CIF del lado del cliente que realizan llamadas directas de GraphQL.

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

  6. (Opcional) Para habilitar las funciones de catálogo por etapas, debe crear un token de integración para la instancia de Magento. Siga los pasos que se indican en Introducción para crear el token.

    Establezca un secreto OSGi con el nombre COMMERCE_AUTH_HEADER en el siguiente valor:

    Authorization: Bearer <Access Token>
    

    Para obtener más información sobre los secretos, consulte Configuración de OSGi para AEM como Cloud Service.

  7. Inicie el SDK de AEM as a Cloud Service

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

Configuración del proyecto

Existen dos maneras de arrancar su proyecto CIF para AEM as a Cloud Service.

Uso del tipo de archivo del proyecto AEM

El tipo de archivo del proyecto AEM es la principal herramienta para arrancar 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.

CONSEJO

Utilice un tipo de archivo del proyecto AEM 24 o posterior para 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, utilice la opción includeCommerce .

Por ejemplo:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

Los componentes principales de CIF pueden utilizarse en cualquier proyecto incluido el paquete proporcionado all o utilizando individualmente el paquete de contenido de CIF y los paquetes de OSGI relacionados. Para añadir los componentes principales de CIF manualmente 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-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

Una segunda opción para el inicio de un proyecto CIF es clonar y utilizar la Tienda de referencia de Venia de AEM. La Tienda de referencia de Venia de AEM es una aplicación de tienda 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, así como un punto de partida potencial para desarrollar su propia funcionalidad.

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

NOTA

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

Recursos adicionales

En esta página