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.
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:
- AEM Local 6 5
- AEM Paquete de servicio 6.5 de7 o posterior
- Java 11
- Apache Maven (3.3.9 o posterior)
- Nodo LTS
- npm 6+
- Git
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).
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:
-
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.
-
Desempaquete el archivo .jar de AEM para crear la carpeta
crx-quickstart
, ejecute:code language-bash java -jar <jar name> -unpack
-
Cree una carpeta
crx-quickstart/install
. -
CIF Copie el paquete completo del complemento de, descargado del Portal de distribución de software, en la carpeta
crx-quickstart/install
.
- 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.
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.
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.