Desenvolvimento do comércio de AEM

O desenvolvimento de projetos de comércio de AEM com base na Commerce Integration Framework (CIF) para AEM segue as mesmas regras e práticas recomendadas de outros projetos de AEM. Leia primeiro estes itens:

Desenvolvimento local para o comércio AEM

Um ambiente de desenvolvimento local é recomendado para trabalhar com projetos da CIF.

OBSERVAÇÃO

As instruções a seguir ajudam a configurar um ambiente de desenvolvimento de AEM local para o AEM Commerce usando a CIF com foco no AEM 6.5). Se você estiver usando o AEM as a Cloud Service, consulte a AEM Commerce as a Cloud Service documentação.

O complemento de comércio AEM para AEM 6.5 também conhecido como. O complemento CIF também está disponível para desenvolvimento local e é fornecido como um pacote AEM. Ele pode ser baixado do Portal de distribuição de software como um pacote de recursos.

Software necessário

Devem ser instalados:

Acesso ao complemento CIF

O complemento CIF pode ser baixado em Portal de distribuição de software, pesquise por "complemento de comércio do AEM".

DICA

Use sempre a versão mais recente do complemento CIF.

Configuração local

Para o desenvolvimento de projetos da CIF local usando o AEM e o complemento CIF, siga estas etapas:

  1. Obtenha a versão AEM 6.5 e instale o AEM 6.5 Service Pack. O AEM 6.5 Service Pack 7 é necessário, no entanto, a Adobe recomenda instalar o último service pack disponível.

  2. Descompacte o AEM .jar para criar a pasta crx-quickstart e execute:

    java -jar <jar name> -unpack
    
  3. Crie uma pasta crx-quickstart/install

  4. Copie todos os pacotes do complemento CIF, baixados do Portal de distribuição de software, para o crx-quickstart/install pasta.

DICA

Como alternativa, o pacote complementar da CIF também pode ser instalado por meio do Gerenciador de pacotes.

  1. Iniciar o início rápido do AEM

Verifique a configuração por meio do console OSGI: http://localhost:4502/system/console/osgi-installer. A lista deve incluir os pacotes relacionados ao complemento CIF, o pacote de conteúdo e as configurações OSGI. Verifique se todos os pacotes foram iniciados.

Configuração do projeto

Há duas maneiras de iniciar seu projeto de comércio de AEM usando a CIF.

Usar o Arquétipo de projeto do AEM

O Arquétipo de projeto do AEM é a principal ferramenta para inicializar um projeto pré-configurado e começar a usar a CIF. Os Componentes principais da CIF e todas as configurações necessárias podem ser incluídos em um projeto gerado com uma opção extra.

DICA

Use o Arquétipo de projeto do AEM 25 ou posterior para gerar o projeto.

Consulte as instruções de uso do Arquétipo de projeto do AEM sobre como gerar um projeto do AEM. Para incluir a CIF no projeto, use a opção includeCommerce.

Por exemplo:

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.granite.archetypes \
 -D archetypeArtifactId=aem-project-archetype \
 -D aemVersion=6.5.5 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n \
 -D includeCommerce=y

Os Componentes principais da CIF podem ser utilizados em qualquer projeto incluindo os all pacote ou individual usando o pacote de conteúdo CIF e os pacotes OSGI relacionados. Para adicionar os Componentes principais da CIF manualmente a um projeto, use as seguintes dependências:

<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-apps</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-config</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-core</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>graphql-client</artifactId>
    <version>x.y.z</version>
</dependency>
<dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>magento-graphql</artifactId>
    <version>x.y.z</version>
</dependency>

Usar a loja de referência AEM Venia

Uma segunda opção para iniciar um projeto da CIF é clonar e usar a loja de referência AEM Venia. A loja de referência AEM Venia é um exemplo de aplicativo de vitrine de referência que demonstra o uso dos Componentes principais da CIF para o AEM. Ela serve como um conjunto de exemplos de práticas recomendadas e um possível ponto de partida para desenvolver sua própria funcionalidade.

Para começar a usar a loja de referência Venia, basta clonar o Repositório Git e comece a personalizar o projeto de acordo com suas necessidades.

OBSERVAÇÃO

O projeto da loja de referência Venia contém dois perfis de construção para o AEM as a Cloud Service e o AEM 6.5. Verifique o arquivo readme.md do projeto para ver como eles são usados. Para o AEM 6.5, use o classic perfil.

Conectar o AEM ao sistema de comércio

Para conectar seu projeto ao sistema de comércio, o AEM deve ser configurado com o terminal GraphQL do sistema de comércio.

Ambos, um projeto gerado pelo Arquétipo de projeto AEM ou o Loja de referência AEM Venia, já inclui um configuração padrão que 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 sistema de comércio usado pelo projeto.

O complemento de comércio do AEM e os componentes principais da CIF se conectam ao terminal de comércio do GraphQL por meio do servidor do AEM e diretamente pelo navegador. Os Componentes principais da CIF do lado do cliente e as ferramentas de criação do complemento CIF por padrão se conectam a /api/graphql. Se necessário, isso poderá ser ajustado por meio da configuração de Cloud Service da CIF (veja abaixo).

O complemento CIF fornece um servlet proxy do GraphQL em /api/graphql. Se você não planeja usar um AEM Dispatcher local, é recomendável configurar também o servlet proxy do GraphQL.

Navegue até http://localhost:4502/system/console/configMgr e crie uma configuração OSGI para o Adobe CIF GraphQL Proxy Configuration serviço. Use o mesmo endpoint do GraphQL do sistema de comércio usado para o cliente GraphQL acima.

Recursos adicionais

Nesta página