Introdução ao AEM Commerce as a Cloud Service

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.

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.

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.

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

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

Por meio da interface do Cloud Manager (padrão)

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.

Por meio da CLI do Adobe I/O

Para conectar o AEM a uma solução comercial por meio da CLI do Adobe I/O, 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>"
   

Você está pronto para usar o AEM Commerce as a Cloud Service e pode implantar seu projeto por meio do Cloud Manager.

Configuração de lojas e catálogos

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:

1. No AEM, acesse Ferramentas > Cloud Service > Configuração do CIF.

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

3. Abra as propriedades de configuração por meio da 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, esse cliente deve permanecer no padrão.
• Exibição de loja - o identificador de exibição de loja. Se estiver vazia, a exibiçã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 os UIDs 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 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.

Recursos adicionais

• Arquétipo de projeto do AEM
• Loja de referência Venia
• Configuração de várias lojas do Commerce
• Configurações de sistemas de comércio múltiplos