Aan de slag met AEM Commerce as a Cloud Service start
Als u aan de slag wilt met Adobe Experience Manager (AEM) Commerce as a Cloud Service, moet uw Experience Manager Cloud Service zijn ingericht met de invoegtoepassing Commerce integration framework (CIF). CIF toe:voegen-op is een extra module bovenop AEM Sites as a Cloud Service.
Onboarding onboarding
De instapprocedure voor AEM Commerce as a Cloud Service bestaat uit twee stappen:
- AEM Commerce as a Cloud Service ingeschakeld en de CIF add-on ingericht
- Connect AEM Commerce as a Cloud Service met uw handelsoplossing
De eerste instapstap wordt uitgevoerd door Adobe. Voor meer informatie over prijzen en provisioning moet u contact opnemen met uw verkoper.
Nadat u de invoegtoepassing CIF hebt ingericht, wordt deze toegepast op alle bestaande Cloud Manager-programma's. Als u geen Cloud Manager-programma hebt, moet u er een maken. Voor meer details, zie Opstelling uw Programma.
De tweede stap is zelfbediening voor elke AEM as a Cloud Service-omgeving. Er zijn enkele aanvullende configuraties die u moet uitvoeren na de eerste provisioning van de CIF-invoegtoepassing.
AEM verbinden met een Commerce-oplossing solution
Om CIF toe:voegen-op & de componenten van de Kern van AEM CIFmet een handelsoplossing te verbinden, moet u het eindpunt URL van GraphQL als milieuvariabele van Cloud Manager verstrekken. De variabelenaam is COMMERCE_ENDPOINT . Er moet een beveiligde verbinding via HTTPS worden geconfigureerd.
Deze omgevingsvariabele wordt op twee plaatsen gebruikt:
- GraphQL roept van AEM aan handel achterkant, als één of andere gemeenschappelijke cliënt GraphQl, die door de Componenten van de Kern van AEM CIF en de componenten van het klantenproject wordt gebruikt.
- Stel een GraphQL-proxy-URL in voor elke AEM-omgeving waarin de variabele beschikbaar is op
/api/graphql. Deze URL wordt gebruikt door de AEM-gereedschappen voor het maken van handelsontwerpen (CIF add-on) en CIF-clientcomponenten.
Voor elke AEM as a Cloud Service-omgeving kan een andere URL voor het eindpunt van GraphQL worden gebruikt. Op die manier kunnen projecten AEM-testomgevingen verbinden met staging-systemen voor handel en AEM-productieomgeving met een handelsproductiesysteem. Dat het eindpunt van GraphQL openbaar moet zijn, privé VPN of lokale verbindingen worden niet gesteund. Naar keuze, kan een authentificatiekopbal worden verstrekt om extra eigenschappen van CIF te gebruiken die authentificatie vereisen.
De invoegtoepassing CIF ondersteunt optioneel en alleen voor Adobe Commerce Enterprise / Cloud het gebruik van gefaseerde catalogusgegevens voor AEM-auteurs. Deze gegevens vereisen dat u een vergunningskopbal vormt. Deze header is alleen beschikbaar en wordt uit veiligheidsoverwegingen gebruikt op AEM Author-instanties. In AEM-publicatie-instanties kunnen geen gefaseerde gegevens worden weergegeven.
Er zijn twee opties om het eindpunt te vormen:
Als gebruikersinterface van Cloud Manager (standaard) cm-ui
Deze configuratie kan worden gedaan gebruikend een dialoogdoos op de pagina van de Details van het Milieu. Wanneer het bekijken van deze pagina voor een Commerce-Toegelaten programma, wordt een knoop getoond als het eindpunt momenteel niet wordt gevormd:
Als u op deze knop klikt, wordt een dialoogvenster geopend:
Nadat het eindpunt en naar keuze een vergunningskopbal voor gefaseerde catalogussteun wordt geplaatst, wordt het eindpunt getoond op de detailpagina. Klik op het pictogram Bewerken om hetzelfde dialoogvenster te openen waarin u indien nodig het eindpunt kunt bewerken.
Als Adobe I/O CLI adobe-cli
Ga als volgt te werk als u AEM via Adobe I/O CLI wilt verbinden met een handelsoplossing:
-
Kies voor de Adobe I/O CLI met de Cloud Manager-insteekmodule.
- Controleer de documentatie van Adobe Cloud Managerop hoe te om, opstelling te downloaden, en Adobe I/O CLImet de stop van Cloud Manager CLI te gebruiken.
-
Verifieer Adobe I/O CLI met het programma van AEM as a Cloud Service.
-
Stel de variabele
COMMERCE_ENDPOINTin Cloud Manager in.code language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"-
Zie CLI documentenvoor details.
-
De handel GraphQL eindpunt URL moet aan de dienst van GraphQl van de handel richten en een veilige verbinding gebruiken HTTPS. Bijvoorbeeld:
https://<yourcommercesystem>/graphql.
-
-
Schakel nog niet actieve catalogusfuncties in waarvoor verificatie vereist is (optioneel).
note note NOTE Deze functie is alleen beschikbaar in Adobe Commerce Enterprise of Cloud Edition. Zie op token-gebaseerde authentificatievoor details. - Stel de geheim variabele
COMMERCE_AUTH_HEADERin Cloud Manager in:
code language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>" - Stel de geheim variabele
aio cloudmanager:list-environment-variables ENVIRONMENT_IDU kunt AEM Commerce as a Cloud Service gebruiken en uw project implementeren via Cloud Manager.
Opslaan en catalogi configureren catalog
CIF toe:voegen-op en de Componenten van de Kern van CIFkunnen op veelvoudige de plaatsstructuren worden gebruikt van AEM die met verschillende handelshoudingen (of opslagmeningen, etc. worden verbonden). Standaard wordt de invoegtoepassing CIF geïmplementeerd met een standaardconfiguratie die verbinding maakt met de standaardwinkel en catalogus van Adobe Commerce.
Deze configuratie kan voor het project door CIF Cloud Service worden aangepast config die deze stappen volgt:
-
Ga in AEM naar Extra > Cloud Services > CIF Configuration.
-
Selecteer de handelsconfiguratie die u wilt veranderen.
-
Open de configuratie-eigenschappen via de actiebalk.
De volgende eigenschappen kunnen worden geconfigureerd:
-
GraphQL Client - selecteer de geconfigureerde GraphQL-client voor commerciële back-endcommunicatie. Deze client moet standaard blijven.
-
Winkelweergave - de weergave-id van de winkel. Als dit leeg is, wordt de standaardwinkelweergave gebruikt.
-
GraphQL Proxy Path - de Volmacht van GraphQL van de weg URL in AEM gebruikt aan volmachtsverzoeken aan het commerciële achterste eindpunt van GraphQL.
note note NOTE In de meeste instellingen mag de standaardwaarde /api/graphqlniet worden gewijzigd. Alleen geavanceerde instellingen die de opgegeven GraphQL-proxy niet gebruiken, moeten deze instelling wijzigen.* Ondersteuning voor Catalog UID inschakelen - ondersteuning voor UID inschakelen in plaats van ID in de commerciële back-end GraphQL-aanroepen.
note note NOTE Ondersteuning voor UID's is geïntroduceerd in Adobe Commerce 2.4.2. Laat slechts UIDs toe als uw handels achterkant een schema van GraphQL van versie 2.4.2 of later steunt. * Hoofdcategorie-id van catalogus - de id (UID of ID) van de hoofdmap van de opslagcatalogus
note caution CAUTION Vanaf CIF Core Components versie 2.0.0 is de ondersteuning voor idverwijderd en vervangen dooruid. Als uw project CIF Core Components versie 2.0.0 gebruikt, moet u de Steun van UID van de Catalogus toelaten en een geldige categorie UID gebruiken als "Identifier van de Hoofdcategorie van de Catalogus".
De configuratie hierboven wordt getoond is voor verwijzing. De projecten zouden hun eigen configuraties moeten verstrekken.
Voor complexere montages, die veelvoudige de plaatsstructuren gebruiken van AEM die met verschillende handelscatalogi worden gecombineerd zien het leerprogramma van de Opstelling van de multi-Opslag van 0} Commerce {.