Sviluppare AEM Commerce per AEM as a Cloud Service develop

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 su AEM as a Cloud Service. Rivedi prima quanto segue:

Sviluppo locale con SDK di AEM as a Cloud Service local

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? Estrai una guida più dettagliata per la configurazione di un ambiente di sviluppo locale utilizzando l’SDK as a Cloud Service dell’AEM.

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. Gli elenchi dell’SDK sono accessibili con una licenza AEM as a Cloud Service.

TIP
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 .jar dell’AEM in modo da poter creare crx-quickstart cartella, esegui:

    code language-bash
    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. Creare una variabile di ambiente del sistema operativo locale denominata COMMERCE_ENDPOINT mantenendo l’endpoint Adobe Commerce GraphQL.

    Esempio di macOS X:

    code language-bash
    export COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

    Esempio Windows:

    code language-bash
    set COMMERCE_ENDPOINT=https://<yourcommercesystem>/graphql
    

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

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

  6. (Facoltativo) Per abilitare le funzioni di catalogo per staging, devi creare un token di integrazione per la tua istanza di Adobe Commerce. Segui i passaggi descritti in Guida introduttiva per creare il token.

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

    code language-xml
    Authorization: Bearer <Access Token>
    

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

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

NOTE
Assicurati di avviare l’SDK per AEM as a Cloud Service nella stessa finestra del terminale in cui è stata impostata la variabile di ambiente al punto 5. Se lo avvii in una finestra del terminale separata o facendo doppio clic sul file .jar, accertati 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 project

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

Usare AEM Project Archetype

Il Archetipo progetto AEM è lo strumento principale per la Bootstrap di 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.

TIP
Utilizza sempre la versione più recente di Archetipo progetto AEM in modo da poter generare il progetto.

Consulta le istruzioni d’uso di AEM Project Archetype per la generazione di un progetto AEM. Per includere CIF nel progetto, utilizza includeCommerce opzione.

Ad 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 il all o singolarmente utilizzando il pacchetto di contenuti CIF e i bundle OSGI correlati. Per aggiungere manualmente componenti core CIF a un progetto, utilizza 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>

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, clona l’archivio Git e inizia a personalizzare il progetto in base alle tue esigenze.

NOTE
Il progetto Venia Reference Store contiene due profili di build per AEM as a Cloud Service e AEM 6.5. Verifica file readme.md del progetto quindi potete vedere come vengono usati.

Risorse aggiuntive

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab