Para começar a usar o AEM Commerce as a Cloud Service, o Experience Manager Cloud Service deve ser fornecido com o complemento Commerce Integration Framework (CIF). O complemento CIF é um módulo adicional do AEM Sites as a Cloud Service.
A integração do AEM Commerce as a Cloud Service é um processo de duas etapas:
A primeira etapa de integração é feita pelo Adobe. Para obter mais detalhes sobre preços e provisionamento, entre em contato com seu representante de vendas.
Com o provisionamento do complemento CIF, ele será aplicado a todos os programas existentes do Cloud Manager. Caso não tenha um programa do Cloud Manager, será necessário criar um novo. Para obter mais detalhes, consulte Configurar o programa.
A segunda etapa é o autoatendimento para cada ambiente do AEM as a Cloud Service. Há algumas configurações adicionais a serem feitas após o provisionamento inicial do complemento CIF.
Para conectar o complemento CIF e a Componentes principais da CIF do AEM com uma solução comercial, é necessário fornecer o URL do endpoint do GraphQL por meio de uma variável de ambiente do Cloud Manager. O nome da variável é COMMERCE_ENDPOINT
. Deve ser configurada uma conexão segura via HTTPS.
Essa variável de ambiente é usada em dois lugares:
/api/graphql
. É usado pelas ferramentas de criação para comércio do AEM (complemento CIF) e pelos componentes do lado do cliente da CIF.Pode ser usado um URL de ponto de extremidade GraphQL da diferente para cada ambiente do AEM as a Cloud Service. Dessa forma, os projetos podem conectar ambientes de preparo de AEM com sistemas de preparo de comércio e ambiente de produção de AEM a um sistema de produção de comércio. Esse ponto de extremidade GraphQL da deve estar disponível publicamente. Não há suporte para VPN privada ou conexões locais. Opcionalmente, é possível fornecer um cabeçalho de autenticação para usar os recursos adicionais da CIF que exigem autenticação.
Opcionalmente e somente para o Adobe Commerce Enterprise/Cloud, o complemento CIF é compatível com o uso de dados de catálogo preparados para autores de AEM. Isso é necessário para configurar um cabeçalho de autorização. Esse cabeçalho só está disponível e é usado em instâncias de autor AEM por motivos de segurança. Instâncias de publicação do AEM não podem mostrar dados preparados.
Há duas opções para configurar o endpoint:
Isso pode ser feito usando uma caixa de diálogo na página Detalhes do ambiente. Ao visualizar esta página para um programa habilitado para comércio, um botão será exibido se o endpoint não estiver configurado no momento:
Clicar nesse botão abre uma caixa de diálogo:
Depois que o endpoint e, opcionalmente, um cabeçalho de autorização para suporte a catálogo em etapas forem definidos, o endpoint será exibido na página de detalhes. Clicar no ícone Editar abrirá a mesma caixa de diálogo em que o endpoint pode ser modificado, se necessário.
Para conectar o AEM a uma solução comercial via Adobe I/O CLI, siga estas etapas:
Obtenha a CLI do Adobe I/O com o plug-in do Cloud Manager
Verifique a Documentação do Adobe Cloud Manager sobre como baixar, configurar e usar o CLI do Adobe I/O com o Plug-in da CLI do Cloud Manager.
Autentique a CLI do Adobe I/O com o programa AEM as a Cloud Service
Defina a variável COMMERCE_ENDPOINT
no Cloud Manager
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
Consulte documentos da CLI para saber mais.
O URL do ponto de extremidade de GraphQL de comércio deve apontar para o serviço GraphQl do comércio e usar uma conexão HTTPS segura. Por exemplo: https://<yourcommercesystem>/graphql
.
Habilitar recursos de catálogo em etapas que exigem autenticação (Opcional)
Esse recurso só está disponível com o Adobe Commerce Enterprise ou Cloud Edition. Consulte Autenticação baseada em token para obter detalhes.
Defina o COMMERCE_AUTH_HEADER
variável secreta no Cloud Manager:
aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
Você pode listar todas as variáveis do Cloud Manager usando o seguinte comando para verificar: aio cloudmanager:list-environment-variables ENVIRONMENT_ID
Agora você está pronto para usar o AEM Commerce as a Cloud Service e implantar seu projeto por meio do Cloud Manager.
O complemento CIF e a variável Componentes principais da CIF pode ser usado em várias estruturas de site de AEM conectadas a diferentes lojas de comércio (ou visualizações de loja etc.). Por padrão, o complemento CIF é implantado com uma configuração padrão conectada à loja e ao catálogo padrão da Adobe Commerce.
Essa configuração pode ser ajustada para o projeto por meio da configuração de Cloud Service da CIF seguindo estas etapas:
No AEM, acesse Ferramentas -> Cloud Services -> Configuração da CIF
Selecione a configuração de comércio que deseja alterar
Abrir as propriedades de configuração por meio da barra de ações
As seguintes propriedades podem ser configuradas:
Na maioria das configurações, o valor padrão é /api/graphql
não deve ser alterado. Somente a configuração avançada que não usa o proxy do GraphQL fornecido deve alterar essa configuração.
O suporte para UIDs foi introduzido no Adobe Commerce 2.4.2. Habilite isso somente se o back-end de comércio suportar um esquema do GraphQL versão 2.4.2 ou posterior.
A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para id
foi removido e substituído por uid
. Se o projeto usar os Componentes principais da CIF versão 2.0.0, você deverá ativar o Suporte à UID do catálogo e usar uma UID de categoria válida como "Identificador de categoria raiz do catálogo".
A configuração mostrada acima serve como referência. Os projetos devem fornecer suas próprias configurações.
Para configurações mais complexas usando várias estruturas de site AEM combinadas com diferentes catálogos de comércio, consulte a Configuração de várias lojas do Commerce tutorial.