Sviluppo di AEM Commerce

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. Prima di tutto, consulta i seguenti argomenti:

Sviluppo locale per AEM Commerce

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

NOTA

Le istruzioni seguenti sono utili per configurare un ambiente di sviluppo AEM locale per AEM Commerce utilizzando CIF per AEM 6.5). Se utilizzi AEM as a Cloud Service, consulta la sezione AEM Commerce as a Cloud Service documentazione.

Il componente aggiuntivo AEM Commerce per AEM 6.5 aka. Il componente aggiuntivo CIF è disponibile anche per lo sviluppo locale e viene 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, cerca il componente aggiuntivo "AEM Commerce".

SUGGERIMENTO

Occorre utilizzare sempre la versione più recente del componente aggiuntivo CIF.

Configurazione locale

Per lo sviluppo di progetti CIF locali utilizzando i passaggi AEM e il componente aggiuntivo CIF seguenti:

  1. Scarica la versione 6.5 di AEM e installa il Service Pack 6.5 di AEM. AEM 6.5 Service Pack 7 è necessario, tuttavia si consiglia di installare l'ultimo service pack disponibile.

  2. Decomprimi il file AEM.jar per creare la cartella crx-quickstart ed esegui:

    java -jar <jar name> -unpack
    
  3. Crea una cartella crx-quickstart/install.

  4. Copia il componente aggiuntivo CIF per tutti i pacchetti, scaricato dal portale di distribuzione software, in crx-quickstart/install cartella.

SUGGERIMENTO

In alternativa, il pacchetto aggiuntivo CIF può essere installato anche tramite Gestione pacchetti.

  1. Avvia l'avvio rapido 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

Esistono due modi per avviare il progetto Commerce di AEM utilizzando 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.

SUGGERIMENTO

Usa AEM Project Archetype 25 o versioni successive per generare il progetto.

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 i all un pacchetto o una persona che utilizza il pacchetto di contenuti CIF e i relativi bundle OSGI. 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 funzionalità personalizzate.

Per iniziare a usare Venia Reference Store, è sufficiente clonare il Archivio Git e inizia a personalizzare il progetto in base alle tue esigenze.

NOTA

Il progetto Venia Reference Store contiene due profili di generazione per AEM as a Cloud Service e AEM 6.5. Controlla il progetto readme.md per vedere come vengono utilizzati. Per AEM 6.5 utilizza la variabile classic profilo.

Connetti AEM a Commerce System

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

Entrambi, un progetto generato dalla Archetipo di progetto AEM o AEM Venia Reference Store, include già un configurazione predefinita che deve essere adeguato.

Sostituisci il valore del url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json con l’endpoint GraphQL del sistema commerce utilizzato dal progetto.

I componenti core AEM Commerce e CIF si collegano all’endpoint GraphQL di e-commerce tramite il server AEM e direttamente tramite il browser. Per impostazione predefinita, i componenti core CIF lato client e gli strumenti di creazione di componenti aggiuntivi 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 all’indirizzo /api/graphql. Se non prevedi di utilizzare un Dispatcher AEM locale, è consigliabile configurare anche il servlet proxy GraphQL.

Passa a http://localhost:4502/system/console/configMgr e crea una configurazione OSGI per Adobe CIF GraphQL Proxy Configuration servizio. Utilizza lo stesso endpoint GraphQL del sistema commerce utilizzato per il client GraphQL indicato sopra.

Risorse aggiuntive

In questa pagina