DocumentaçãoAEM 6.5Guia do usuário

COMMERCE CLOUD SAP sap-commerce-cloud

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

Após a instalação, é possível configurar sua instância:

  1. Configurar a Pesquisa Facetada para Geometrixx Outdoors.
  2. Configurar a Versão de Catálogo.
  3. Configurar a estrutura de importação.
  4. Configurar os Atributos do Produto a serem Carregados.
  5. Importando os dados do produto.
  6. Configurar o Importador de Catálogo.
  7. Use o importador para importar o catálogo para um local específico no AEM.

Configurar a pesquisa facetada para Geometrixx Outdoors configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Isso não é necessário para o hybris 5.3.0.1 e posteriores.

  1. Em seu navegador, navegue até o console de gerenciamento de hibris em:

    http://localhost:9001/hmc/hybris

  2. Na barra lateral, selecione Sistema, depois Pesquisa de facetas e depois Configuração de pesquisa de facetas.

  3. Abrir Editor para a Configuração Solr de Exemplo para clothescatalog.

  4. Em Versões de catálogo, use Adicionar versão de catálogo para adicionar outdoors-Staged e outdoors-Online à lista.

  5. Salve a configuração.

  6. Abra Tipos de item da SOLR para adicionar Classificações da SOLR a ClothesVariantProduct:

    • relevância ("Relevância", pontuação)
    • name-asc ("Name (ascending)", name)
    • name-desc ("Name (descending)", name)
    • price-asc ("Preço (crescente)", priceValue)
    • price-desc ("Preço (decrescente)", priceValue)
    note note
    NOTE
    Use o menu de contexto (normalmente, clique com o botão direito do mouse) para selecionar Create Solr sort.
    Para o Hybris 5.0.0, abra a guia Indexed Types, clique duas vezes em ClothesVariantProduct e, em seguida, na guia SOLR Sort.

    chlimage_1-36

  7. Na guia Tipos Indexados, defina o Tipo Composto como:

    Product - Product

  8. Na guia Tipos Indexados, ajuste as consultas do Indexador para full:

    code language-shell 
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})

  9. Na guia Tipos Indexados, ajuste as consultas do Indexador para incremental:

    code language-shell 
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}}) AND {modifiedtime} <= ?lastIndexTime

  10. Na guia Tipos Indexados, ajuste a faceta category. Clique duas vezes na última entrada da lista de categorias para abrir a guia Propriedade indexada:

    note note
    NOTE
    Para o hybris 5.2, verifique se o atributo Facet na tabela Propriedades está selecionado de acordo com a captura de tela abaixo:

    chlimage_1-37 chlimage_1-38

  11. Abra a guia Configurações da faceta e ajuste os valores do campo:

    chlimage_1-39

  12. Salve as alterações.

  13. Novamente de tipos de Item SOLR, ajuste a faceta price de acordo com as seguintes capturas de tela. Assim como em category, clique duas vezes em price para abrir a guia Propriedade indexada:

    chlimage_1-40

  14. Abra a guia Configurações da faceta e ajuste os valores do campo:

    chlimage_1-41

  15. Salve as alterações.

  16. Abrir Sistema, Pesquisa de facetas e Assistente de operação do indexador. Inicie um cronjob:

    • Operação do indexador: full
    • Configuração Solr: Sample Solr Config for Clothes

Configurar a versão do catálogo configure-the-catalog-version

A versão de catálogo ( hybris.catalog.version) importada pode ser configurada para o serviço OSGi:

Configuração CQ Commerce Hybris de
( com.adobe.cq.commerce.hybris.common.DefaultHybrisConfigurationService)

Versão de catálogo definida como Online ou Staged (o padrão).

NOTE
Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter detalhes completos. Consulte também o console para obter uma lista completa de parâmetros configuráveis e seus padrões.

A saída do log fornece feedback sobre as páginas e os componentes criados e relata possíveis erros.

Configurar a estrutura de importação configure-the-import-structure

A lista a seguir mostra uma estrutura de exemplo (de ativos, páginas e componentes) que é criada por padrão:

+ /content/dam/path/to/images
  + 12345.jpg (dam:Asset)
    + ...
  + ...
+ /content/site/en
  - cq:commerceProvider = "hybris"
  - cq:hybrisBaseStore = "basestore"
  - cq:hybrisCatalogId = "catalog"
  + category1 (cq:Page)
    + jcr:content (cq:PageContent)
      - jcr:title = "Category 1"
    + category11 (cq:Page)
      + jcr:content (cq:PageContent)
        - jcr:title = "Category 1.1"
      + 12345 (cq:Page)
        + jcr:content (cq:PageContent)
          + par
            + product (nt:unstructured)
              - cq:hybrisProductId = "12345"
              - sling:resourceType = "commerce/components/product"
              + image (nt:unstructured)
                - sling:resourceType = "commerce/components/product/image"
                - fileReference = "/content/dam/path/to/images/12345.jpg"
              + 12345.1-S (nt:unstructured)
                - cq:hybrisProductId = "12345.1-S"
                - sling:resourceType = "commerce/components/product"
                + image (nt:unstructured)
                  - sling:resourceType = "commerce/components/product/image"
                  - fileReference = "/content/dam/path/to/images/12345.1-S.jpg"
              + ...

Essa estrutura foi criada pelo serviço OSGi DefaultImportHandler que implementa a interface ImportHandler. Um manipulador de importação é chamado pelo importador real para criar produtos, variações de produtos, categorias, ativos e assim por diante.

NOTE
Você pode personalizar este processo implementando seu próprio manipulador de importação.

A estrutura a ser gerada ao importar pode ser configurada para:

"Manipulador de Importação Padrão do Commerce Hybris do Day CQ
(com.adobe.cq.commerce.hybris.importer.DefaultImportHandler)

Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter detalhes completos. Consulte também o console para obter uma lista completa de parâmetros configuráveis e seus padrões.

Configurar os atributos do produto para carregar configure-the-product-attributes-to-load

O analisador de resposta pode ser configurado para definir as propriedades e os atributos a serem carregados para produtos (variantes):

  1. Configure o pacote OSGi:

    Analisador de Resposta Padrão do Commerce Hybris do CQ
    (com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser)

    Aqui é possível definir várias opções e atributos necessários para carregar e mapear.

    note note
    NOTE
    Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter detalhes completos. Consulte também o console para obter uma lista completa de parâmetros configuráveis e seus padrões.

Importação dos dados do produto importing-the-product-data

Há várias maneiras de importar os dados do produto. Os dados do produto podem ser importados ao configurar inicialmente o ambiente ou após alterações serem feitas nos dados híbridos:

As informações reais do produto importadas do hybris são mantidas no repositório em:

/etc/commerce/products

As seguintes propriedades indicam o link com hybris:

  • commerceProvider
  • cq:hybrisCatalogId
  • cq:hybrisProductID
NOTE
A implementação hybris (ou seja, geometrixx-outdoors/en_US) armazena apenas IDs de produto e outras informações básicas em /etc/commerce.
O servidor hybris é referenciado sempre que as informações sobre um produto são solicitadas.

Importação completa full-import

  1. Se necessário, exclua todos os dados existentes do produto usando o CRXDE Lite.

    1. Navegue até a subárvore que contém os dados do produto:

      /etc/commerce/products

      Por exemplo:

      http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

    2. Exclua o nó que contém os dados do seu produto; por exemplo, outdoors.

    3. Salvar tudo para confirmar a alteração.

  2. Abra o importador hybris no AEM:

    /etc/importers/hybris.html

    Por exemplo:

    http://localhost:4502/etc/importers/hybris.html

  3. Configure os parâmetros necessários; por exemplo:

    chlimage_1-42

  4. Clique em Importar catálogo para iniciar a importação.

    Quando terminar, você poderá verificar os dados importados em:

    code language-none 
        /etc/commerce/products/outdoors

    Você pode abrir isso em CRXDE Lite; por exemplo:

    [http://localhost:4502/crx/de/index.jsp#/etc/commerce/products](http://localhost:4502/crx/de/index.jsp#/etc/commerce/products)

Importação incremental incremental-import

  1. Verifique as informações contidas no AEM para os produtos relevantes, na subárvore apropriada em:

    /etc/commerce/products

    Você pode abrir isso em CRXDE Lite; por exemplo:

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. No hybris, atualize as informações mantidas sobre os produtos relevantes.

  3. Abra o importador hybris no AEM:

    /etc/importers/hybris.html

    Por exemplo:

    http://localhost:4502/etc/importers/hybris.html

  4. Marque a caixa de seleção Importação incremental.

  5. Clique em Importar catálogo para iniciar a importação.

    Quando terminar, você pode verificar os dados atualizados no AEM em:

    code language-none 
        /etc/commerce/products

Atualização expressa express-update

O processo de importação pode levar muito tempo. Assim, como uma extensão da Sincronização de produto, você pode selecionar áreas específicas do catálogo para uma atualização expressa que é acionada manualmente. Isso usa o feed de exportação junto com a configuração de atributos padrão.

  1. Verifique as informações contidas no AEM para os produtos relevantes, na subárvore apropriada em:

    /etc/commerce/products

    Você pode abrir isso em CRXDE Lite; por exemplo:

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. No hybris, atualize as informações mantidas sobre os produtos relevantes.

  3. Em hybris, adicione um ou mais produtos à Express Queue; por exemplo:

    chlimage_1-43

  4. Abra o importador hybris no AEM:

    /etc/importers/hybris.html

    Por exemplo:

    http://localhost:4502/etc/importers/hybris.html

  5. Marque a caixa de seleção Atualização Expressa.

  6. Clique em Importar catálogo para iniciar a importação.

    Quando terminar, você pode verificar os dados atualizados no AEM em:

    code language-none 
        /etc/commerce/products

Configurar o importador de catálogo configure-the-catalog-importer

O catálogo hybris pode ser importado para AEM, usando o importador em lote para catálogos hybris, categorias e produtos.

Os parâmetros usados pelo importador podem ser configurados para:

Importador de Catálogo Commerce Hybris CQ do Dia
( com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter)

Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter detalhes completos. Consulte também o console para obter uma lista completa de parâmetros configuráveis e seus padrões.

Importação do catálogo catalog-import

O pacote hybris vem com um importador de catálogo para configurar a estrutura da página inicial.

Isso está disponível em:

http://localhost:4502/etc/importers/hybris.html

ecommerceimportconsole

Devem ser fornecidas as seguintes informações:

  • Repositório base
    O identificador do armazenamento base configurado no hybris.

  • Catálogo
    O identificador do catálogo a ser importado.

  • Caminho raiz
    O caminho onde o catálogo deve ser importado.

Remoção de um produto do catálogo removing-a-product-from-the-catalog

Para remover um ou mais produtos do catálogo:

  1. Configurar o para o serviço OSGi Importador do Catálogo Commerce Hybris do Day CQ; consulte também Configurar o Importador do Catálogo.

    Ative as seguintes propriedades:

    • Habilitar remoção de produto
    • Habilitar remoção de ativos de produtos
    note note
    NOTE
    Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter detalhes completos. Consulte também o console para obter uma lista completa de parâmetros configuráveis e seus padrões.

  2. Inicialize o importador executando duas atualizações incrementais (consulte Importação de Catálogo):

    • A primeira execução resulta em um conjunto de produtos alterados - indicado na lista de log.
    • Nenhum produto deve ser atualizado pela segunda vez.
    note note
    NOTE
    A primeira importação é inicializar as informações do produto. A segunda importação verifica se tudo funcionou e se o conjunto de produtos está pronto.

  3. Verifique a página de categoria que contém o produto que você deseja remover. Os detalhes do produto devem estar visíveis.

    Por exemplo, a categoria a seguir mostra detalhes do produto Cajamara:

    http://localhost:4502/editor.html/content/geometrixx-outdoors/en_US/equipment/biking.html

  4. Remova o produto no console hybris. Use a opção Alterar status de aprovação para definir o status como unapproved. O produto é removido do feed ao vivo.

    Por exemplo:

    • Abra a página http://localhost:9001/productcockpit
    • Selecionar o catálogo Outdoors Staged
    • Pesquisar por Cajamara
    • Selecione este produto e altere o status de aprovação para unapproved

  5. Execute outra atualização incremental (consulte Importação de catálogo). O log lista o produto excluído.

  6. Implante o catálogo apropriado. A página do produto e do produto foi removida do AEM.

    Por exemplo:

  7. Para restaurar o produto:

    1. No hybris, defina o status de aprovação novamente como aprovado

    2. No AEM:

      1. executar uma atualização incremental
      2. implante o catálogo apropriado novamente
      3. atualizar a página de categoria apropriada

Adicionar a característica do histórico do pedido ao contexto do cliente add-order-history-trait-to-the-client-context

Para adicionar o histórico de pedidos ao contexto do cliente:

  1. Abra a página de design de contexto do cliente, através:

    • Abra uma página para edição e, em seguida, abra o contexto do cliente usando Ctrl-Alt-c (windows) ou control-option-c (Mac). Use o ícone de lápis no canto superior esquerdo do contexto do cliente para Abrir a página de design do ClientContext.
    • Navegue diretamente para http://localhost:4502/etc/clientcontext/default/content.html

  2. Adicione o Componente de Histórico de Pedidos ao Carro de Compras t componente do contexto do cliente.

  3. Você pode confirmar que o contexto do cliente está mostrando detalhes do seu histórico de pedidos. Por exemplo:

    1. Abra o contexto do cliente.

    2. Adicione um item ao carrinho.

    3. Conclua o check-out.

    4. Verifique o contexto do cliente.

    5. Adicione outro item ao carrinho.

    6. Navegue até a página de check-out:

      • O contexto do cliente mostra um resumo do histórico do pedido.
      • A mensagem "Você é um cliente recorrente" é exibida.
    note note
    NOTE
    A mensagem é percebida por:
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2