Introdução ao conteúdo e comércio de AEM

Última atualização em 2023-11-08
  • Criado para:
  • User

Para começar a usar o AEM Content and Commerce, é necessário instalar o AEM Content and Commerce Add-On para AEM 6.5.

Requisito mínimo de software

Pacote de serviços do AEM 6.5 7 ou posterior é obrigatório.

Integração

A integração de conteúdo e comércio do AEM é um processo de duas etapas:

  1. Instalar o complemento de conteúdo e comércio do AEM para AEM 6.5

  2. Conectar o AEM à sua solução comercial

Instalar o complemento de conteúdo e comércio do AEM para AEM 6.5

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.

OBSERVAÇÃO

Isso será feito pelo CSE para clientes do AEM Managed Service.

Conectar o AEM ao seu sistema do Commerce

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.

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

Configurando lojas e catálogos

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 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. Abrir as propriedades de configuração por meio da barra de ações

Configuração do CIF Cloud Service

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.

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

    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

Nesta página