Komma igång med AEM Commerce as a Cloud Service start
För att komma igång med Adobe Experience Manager (AEM) Commerce as a Cloud Service måste Experience Manager Cloud Servicen etableras med tillägget Commerce integration framework (CIF). Tillägget CIF är en extra modul ovanpå AEM Sites as a Cloud Service.
Onboarding onboarding
Introduktionen AEM Commerce as a Cloud Service är en tvåstegsprocess:
- Aktivera AEM Commerce as a Cloud Service och CIF tillägg
- Koppla AEM Commerce as a Cloud Service till er e-handelslösning
Det första startsteget görs av Adobe. Mer information om priser och provisionering får du av din säljare.
När du har etablerat tillägget CIF tillämpas det på alla befintliga Cloud Manager-program. Om du inte har något Cloud Manager-program måste du skapa ett. Mer information finns i Konfigurera ditt program.
Det andra steget är självbetjäning för varje AEM as a Cloud Service-miljö. Det finns ytterligare konfigurationer som du måste göra efter den första etableringen av CIF.
Ansluta AEM till en Commerce-lösning solution
Om du vill ansluta CIF tillägg och AEM CIF kärnkomponenter med en e-handelslösning måste du ange GraphQL slutpunkts-URL:en via en Cloud Manager-miljövariabel. Variabelnamnet är COMMERCE_ENDPOINT. En säker anslutning via HTTPS måste konfigureras.
Miljövariabeln används på två ställen:
- GraphQL anropar från AEM till e-handelskunderna via en gemensam Sharable GraphQl-klient som används av de AEM CIF Core Components och kundprojektskomponenterna.
- Konfigurera en GraphQL proxy-URL för varje AEM som variabeln är inställd på
/api/graphql. Den här URL:en används av AEM utvecklingsverktyg (CIF) och CIF komponenter på klientsidan.
En annan GraphQL-slutpunkts-URL kan användas för varje AEM as a Cloud Service-miljö. På så sätt kan projekt koppla AEM staging-miljöer till e-handelssystem och AEM produktionsmiljö till ett handelsproduktionssystem. GraphQL-slutpunkten måste vara allmänt tillgänglig, privata VPN-anslutningar eller lokala anslutningar stöds inte. Om du vill kan du ange ett autentiseringshuvud om du vill använda ytterligare CIF funktioner som kräver autentisering.
Tillägget CIF, och endast för Adobe Commerce Enterprise/Cloud, har stöd för användning av mellanlagrade katalogdata för AEM. Dessa data kräver att du konfigurerar en auktoriseringshuvud. Den här rubriken är bara tillgänglig och används AEM författarinstanser av säkerhetsskäl. AEM Publish-instanser kan inte visa mellanlagrade data.
Det finns två alternativ för att konfigurera slutpunkten:
Via Cloud Manager användargränssnitt (standard) cm-ui
Den här konfigurationen kan göras med hjälp av en dialogruta på sidan Miljöinformation. När den här sidan visas för ett program som har Commerce aktiverat visas en knapp om slutpunkten inte är konfigurerad:
Om du klickar på den här knappen öppnas en dialogruta:
När slutpunkten och eventuellt en auktoriseringshuvud för stöd för mellanlagrad katalog har angetts visas slutpunkten på detaljsidan. Klicka på ikonen Redigera för att öppna samma dialogruta där du kan redigera slutpunkten, om det behövs.
Genom Adobe I/O CLI adobe-cli
Följ de här stegen för att ansluta AEM till en e-handelslösning via Adobe I/O CLI:
-
Skaffa Adobe I/O CLI med Cloud Manager plugin
Läs Adobe Cloud Manager-dokumentationen om hur du hämtar, konfigurerar och använder Adobe I/O CLI med Cloud Manager CLI-plugin.
-
Autentisera Adobe I/O CLI med AEM as a Cloud Service-programmet
-
Ange variabeln
COMMERCE_ENDPOINTi Cloud Managercode language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"Mer information finns i CLI-dokument.
GraphQL slutpunkts-URL för handel måste peka på e-handelns GraphQl-tjänst och använda en säker HTTPS-anslutning. Till exempel:
https://<yourcommercesystem>/graphql. -
Aktivera mellanlagrade katalogfunktioner som kräver autentisering (valfritt)
note note NOTE Den här funktionen är endast tillgänglig med Adobe Commerce Enterprise eller Cloud Edition. Mer information finns i Tokenbaserad autentisering. Ange den hemliga variabeln
COMMERCE_AUTH_HEADERi Cloud Manager:code language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
aio cloudmanager:list-environment-variables ENVIRONMENT_IDDu är redo att använda AEM Commerce as a Cloud Service och kan driftsätta ditt projekt via Cloud Manager.
Konfigurera butiker och kataloger catalog
Tillägget CIF och CIF Core Components kan användas på flera AEM webbplatsstrukturer som är anslutna till olika e-handelsbutiker (eller butiksvyer osv.). Som standard distribueras CIF-tillägget med en standardkonfiguration som ansluter till Adobe Commerce standardbutik och -katalog.
Den här konfigurationen kan justeras för projektet med hjälp av CIF Cloud Service-konfigurationen enligt följande steg:
-
Gå AEM till Verktyg > Cloud Service > CIF Konfiguration.
-
Välj den e-postkonfiguration som du vill ändra.
-
Öppna konfigurationsegenskaperna via åtgärdsfältet.
Följande egenskaper kan konfigureras:
-
GraphQL Client - Välj den konfigurerade GraphQL-klienten för e-handelskommunikation. Den här klienten ska normalt vara kvar som standard.
-
Butiksvy - butiksvyns identifierare. Om den är tom används standardbutiksvyn.
-
GraphQL Proxy Path - den URL-sökväg som GraphQL Proxy AEM använder för proxybegäranden till GraphQL-slutpunkt för e-handel.
note note NOTE I de flesta inställningar får standardvärdet /api/graphqlinte ändras. Endast avancerade inställningar som inte använder den angivna GraphQL-proxyn bör ändra den här inställningen.- Aktivera stöd för katalog-UID - aktivera stöd för UID i stället för ID i e-handelsserverdelens GraphQL-anrop.
note note NOTE Stöd för UID introducerades i Adobe Commerce 2.4.2. Aktivera bara UID:n om e-handelsbackend har stöd för ett GraphQL-schema av version 2.4.2 eller senare. - Katalogrotkategoriidentifierare - identifieraren (UID eller ID) för arkivkatalogroten
note caution CAUTION Från och med CIF Core Components version 2.0.0 har stödet för idtagits bort och ersatts meduid. Om ditt projekt använder CIF Core Components version 2.0.0 måste du aktivera stöd för katalog-UID och använda ett giltigt kategori-UID som"Katalogens rotkategoriidentifierare".
Konfigurationen som visas ovan är för referens. Projekten ska ha egna konfigurationer.
Mer komplexa inställningar finns i självstudiekursen Commerce Multi-Store Setup om du använder flera AEM webbplatsstrukturer i kombination med olika e-handelskataloger.