Introdução ao AEM Content and Commerce start
Para começar a usar o AEM Content and Commerce, é necessário instalar o AEM Content and Commerce Add-On for AEM 6.5.
Integração onboarding
A integração do AEM Content and Commerce é um processo de duas etapas:
-
Instale o AEM Content and Commerce Add-On for AEM 6.5 LTS
-
Conectar o AEM com sua solução comercial
Instale o AEM Content and Commerce Add-On for AEM 6.5 LTS install-add-on
Baixe e instale o Complemento AEM Commerce para AEM 6.5 LTS do portal Distribuição de Software.
Inicie e instale o AEM 6.5 LTS 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 de comércio que tenha um endpoint do GraphQL acessível para o 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 adicionais do CIF que exigem autenticação.
Os projetos gerados pelo Arquétipo de Projetos 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 Complemento de conteúdo e Commerce do AEM e os Componentes principais 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 do CIF se conectam por padrão ao /api/graphql. Isso pode ser ajustado por meio da configuração do CIF Cloud Service, se necessário (veja abaixo).
O Complemento do CIF fornece um servlet de 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 do AEM conectadas a diferentes lojas de comércio (ou exibiçõ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 do CIF Cloud Service, seguindo estas etapas:
-
No AEM, acesse Ferramentas > Serviços da nuvem > 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 da 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 ao UID do catálogo - habilite o suporte para o UID em vez da 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 usar os Componentes principais do CIF versão 2.0.0, você deverá ativar o Suporte ao UID do catálogo e usar uma categoria válida do UID 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 do AEM combinadas com diferentes catálogos de comércio, consulte o tutorial Configuração de várias lojas do Commerce.