Sviluppare AEM Commerce develop

Lo sviluppo di progetti AEM Commerce basati su Commerce integration framework (CIF) per AEM segue le stesse regole e best practice di altri progetti AEM. Rivedi prima quanto segue:

Sviluppo locale per AEM Commerce local

Si consiglia di utilizzare un ambiente di sviluppo locale con i progetti CIF.

Il componente aggiuntivo AEM Commerce per AEM, noto come componente aggiuntivo CIF, è disponibile anche per lo sviluppo locale e fornito come pacchetto AEM. Può essere scaricato dal portale di distribuzione software come feature pack.

Software richiesto

È necessario installare localmente quanto segue:

Accesso al componente aggiuntivo CIF

Il componente aggiuntivo CIF può essere scaricato dal portale di distribuzione software, cercare AEM Commerce add-on.

Configurazione locale

Per lo sviluppo di progetti CIF locali utilizzando AEM e il componente aggiuntivo CIF, effettuare le seguenti operazioni:

Verificare 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 CIF.

Usare AEM Project Archetype

Il Archetipo progetto AEM è lo strumento principale per Bootstrap un progetto preconfigurato per 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, utilizzare l'opzione includeCommerce.

Ad 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

Puoi utilizzare i Componenti core di CIF in qualsiasi progetto. Includi il pacchetto all fornito oppure utilizza il pacchetto di contenuti CIF e i bundle OSGi correlati singolarmente. Aggiungere manualmente componenti core CIF a un progetto utilizzando le dipendenze seguenti:

<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>

Utilizza 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à.

Inizia a usare Venia Reference Store clonando l'archivio Git e inizia a personalizzare il progetto in base alle tue esigenze.

Collegare AEM al sistema Commerce

Per collegare il progetto al sistema commerce, AEM deve essere configurato con l’endpoint GraphQL del sistema commerce.

Entrambi, un progetto generato da Archetipo progetto AEM o AEM Venia Reference Store, include già una configurazione predefinita che deve essere regolata.

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 AEM Commerce e i componenti core CIF si connettono all’endpoint Commerce GraphQL tramite il server AEM. Oppure direttamente dal browser. Per impostazione predefinita, i componenti core CIF lato client e gli strumenti di creazione dei componenti aggiuntivi CIF si connettono a /api/graphql. Se necessario, è possibile regolarlo tramite la configurazione di CIF Cloud Service (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.

Risorse aggiuntive