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 din Experience Manager Cloud Service etableras med tillägget Commerce integration framework (CIF). CIF-tillägget är en extra modul ovanpå AEM Sites as a Cloud Service.
Onboarding onboarding
Introduktionen till AEM Commerce as a Cloud Service är en tvåstegsprocess:
- Aktivera AEM Commerce as a Cloud Service och aktivera CIF-tillägget
- Koppla samman AEM Commerce as a Cloud Service med en 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 dig med CIF-tillägget används det för 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-tillägget.
Ansluta AEM till en Commerce-lösning solution
Om du vill ansluta CIF-tillägget och AEM CIF Core Components 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 för att sälja backend, via en gemensam Sharable GraphQl-klient, som används av AEM CIF Core Components och kundprojektskomponenter.
- Konfigurera en GraphQL proxy-URL för varje AEM-miljö som variabeln är inställd på
/api/graphql. Den här URL:en används av AEM utvecklingsverktyg för e-handel (CIF-tillägg) och CIF klientkomponenter.
En annan GraphQL-slutpunkts-URL kan användas för varje AEM as a Cloud Service-miljö. På så sätt kan projekt koppla samman AEM staging-miljöer med e-handelssystem och AEM produktionsmiljö med 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 kan, och endast för Adobe Commerce Enterprise/Cloud, användas med mellanlagrade katalogdata för AEM-författare. Dessa data kräver att du konfigurerar en auktoriseringshuvud. Den här rubriken är bara tillgänglig och används på AEM Author-instanser 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
Så här ansluter du 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
-
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
CIF-tillägget och CIF Core Components kan användas på flera av 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å till Verktyg > Molntjänster > CIF-konfiguration i AEM.
-
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 i 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 Catalog UID Support - aktivera stöd för UID i stället för ID i e-handelssamtal med GraphQL.
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 arkivkatalogens rot
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 Catalog UID Support och använda en giltig UID-kategori 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 vill använda flera olika webbplatsstrukturer för AEM tillsammans med olika e-handelskataloger.