Desarrollo de AEM Commerce para AEM as a Cloud Service develop
AEM AEM El desarrollo de proyectos de comercio de, basados en el Commerce Integration Framework (CIF) para el as a Cloud Service AEM AEM de la integración comercial, sigue las mismas reglas y prácticas recomendadas que otros Proyectos de la integración comercial () en el as a Cloud Service de la. Revise primero lo siguiente:
Desarrollo local con SDK de AEM as a Cloud Service local
Se recomienda contar con un entorno de desarrollo local para trabajar con proyectos CIF. AEM El complemento CIF previsto para el 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? Desproteger AEM una guía más detallada para configurar un entorno de desarrollo local con el SDK as a Cloud Service de la.
Software requerido
Lo siguiente debe instalarse de manera local:
- SDK de AEM as a Cloud Service
- Java™ 11
- Apache Maven (3.3.9 o posterior)
- Node.js v10+
- npm 6+
- Git
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 funciones Sling AEM No, no es un paquete de. AEM Se puede acceder a los listados de SDK con una licencia as a Cloud Service.
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:
-
Obtenga la última versión de SDK de AEM as a Cloud Service
-
AEM Desempaquete el archivo .jar de la aplicación para poder crear el archivo .jar
crx-quickstart
carpeta, ejecute:code language-bash java -jar <jar name> -unpack
-
Cree una carpeta
crx-quickstart/install
. -
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. -
Cree una variable de entorno del sistema operativo local con el nombre
COMMERCE_ENDPOINT
que contiene el punto final de Adobe Commerce GraphQL.Ejemplo de macOS X:
code language-bash export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
Ejemplo con Windows:
code language-bash set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
AEM Esta variable la utiliza el usuario para conectarse a su sistema de comercio de. Además, el complemento 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 del CIF (consola de productos y selectores) y los componentes del lado del cliente del CIF que realizan llamadas directas a 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 AEM Configuración de OSGi para la as a Cloud Service.
-
(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 Primeros pasos para crear el token.
Establecer un secreto OSGi con el nombre
COMMERCE_AUTH_HEADER
al siguiente valor:code language-xml Authorization: Bearer <Access Token>
Para obtener más información sobre secretos, consulte AEM Configuración de OSGi para la as a Cloud Service.
-
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 project
Existen dos formas de Bootstrap AEM de su proyecto CIF para el as a Cloud Service de la.
Uso del tipo de archivo del proyecto AEM
El AEM Tipo de archivo del proyecto es la herramienta principal para el Bootstrap de 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.
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 el includeCommerce
opción.
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 del CIF pueden utilizarse en cualquier proyecto incluyendo el all
o individualmente mediante el paquete de contenido del CIF y los paquetes OSGI relacionados. Para añadir manualmente los componentes principales del 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
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 empezar con la Tienda de referencia de Venia, clone el repositorio Git y el inicio personalizando el proyecto según sus necesidades.