Para começar a usar o AEM Content and Commerce, é necessário instalar o AEM Content and Commerce Add-On para AEM 6.5.
Pacote de serviços do AEM 6.5 7 ou posterior é obrigatório.
A integração de conteúdo e comércio do AEM é um processo de duas etapas:
Instalar o complemento de conteúdo e comércio do AEM para AEM 6.5
Conectar o AEM à sua solução comercial
Baixe e instale o complemento AEM Commerce para AEM 6.5 da Distribuição de software portal.
Inicie e instale o AEM 6.5 Service Pack necessário. Recomendamos instalar o último service pack disponível.
Isso será feito pelo CSE para clientes do AEM Managed Service.
O AEM pode ser conectado a qualquer sistema comercial que tenha um terminal GraphQL acessível para AEM. Esses endpoints geralmente estão disponíveis publicamente ou podem ser conectados por VPN privada ou conexões locais, dependendo da configuração individual do projeto.
Como opção, o cabeçalho de autenticação pode ser fornecido para usar recursos CIF adicionais que exigem autenticação.
Projetos gerados pelo Arquétipo de projeto AEM, e o Loja de referência AEM Venia que já está incluído na lista configuração padrão deve ser ajustado.
Substitua o valor de url
in com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
com o terminal GraphQL do seu sistema de comércio. Essa configuração pode ser feita por meio do console OSGI ou implantando a configuração OSGI por meio do projeto. Diferentes configurações para sistemas de preparo e produção são compatíveis com o uso de diferentes modos de execução do AEM.
O complemento de conteúdo e comércio para AEM e os componentes principais da CIF usam conexões AEM do lado do servidor e do lado do cliente. Os Componentes principais da CIF do lado do cliente e as ferramentas de criação do complemento CIF se conectam por padrão a /api/graphql
. Isso pode ser ajustado por meio da configuração do Cloud Service da CIF, se necessário (veja abaixo).
O complemento CIF fornece um servlet proxy do GraphQL em /api/graphql
que podem ser usados opcionalmente para desenvolvimento local. Para implantações de produção, é altamente recomendável configurar um proxy reverso para o endpoint do GraphQL de comércio por meio do AEM Dispatcher ou em outras camadas de rede (como o CDN).
O Complemento 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 da CIF seguindo estas etapas:
No AEM, acesse Ferramentas -> Cloud Services -> Configuração da CIF
Selecione a configuração de comércio que deseja alterar
Abrir 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, 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.
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.
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
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.