Sviluppo di AEM Commerce develop
Lo sviluppo di progetti Commerce dell'AEM basati su Commerce integration framework (CIF) per l'AEM segue le stesse regole e migliori pratiche di altri progetti AEM. Rivedi prima questi:
Sviluppo locale per AEM Commerce local
Si raccomanda l’utilizzo di un ambiente di sviluppo locale per i progetti CIF.
Il componente aggiuntivo AEM Commerce per AEM 6.5, alias. Il componente aggiuntivo CIF è disponibile anche per lo sviluppo locale ed è fornito come pacchetto AEM. Può essere scaricato dal portale di distribuzione software come feature pack.
Software richiesto
È necessario installare localmente quanto segue:
- AEM locale 6.5
- AEM 6.5 Service Pack 7 o versione successiva
- Java 11
- Apache Maven (3.3.9 o successivo)
- Nodo LTS
- npm 6+
- Git
Accesso al componente aggiuntivo CIF
Il componente aggiuntivo CIF può essere scaricato dal portale di distribuzione software, cercare 'componente aggiuntivo Commerce AEM'.
Configurazione locale
Per lo sviluppo locale di progetti CIF utilizzando l’AEM e il componente aggiuntivo CIF, procedere come segue:
-
Scarica la versione AEM 6.5 e installa il Service Pack AEM 6.5. È richiesto AEM 6.5 Service Pack 7, tuttavia l’Adobe consiglia di installare l’ultimo service pack disponibile.
-
Decomprimi il file AEM.jar per creare la cartella
crx-quickstart
ed esegui:code language-bash java -jar <jar name> -unpack
-
Crea una cartella
crx-quickstart/install
. -
Copiare il pacchetto del componente aggiuntivo CIF scaricato dal portale di distribuzione software nella cartella
crx-quickstart/install
.
- Avviare l’avvio rapido dell’AEM
Verifica la configurazione tramite la console OSGI:http://localhost:4502/system/console/osgi-installer
. L’elenco deve includere i bundle relativi al componente aggiuntivo CIF, il pacchetto di contenuti e le configurazioni OSGI. Assicurati che tutti i bundle siano avviati.
Configurazione del progetto project
Esistono due modi per avviare il progetto AEM Commerce utilizzando l’CIF.
Usare AEM Project Archetype
Il AEM Project Archetype è lo strumento principale per avviare un progetto preconfigurato con cui iniziare a utilizzare CIF. I Componenti core CIF e tutte le configurazioni richieste possono essere inclusi in un progetto generato con un’opzione aggiuntiva.
Consulta le istruzioni d’uso di AEM Project Archetype per la generazione di un progetto AEM. Per includere CIF nel progetto, usa l’opzione includeCommerce
.
Esempio:
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
I componenti core CIF possono essere utilizzati in qualsiasi progetto includendo il pacchetto all
fornito o singoli utenti tramite il pacchetto di contenuti CIF e i bundle OSGI correlati. Per aggiungere manualmente componenti core CIF a un progetto, usa le seguenti dipendenze:
<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>
Usare AEM Venia Reference Store
Una seconda opzione per avviare un progetto CIF è clonare e utilizzare AEM Venia Reference Store. AEM Venia Reference Store è un esempio di applicazione di vetrina di riferimento che illustra l’utilizzo dei componenti core CIF di AEM. Si tratta di un insieme di esempi di best practice e di un potenziale punto di partenza per sviluppare le tue funzionalità.
Per iniziare a utilizzare Venia Reference Store, è sufficiente clonare l'archivio Git e iniziare a personalizzare il progetto in base alle tue esigenze.
classic
.Collegare AEM al sistema Commerce
Per collegare il progetto al sistema commerciale, l’AEM deve essere configurato con l’endpoint GraphQL del sistema commerciale.
Entrambi, un progetto generato da Archetipo progetto AEM o Archivio riferimento Venia AEM, include già una configurazione predefinita che deve essere modificata.
Sostituire il valore di url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
con l'endpoint GraphQL del sistema commerce utilizzato dal progetto.
Il componente aggiuntivo Commerce AEM e i componenti core CIF si connettono all’endpoint GraphQL di commerce tramite il server AEM e direttamente tramite il browser. Per impostazione predefinita, i componenti core CIF lato client e gli strumenti di creazione del componente aggiuntivo CIF si connettono a /api/graphql
. Se necessario, questo può essere regolato tramite la configurazione del Cloud Service CIF (vedi sotto).
Il componente aggiuntivo CIF fornisce un servlet proxy GraphQL in /api/graphql
. Se non prevedi di utilizzare un Dispatcher AEM locale, è consigliabile configurare anche il servlet proxy di GraphQL.
Passare a http://localhost:4502/system/console/configMgr e creare una configurazione OSGI per il servizio Adobe CIF GraphQL Proxy Configuration
. Utilizza lo stesso endpoint GraphQL del sistema commerce utilizzato per il client GraphQL di cui sopra.