Introdução ao AEM Commerce as a Cloud Service

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.

Integração

A integração do AEM Commerce as a Cloud Service é um processo de duas etapas:

  1. Ativação do AEM Commerce as a Cloud Service e provisionamento do complemento CIF
  2. Conectar o AEM Commerce as a Cloud Service com sua solução comercial

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.

Conectar o AEM a uma solução comercial

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:

  • O GraphQL chama o AEM para o back-end comercial, por meio de algum cliente GraphQl compartilhável comum, usado pelos Componentes principais do AEM CIF e componentes do projeto do cliente.
  • Configurar um URL de proxy do GraphQL em cada ambiente AEM em que a variável está definida e disponível em /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:

Pela interface do usuário do Cloud Manager (padrão)

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:

Informações de ambiente do CM

Clicar nesse botão abre uma caixa de diálogo:

Ponto de Extremidade de Comércio CM

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.

Informações de ambiente do CM

Pela CLI do Adobe I/O

Para conectar o AEM a uma solução comercial via Adobe I/O CLI, siga estas etapas:

  1. 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.

  2. Autentique a CLI do Adobe I/O com o programa AEM as a Cloud Service

  3. 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.

  4. Habilitar recursos de catálogo em etapas que exigem autenticação (Opcional)

    OBSERVAÇÃO

    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>"
    
DICA

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.

Configuração de lojas e catálogos

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:

  1. No AEM, acesse Ferramentas -> Cloud Services -> Configuração da CIF

  2. Selecione a configuração de comércio que deseja alterar

  3. Abrir as propriedades de configuração por meio da barra de ações

Configuração de Cloud Services da CIF

As seguintes propriedades podem ser configuradas:

  • Cliente GraphQL - selecione o cliente GraphQL configurado para comunicação de back-end de comércio. Normalmente, isso deve permanecer no padrão.
  • Exibição de loja - o identificador de exibição de loja. Se estiver vazia, a visualização de loja padrão será usada.
  • Caminho de proxy do GraphQL - o caminho de URL que o proxy do GraphQL no AEM usa para solicitações de proxy para o endpoint do GraphQL de back-end de comércio.
    OBSERVAÇÃO

    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.

    - Habilitar suporte a UID do catálogo - habilite o suporte para UID em vez de ID nas chamadas de GraphQL de back-end de comércio.
    OBSERVAÇÃ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.

    - Identificador de categoria raiz do catálogo - o identificador (UID ou ID) da raiz do catálogo de armazenamento
    ATENÇÃO

    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.

Recursos adicionais

Nesta página