Para começar a usar o as a Cloud Service do Adobe Experience Manager (AEM) Commerce, seu Experience Manager Cloud Service deve ser provisionado com o complemento Commerce integration framework CIF (). O complemento CIF é um módulo extra sobre o 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.
Depois de provisionado com o complemento CIF, ele é aplicado a todos os programas existentes do Cloud Manager. Caso não tenha um programa do Cloud Manager, é necessário criar um. Para obter mais detalhes, consulte Configurar seu programa.
A segunda etapa é o autoatendimento para cada ambiente do AEM as a Cloud Service. Há algumas configurações adicionais que você deve fazer 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, você deve fornecer a 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 por meio de HTTPS.
Essa variável de ambiente é usada em dois lugares:
/api/graphql
. Esse URL é usado pelas ferramentas de criação para comércio do AEM (complemento CIF) e componentes do lado do cliente do CIF.Um URL de endpoint do GraphQL diferente pode ser usado para cada ambiente as a Cloud Service do AEM. 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 endpoint do GraphQL deve estar disponível publicamente. Não há suporte para VPN privada ou conexões locais. Opcionalmente, um cabeçalho de autenticação pode ser fornecido para usar recursos de CIF adicionais que exigem autenticação.
Opcionalmente e somente para Adobe Commerce Enterprise/Cloud, o complemento CIF é compatível com o uso de dados de catálogo preparados para autores do AEM. Esses dados exigem a configuração de um cabeçalho de autorização. Esse cabeçalho só está disponível e é usado em instâncias de Autores do 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:
Essa configuração pode ser feita 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 ponto de extremidade e, opcionalmente, um cabeçalho de autorização para suporte ao catálogo em etapas forem definidos, o ponto de extremidade será exibido na página de detalhes. Clicar no ícone Editar para abrir a mesma caixa de diálogo, na qual você pode editar o endpoint, se necessário.
Para conectar o AEM a uma solução comercial por meio da CLI do Adobe I/O, 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
Você está pronto para usar o AEM Commerce as a Cloud Service e pode implantar seu projeto por meio do Cloud Manager.
O complemento CIF e o 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 e assim por diante). Por padrão, o complemento CIF é implantado com uma configuração padrão conectada ao armazenamento e catálogo padrão da Adobe Commerce.
Essa configuração pode ser ajustada para o projeto por meio da configuração de Cloud Service CIF seguindo estas etapas:
No AEM, acesse Ferramentas > Cloud Service > Configuração do CIF.
Selecione a configuração de comércio que deseja alterar.
Abra 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 os UIDs 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 do CIF, o suporte para id
foi removido e substituído por uid
. Se o seu projeto usa os Componentes principais do CIF versão 2.0.0, você deve habilitar 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.