Desenvolvimento do AEM Commerce develop

O desenvolvimento de projetos do AEM Commerce com base no Commerce integration framework (CIF) para AEM segue as mesmas regras e práticas recomendadas de outros projetos do AEM. Revise estes primeiro:

Desenvolvimento local para o AEM Commerce local

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

O complemento do AEM Commerce para AEM, conhecido como complemento do CIF, está disponível para desenvolvimento local e é fornecido como um pacote do 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 do CIF

O complemento CIF pode ser baixado no Portal de distribuição de software e procure por 'complemento AEM Commerce'.

Configuração local

Para o desenvolvimento de projetos locais do CIF usando o AEM e o complemento CIF, siga estas etapas:

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 do CIF, o pacote de conteúdo e as configurações de OSGI. Verifique se todos os pacotes foram iniciados.

Configuração do projeto project

Há duas maneiras de iniciar seu projeto do AEM Commerce usando o 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 do CIF e todas as configurações necessárias podem ser incluídos em um projeto gerado com uma opção extra.

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 do CIF podem ser usados em qualquer projeto incluindo o pacote all fornecido ou um indivíduo usando o pacote de conteúdo 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 personalizar o projeto de acordo com suas necessidades.

Conectar o AEM ao sistema Commerce

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

Um projeto gerado pelo Arquétipo de Projeto do AEM ou pela Loja de Referência AEM Venia já inclui uma configuração padrão que deve ser ajustada.

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 usado pelo projeto.

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

O complemento CIF fornece um servlet de 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 serviço Adobe CIF GraphQL Proxy Configuration. Use o mesmo endpoint do GraphQL do sistema de comércio usado para o cliente GraphQL acima.

Recursos adicionais