Per iniziare a utilizzare AEM Commerce as a Cloud Service, è necessario eseguire il provisioning di Experience Manager Cloud Service con il componente aggiuntivo Commerce Integration Framework (CIF). Il componente aggiuntivo CIF è un modulo aggiuntivo per AEM Sites as a Cloud Service.
L’onboarding per AEM Commerce as a Cloud Service è un processo in due fasi:
Il primo passaggio di onboarding è effettuato per Adobe. Per maggiori informazioni su prezzi e provisioning, contatta il tuo rappresentante commerciale.
Una volta effettuato il provisioning con il componente aggiuntivo CIF, questo verrà applicato a tutti i programmi Cloud Manager esistenti. Se non disponi di un programma Cloud Manager, dovrai crearne uno nuovo. Per ulteriori informazioni, consulta Configurare il programma.
Il secondo passaggio è autonomo per ogni ambiente AEM as a Cloud Service. Dopo il provisioning iniziale del componente aggiuntivo CIF, è necessario effettuare alcune configurazioni aggiuntive.
Per collegare il componente aggiuntivo CIF e Componenti core CIF dell’AEM con una soluzione commerce, devi fornire l’URL dell’endpoint GraphQL tramite una variabile di ambiente Cloud Manager. Il nome della variabile è COMMERCE_ENDPOINT
. È necessario configurare una connessione protetta tramite HTTPS.
Questa variabile di ambiente viene utilizzata in due posizioni:
/api/graphql
. Questo viene utilizzato dagli strumenti di creazione commerce dell’AEM (componente aggiuntivo CIF) e dai componenti lato client CIF.Per ogni ambiente AEM as a Cloud Service, è possibile utilizzare un diverso URL endpoint GraphQL di In questo modo i progetti possono collegare gli ambienti di staging AEM con i sistemi di staging commerce e l’ambiente di produzione AEM a un sistema di produzione commerce. L’endpoint GraphQL di deve essere disponibile pubblicamente; non sono supportate connessioni VPN private o locali. Facoltativamente, è possibile fornire un’intestazione di autenticazione per utilizzare funzioni CIF aggiuntive che richiedono l’autenticazione.
Facoltativamente e solo per Adobe Commerce Enterprise / Cloud, il componente aggiuntivo CIF supporta l’utilizzo di dati di catalogo per gli autori di AEM. È necessario configurare un’intestazione di autorizzazione. Questa intestazione è disponibile e utilizzata solo nelle istanze di authoring AEM per motivi di sicurezza. Le istanze di pubblicazione dell’AEM non possono mostrare dati di staging.
Esistono due opzioni per configurare l’endpoint:
Questa operazione può essere eseguita utilizzando una finestra di dialogo nella pagina Dettagli dell’ambiente. Quando si visualizza questa pagina per un programma abilitato per Commerce, se l’endpoint non è attualmente configurato viene visualizzato un pulsante:
Fai clic su questo pulsante per aprire una finestra di dialogo:
Dopo aver impostato l’endpoint e, facoltativamente, un’intestazione di autorizzazione per il supporto di cataloghi in staging, l’endpoint viene visualizzato nella pagina dei dettagli. Facendo clic sull’icona Modifica viene aperta la stessa finestra di dialogo in cui è possibile modificare l’endpoint, se necessario.
Per collegare l’AEM a una soluzione commerce tramite Adobe I/O CLI, effettua le seguenti operazioni:
Ottieni Adobe I/O CLI con il plugin Cloud Manager.
Controlla la Documentazione di Adobe Cloud Manager su come scaricare, configurare e utilizzare CLI ADOBE I/O con Plug-in CLI di Cloud Manager.
Autentica l’interfaccia della riga di comando Adobe I/O con il programma as a Cloud Service AEM
Imposta la variabile COMMERCE_ENDPOINT
in Cloud Manager.
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
Per informazioni dettagliate, consulta la documentazione CLI.
L’URL dell’endpoint GraphQL di Commerce deve puntare al servizio GraphQl di Commerce e utilizzare una connessione HTTPS sicura. Esempio: https://<yourcommercesystem>/graphql
.
Abilita funzioni di catalogo di staging che richiedono l’autenticazione (facoltativo)
Questa funzione è disponibile solo con Adobe Commerce Enterprise o Cloud Edition. Consulta Autenticazione basata su token per i dettagli.
Imposta il COMMERCE_AUTH_HEADER
variabile segreta in Cloud Manager:
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
A scopo di verifica, puoi elencare tutte le variabili di Cloud Manager utilizzando il seguente comando: aio cloudmanager:list-environment-variables ENVIRONMENT_ID
Dopodiché, potrai utilizzare AEM Commerce as a Cloud Service e implementare il progetto tramite Cloud Manager.
Il componente aggiuntivo CIF e Componenti core CIF può essere utilizzato su più strutture del sito AEM connesse a diversi store commerciali (o viste store, ecc.). 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 di Cloud Service CIF, come segue:
In AEM vai a Strumenti -> Cloud Services -> Configurazione CIF.
Seleziona la configurazione commerce da modificare
Apri le proprietà di configurazione tramite la barra delle azioni
È possibile configurare le seguenti proprietà:
Nella maggior parte delle impostazioni il valore predefinito /api/graphql
non deve essere modificato. Questa impostazione può essere modificata solo da una configurazione avanzata che non utilizza il proxy GraphQL fornito.
Il supporto per gli UID è stato introdotto in Adobe Commerce 2.4.2. Abilita questa opzione solo se il backend di e-commerce supporta uno schema GraphQL della versione 2.4.2 o successiva.
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, devi abilitare il supporto UID del catalogo e utilizzare un UID di categoria valido come "Identificatore della categoria principale del catalogo".
La configurazione mostrata sopra è a scopo 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, vedi Configurazione di più store di Commerce esercitazione.