Guida introduttiva a Contenuto AEM e Commerce

Per iniziare a utilizzare AEM contenuti e Commerce, è necessario installare il componente aggiuntivo Contenuto AEM e Commerce per AEM 6.5.

Requisiti software minimi

AEM 6.5 Service Pack È richiesto 7 o versioni successive.

Onboarding

L’onboarding per AEM contenuto e commerce è un processo in due fasi:

  1. Installare il componente aggiuntivo Contenuto AEM e Commerce per AEM 6.5

  2. Connetti AEM con la tua soluzione commerce

Installare il componente aggiuntivo Contenuto AEM e Commerce per AEM 6.5

Scarica e installa AEM Commerce Add-On per AEM 6.5 dal Distribuzione di software portale.

Avvia e installa il Service Pack AEM 6.5 richiesto. È consigliabile installare l’ultimo service pack disponibile.

NOTA

Questo verrà fatto dal CSE per i clienti di AEM Managed Service.

Connetti AEM al tuo Commerce System

AEM può essere collegato a qualsiasi sistema commerce con un endpoint GraphQL accessibile per AEM. Questi endpoint sono solitamente disponibili pubblicamente oppure possono essere collegati tramite VPN privata o connessioni locali a seconda della configurazione del singolo progetto.

Facoltativamente, è possibile fornire l’intestazione di autenticazione per utilizzare funzionalità CIF aggiuntive che richiedono l’autenticazione.

Progetti generati da Archetipo di progetto AEMe AEM Venia Reference Store che è già incluso nel configurazione predefinita devono essere adeguati.

Sostituisci il valore del url in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json con l’endpoint GraphQL del sistema commerce. Questa configurazione può essere effettuata tramite la console OSGI o distribuendo la configurazione OSGI tramite il progetto. Sono supportate configurazioni diverse per i sistemi di staging e produzione utilizzando diverse modalità di esecuzione AEM.

I componenti core AEM Content and Commerce e CIF utilizzano sia connessioni lato server che lato client AEM. I componenti core CIF lato client e gli strumenti di authoring dei componenti aggiuntivi CIF si collegano per impostazione predefinita a /api/graphql. Se necessario, è possibile regolarlo tramite la configurazione del Cloud Service CIF (vedi di seguito).

Il componente aggiuntivo CIF fornisce un servlet proxy GraphQL in /api/graphql che possono essere eventualmente utilizzati per sviluppo locale. Per le distribuzioni di produzione si consiglia vivamente di impostare un proxy inverso per l’endpoint GraphQL di e-commerce tramite il Dispatcher AEM o altri livelli di rete (come CDN).

Configurazione di store e cataloghi

Il componente aggiuntivo e il Componenti core CIF può essere utilizzato su più strutture di AEM sito collegate a diversi store di e-commerce (o viste store e così via). Per impostazione predefinita, il componente aggiuntivo CIF viene distribuito con una configurazione predefinita che si collega all’archivio e al catalogo predefiniti di Adobe Commerce.

Questa configurazione può essere regolata per il progetto tramite la configurazione del Cloud Service CIF, come descritto di seguito:

  1. In AEM vai a Strumenti -> Cloud Services -> Configurazione CIF

  2. Seleziona la configurazione di e-commerce da modificare

  3. Apri le proprietà di configurazione tramite la barra delle azioni

Configurazione dei Cloud Services CIF

È possibile configurare le seguenti proprietà:

  • Client GraphQL: seleziona il client GraphQL configurato per la comunicazione back-end Commerce. In genere questo dovrebbe rimanere il valore predefinito.

  • Visualizzazione archivio: l'identificatore della vista archivio. Se questo campo viene lasciato vuoto, verrà utilizzata la visualizzazione archivio predefinita.

  • Percorso proxy GraphQL: percorso URL del proxy GraphQL in AEM per le richieste proxy all’endpoint GraphQL di back-end per e-commerce.

    NOTA

    Nella maggior parte delle impostazioni il valore predefinito /api/graphql non devono essere modificate. Solo la configurazione avanzata che non utilizza il proxy GraphQL fornito dovrebbe modificare questa impostazione.

  • Abilita supporto UID catalogo : abilita il supporto per UID invece di ID nelle chiamate GraphQL di back-end per e-commerce.

    NOTA

    Il supporto per gli UID è stato introdotto in Adobe Commerce 2.4.2. Abilitalo solo se il backend commerce supporta uno schema GraphQL della versione 2.4.2 o successiva.

  • Identificatore della categoria principale del catalogo: l'identificatore (UID o ID) della directory principale del catalogo store

    ATTENZIONE

    A partire dalla versione 2.0.0 dei componenti core CIF , il supporto per id è stato rimosso e sostituito con uid. Se il progetto utilizza i componenti core CIF versione 2.0.0, è necessario abilitare il supporto per gli UID del catalogo e utilizzare un UID di categoria valido come "Identificatore di categoria principale del catalogo".

La configurazione mostrata sopra è di riferimento. I progetti devono fornire le proprie configurazioni.

Per configurazioni più complesse che utilizzano più strutture di siti AEM combinate con diversi cataloghi di e-commerce, consulta la sezione Configurazione di Commerce Multi-Store esercitazione.

Risorse aggiuntive

In questa pagina