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 ponto de extremidade 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
. Isso é usado pelas ferramentas de criação comercial 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 AEM ambientes de preparo com sistemas de preparo comercial e AEM ambiente de produção a um sistema de produção comercial. Esse ponto de extremidade GraphQL da deve estar disponível publicamente. Não há suporte para VPN privada ou conexões locais. Como opção, é possível fornecer um cabeçalho de autenticação para usar recursos adicionais da CIF que exigem autenticação.
Como opção e somente para Adobe Commerce Enterprise/Cloud, o complemento CIF é compatível com o uso de dados de catálogo preparados para AEM autores. Isso requer a configuração de um cabeçalho de autorização. Esse cabeçalho só está disponível e é usado em instâncias AEM autor por motivos de segurança. AEM instâncias de publicação não podem mostrar dados preparados.
Há duas opções para configurar o ponto de extremidade:
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 terminal 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 o suporte ao catálogo preparado 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 AEM com 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 Adobe I/O CLI com o Plug-in da CLI do Cloud Manager.
Autentique a CLI do Adobe I/O com o programa as a Cloud Service AEM
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 GraphQL de comércio deve apontar para o serviço GraphQl do Commerce e usar uma conexão HTTPS segura. Por exemplo: https://<yourcommercesystem>/graphql
.
Habilitar recursos do catálogo de preparo que exigem autenticação (opcional)
Esse recurso só está disponível com o Adobe Commerce Enterprise ou Cloud Edition. Consulte Autenticação por token para obter detalhes.
Defina as 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 Componentes principais da CIF pode ser usado em várias estruturas de site 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 conectando-se ao catálogo e loja padrão da Adobe Commerce.
Essa configuração pode ser ajustada para o projeto por meio da configuração do Cloud Service da CIF, seguindo estas etapas:
AEM acesse Ferramentas -> Cloud Services -> Configuração da CIF
Selecione a configuração de comércio que deseja alterar
Abra as propriedades de configuração na 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 GraphQL fornecido deve alterar essa configuração.
O suporte para UIDs foi introduzido no Adobe Commerce 2.4.2. Habilite-o somente se o back-end de comércio suportar um esquema GraphQL da versão 2.4.2 ou posterior.
A partir da versão 2.0.0 dos Componentes principais da CIF, o suporte para o id
foi removido e substituído por uid
. Se o seu projeto usa a versão 2.0.0 dos Componentes principais da CIF, você deve ativar o Suporte à UID de catálogo e usar uma UID de categoria válida como "Identificador de categoria raiz do catálogo".
A configuração mostrada acima é para referência. Os projetos devem fornecer suas próprias configurações.
Para configurações mais complexas usando várias estruturas de site de AEM combinadas com catálogos de comércio diferentes, consulte o Configuração de várias lojas do Commerce tutorial.