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

Conexão de AEM com 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 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:

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

Por meio da 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 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.

Via Adobe I/O CLI

Para conectar AEM com 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 Adobe I/O CLI com o Plug-in da CLI do Cloud Manager.

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

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

4. Habilitar recursos do catálogo de preparo que exigem autenticação (opcional)

   OBSERVAÇÃO

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

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 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:

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

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

3. Abra as propriedades de configuração na barra de ações

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 da loja - o identificador de exibição da loja. Se estiver vazia, a exibição de loja padrão será usada.
• Caminho do proxy GraphQL - o caminho do URL Proxy GraphQL no AEM usado para solicitações de proxy no ponto de extremidade GraphQL de back-end do 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 GraphQL fornecido deve alterar essa configuração.

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

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

  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.

Recursos adicionais

• Arquétipo de projeto do AEM
• Loja de referência Venia
• Configuração de várias lojas do Commerce