Sviluppare AEM Commerce per AEM as a Cloud Service

Lo sviluppo di progetti AEM Commerce basati su Commerce Integration Framework (CIF) per AEM as a Cloud Service segue le stesse regole e best practice di altri progetti AEM anche su AEM as a Cloud Service. Prima di tutto, consulta i seguenti argomenti:

Sviluppo locale con SDK di AEM as a Cloud Service

Si consiglia di utilizzare un ambiente di sviluppo locale con progetti CIF. Il componente aggiuntivo CIF fornito per AEM as a Cloud Service è disponibile anche per lo sviluppo locale. Può essere scaricato dal portale di distribuzione software.

Il componente aggiuntivo CIF viene fornito come archivio di Sling Feature. Il file zip disponibile nel portale di distribuzione software include due file di archivio Sling Feature, uno per l’istanza AEM di authoring e uno per quella di pubblicazione.

Ti avvicini adesso ad AEM as a Cloud Service? Consulta una guida più dettagliata alla configurazione di un ambiente di sviluppo locale tramite l’SDK AEM as a Cloud Service.

Software richiesto

È necessario installare localmente quanto segue:

Accesso al componente aggiuntivo CIF

Il componente aggiuntivo CIF può essere scaricato come file zip dal portale di distribuzione software. Il file zip contiene il componente aggiuntivo CIF come Archivio Sling Feature, non è un pacchetto AEM. L’accesso agli elenchi dell’SDK è limitato a quelli con licenza di AEM as a Cloud Service.

SUGGERIMENTO

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

Configurazione locale

Per lo sviluppo locale del componente aggiuntivo CIF utilizzando l’SDK di AEM as a Cloud Service, è necessario procedere seguendo questi passaggi:

  1. Scarica il più recente SDK di AEM as a Cloud Service.

  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 file di archivio Sling Feature corretto del componente aggiuntivo CIF nella cartella crx-quickstart/install.

    Il file ZIP del componente aggiuntivo CIF contiene due file di archivio Sling Feature .far. Usa sempre quello corretto per AEM Author o AEM Publish, a seconda di come verrà eseguito l’SDK locale di AEM as a Cloud Service.

  5. Crea una variabile di ambiente del sistema operativo locale denominata COMMERCE_ENDPOINT contenente l’endpoint GraphQL di Magento.

    Esempio Mac OSX:

    export COMMERCE_ENDPOINT=https://<yourmagentosystem>/graphql
    

    Esempio Windows:

    set COMMERCE_ENDPOINT=https://<yourmagentosystem>/graphql
    

    Questa variabile viene utilizzata da AEM per connettersi al sistema commerce. Inoltre, il componente aggiuntivo CIF include un proxy inverso locale per rendere l’endpoint Commerce GraphQL disponibile localmente. Viene utilizzato dagli strumenti di authoring CIF (console del prodotto e selettori) e per i componenti CIF lato client che eseguono chiamate GraphQL dirette.

    Questa variabile deve essere impostata anche per l’ambiente di AEM as a Cloud Service. Per ulteriori informazioni sulle variabili, vedi Configurazione di OSGi per AEM as a Cloud Service.

  6. (Facoltativo) Per abilitare le funzioni di catalogo in staging, devi creare un token di integrazione per l’istanza di Magento. Segui i passaggi descritti in Introduzione per creare il token.

    Imposta un segreto OSGi con il nome COMMERCE_AUTH_HEADER al seguente valore:

    Authorization: Bearer <Access Token>
    

    Per ulteriori informazioni sui segreti, vedi Configurazione di OSGi per AEM as a Cloud Service.

  7. Avvia l’SDK di AEM as a Cloud Service.

NOTA

Assicurati di avviare AEM SDK as a Cloud Service nella stessa finestra del terminale in cui è stata impostata la variabile di ambiente al passaggio 5. Se lo avvii in una finestra di terminale separata o facendo doppio clic sul file .jar, assicurati che la variabile di ambiente sia visibile.

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 come definiti nel file di modello della funzione.

Configurazione del progetto

Esistono due modi per avviare il progetto CIF per AEM as a Cloud Service.

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

Utilizza sempre la versione più recente del Archetipo di progetto AEM 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 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

I componenti core CIF possono essere utilizzati in qualsiasi progetto includendo i all crea un pacchetto o singolarmente utilizzando 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 l’archivio Git e iniziare a personalizzare il progetto in base alle proprie 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.

Risorse aggiuntive

In questa pagina