AEM Desarrollo de Commerce develop

AEM El desarrollo de proyectos de Commerce basados en Commerce integration framework CIF AEM AEM () para su sigue las mismas reglas y prácticas recomendadas que en otros proyectos de la. Primero revise estos:

AEM Desarrollo local para la aplicación de Commerce en la local

CIF Se recomienda contar con un entorno de desarrollo local para trabajar con proyectos de la.

NOTE
AEM AEM Las siguientes instrucciones le ayudan a configurar un entorno de desarrollo de local para la de Commerce CIF AEM usando el enfoque en la versión 6.5 (en la que se utiliza la). Si usa AEM as a Cloud Service AEM, consulte la documentación de Commerceas a Cloud Service 1}.

AEM El complemento de Commerce AEM para la versión de 6,5, también conocido como. CIF AEM El complemento también está disponible para el desarrollo local y se proporciona como paquete de. Se puede descargar del Portal de distribución de software como paquete de funciones.

Software requerido

Lo siguiente debe instalarse de manera local:

CIF Acceso al complemento de la

El complemento se puede descargar desde el Portal de distribución de software. Busque "Complemento de Commerce" (en inglés) y seleccione "Complemento de CIF AEM" (en inglés).

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

Configuración local

CIF AEM CIF Para el desarrollo local de proyectos en la comunidad, utilice los pasos siguientes del complemento de la y el:

  1. AEM AEM Obtenga la versión de 6.5 e instale el paquete de servicio de 6.5. AEM Se requiere el paquete de servicio 7 de.5, pero el Adobe recomienda instalar el último paquete de servicio disponible.

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

    code language-bash
    java -jar <jar name> -unpack
    
  3. Cree una carpeta crx-quickstart/install .

  4. CIF Copie el paquete completo del complemento de, descargado del Portal de distribución de software, en la carpeta crx-quickstart/install.

TIP
CIF Como alternativa, el paquete de complementos de la también se puede instalar mediante el Administrador de paquetes.
  1. AEM Iniciar el inicio rápido de la

Verifique la configuración mediante la consola OSGI: http://localhost:4502/system/console/osgi-installer. CIF La lista debe incluir los paquetes relacionados con el complemento de, el paquete de contenido y las configuraciones de OSGI. Asegúrese de que todos los paquetes estén iniciados.

Configuración del proyecto project

AEM Existen dos formas de iniciar su proyecto de Commerce CIF de la mediante el uso de la.

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. CIF Los componentes principales y todas las configuraciones requeridas se pueden incluir en un proyecto generado con una opción adicional.

TIP
Utilice un tipo de archivo del proyecto AEM 25 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 aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

CIF CIF Los componentes principales se pueden utilizar en cualquier proyecto incluyendo el paquete all proporcionado o utilizando el paquete de contenido y los paquetes OSGI relacionados de forma individual. 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-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

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 y 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 comience a personalizar 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 AEM y 6.5. Compruebe readme.md del proyecto para ver cómo se utilizan. AEM Para la versión 6.5, utilice el perfil classic.

AEM Conectar con el sistema de Commerce

AEM Para conectar el proyecto al sistema de comercio, debe configurarse con el punto final GraphQL del sistema de comercio.

AEM AEM Ambos, un proyecto generado por el Arquetipo de proyecto de o el Almacén de referencia de Venia, ya incluye una configuración predeterminada que debe ajustarse.

Reemplace el valor de url en com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json con el extremo GraphQL de su sistema comercial utilizado por el proyecto.

AEM El complemento de Commerce CIF y los componentes principales de la se conectan al extremo de GraphQL AEM de comercio a través del servidor de la y directamente a través del explorador. CIF CIF Las herramientas de creación de complementos de componentes principales de la del lado del cliente se conectan de forma predeterminada a /api/graphql. CIF Si es necesario, esto se puede ajustar mediante la configuración del Cloud Service de la (consulte a continuación).

CIF El complemento proporciona un servlet proxy de GraphQL en /api/graphql. AEM Si no planea utilizar un Dispatcher de la configuración local de la aplicación, se recomienda configurar también el servlet proxy de GraphQL.

Vaya a http://localhost:4502/system/console/configMgr y cree una configuración OSGI para el servicio Adobe CIF GraphQL Proxy Configuration. Utilice el mismo punto final de GraphQL de su sistema comercial que se utilizó para el cliente de GraphQL anterior.

Recursos adicionales

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2