Introdução ao conteúdo AEM e ao Commerce start
Para começar a usar o AEM Content e o Commerce, é necessário instalar o AEM Content and Commerce AEM Add-On para o 6.5.
Requisito mínimo de software
É necessário o AEM 6.5 Service Pack 7 ou posterior.
Integração onboarding
A integração do Conteúdo AEM e do Commerce é um processo de duas etapas:
-
Instale o complemento Conteúdo do AEM e Commerce para AEM 6.5
-
Conectar o AEM à sua solução comercial
Instale o complemento Conteúdo do AEM e Commerce para AEM 6.5 install-add-on
Baixe e instale o Complemento AEM Commerce para AEM 6.5 no Portal de distribuição de software.
Inicie e instale o AEM 6.5 Service Pack necessário. Recomendamos instalar o último service pack disponível.
Conectar o AEM ao seu sistema Commerce connect
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.
Opcionalmente, o cabeçalho de autenticação pode ser fornecido para usar recursos de CIF adicionais que exigem autenticação.
Os projetos gerados pelo Arquétipo de projeto AEM e pela loja de referência AEM Venia, que já estão incluídos na configuração padrão, devem ser ajustados.
Substitua o valor de url em com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json pelo ponto de extremidade GraphQL do 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 Conteúdo AEM e os Componentes principais do Commerce e do CIF usam conexões do lado do servidor e do lado do cliente do AEM. Os Componentes principais do CIF do lado do cliente e as ferramentas de criação do complemento CIF se conectam por padrão ao /api/graphql. Isso pode ser ajustado por meio da configuração de Cloud Service CIF, se necessário (veja abaixo).
O Complemento CIF fornece um servlet proxy do GraphQL em /api/graphql que pode ser usado 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).
Configurando lojas e catálogos catalog
O Complemento e os Componentes Principais do CIF podem ser usados em várias estruturas de site 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
-
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 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.
note note NOTE Na maioria das configurações, o valor padrão /api/graphqlnã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.
note note NOTE 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
note caution CAUTION A partir da versão 2.0.0 dos Componentes Principais do CIF, o suporte para idfoi removido e substituído poruid. 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 o tutorial Configuração de várias lojas do Commerce.