Guia de implementação de pesquisa simples

A Implementação de pesquisa Simples são os materiais do laboratório do Adobe Summit AEM Search Demystified. Esta página contém os materiais deste laboratório. Para obter um tour guiado do laboratório, visualize a pasta de trabalho do Lab na seção Apresentação desta página.

Materiais de apresentação

• Pasta de trabalho do laboratório
• Apresentação

Marcadores

Ferramentas

• Gerenciador de índice
• Explicar consulta
• CRXDE Lite > /oak:index/cqPageLucene
• Gerenciador de pacotes CRX
• QueryBuilder Debugger
• Gerador de definição de índice Oak

Capítulos

Os links do Capítulo abaixo pressupõem que os pacotes iniciais estejam instalados no AEM Author emhttp://localhost:4502

• Capítulo 1
• Capítulo 2
• Capítulo 3
• Capítulo 4
• Capítulo 5
• Capítulo 6
• Capítulo 7
• Capítulo 8
• Capítulo 9

Pacotes

Pacotes iniciais

• Tags
• Pacote do aplicativo de pesquisa simples

Pacotes de capítulo

• Solução do capítulo 1
• Solução do capítulo 2
• Solução do capítulo 3
• Solução do capítulo 4
• Configuração do capítulo 5
• Solução do capítulo 5
• Solução do capítulo 6
• Solução do capítulo 9

Materiais referenciados

• Repositório Github
• Modelos sling
• Exportador de Modelo Sling
• API do QueryBuilder
• Plug-in do AEM Chrome (página de documentação)

Correções e acompanhamento

Correções e esclarecimentos das discussões do laboratório e respostas para perguntas complementares dos participantes.

1. Como parar a reindexação?

   A reindexação pode ser interrompida por meio do MBean IndexStats disponível por meio de Console da Web AEM > JMX

   • http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats
     • Execute abortAndPause() para suspender a reindexação. Isso bloqueará o índice para reindexação adicional até que resume() seja chamado.
     • A execução de resume() reiniciará o processo de indexação.
   • Documentação: https://jackrabbit.apache.org/oak/docs/query/indexing.html#async-index-mbean

2. Como os índices do oak podem suportar vários locatários?

   O Oak suporta a inserção de índices através da árvore de conteúdo, e esses índices serão indexados somente nessa subárvore. Por exemplo, /content/site-a/oak:index/cqPageLucene pode ser criado para indexar conteúdo somente em /content/site-a.

   Uma abordagem equivalente é usar as propriedades includePaths e queryPaths em um índice em /oak:index. Por exemplo:

   • /oak:index/siteAcqPageLucene@includePaths=/content/site-a
   • /oak:index/siteAcqPageLucene@queryPaths=/content/site-a

   As considerações com essa abordagem são:

   • As consultas DEVEM especificar uma restrição de caminho que seja igual ao escopo do caminho de consulta do índice, ou ser um descendente lá de.
   • Índices de escopo mais amplos (por exemplo /oak:index/cqPageLucene) TAMBÉM indexarão os dados, resultando em assimilação duplicada e custo de uso do disco.
   • Pode exigir gerenciamento de configuração duplicada (por exemplo, adicionar o mesmo indexRules em vários índices de locatários, se eles tiverem que atender aos mesmos conjuntos de query)
   • Essa abordagem é mais bem servida no nível de Publicação do AEM para pesquisa de site personalizada, como no Autor do AEM, é comum que consultas sejam executadas no alto da árvore de conteúdo para diferentes locatários (por exemplo, via OmniSearch) - definições de índice diferentes podem resultar em comportamento diferente com base apenas na restrição de caminho.

3. Onde está uma lista de todos os Analisadores disponíveis?

   O Oak expõe um conjunto de elementos de configuração do lucene-fornece o analisador para uso no AEM.

   • Documentação dos Analisadores do Apache Oak
     • Tokenizers
     • Filtros
     • CharFilters

4. Como pesquisar por Páginas e ativos na mesma consulta?

   Uma novidade no AEM 6.3 é a capacidade de consultar vários tipos de nó na mesma consulta fornecida. A consulta do QueryBuilder a seguir. Observe que cada "subconsulta" pode resolver para seu próprio índice, portanto, neste exemplo, a subconsulta cq:Page resolve para /oak:index/cqPageLucene e a subconsulta dam:Asset resolve para /oak:index/damAssetLucene.

   group.p.or=true
   group.1_group.type=cq:Page
   # add all page restrictions to this group
   group.2_group.type=dam:Asset
   # add all asset restrictions to this group
   

   resulta no seguinte query e plano de query:

   QUERY:(//element(*,%20cq:Page?lang=pt-BR) | //element(*, dam:Asset))
   
   PLAN: [cq:Page] as [a] /* lucene:cqPageLucene(/oak:index/cqPageLucene?lang=pt-BR) *:* */ union [dam:Asset] as [a] /* lucene:damAssetLucene(/oak:index/damAssetLucene?lang=pt-BR) *:* */
   

   Explore a consulta e os resultados via QueryBuilder Debugger e AEM Chrome Plug-in.

5. Como pesquisar por vários caminhos na mesma query?

   Novo no AEM 6.3 é a capacidade de consultar vários caminhos na mesma consulta fornecida. A consulta do QueryBuilder a seguir. Observe que cada "subconsulta" pode resolver para seu próprio índice.

   group.p.or=true
   group.1_group.type=cq:Page
   group.1_group.path=/content/docs/en/6-2
   # add all page restrictions to this group
   group.2_group.type=cq:Page
   group.2_group.path=/content/docs/en/6-3
   # add all asset restrictions to this group
   

   resulta no seguinte query e plano de query

   QUERY: (/jcr:root/content/docs/en/_x0036_-2//element(*,%20cq:Page?lang=pt-BR) | /jcr:root/content/docs/en/_x0036_-3//element(*, cq:Page))
   
   PLAN: [cq:Page] as [a] /* traverse "/content/docs/en/6-2//*" where isdescendantnode([a], [/content/docs/en/6-2]) */ union [cq:Page] as [a] /* traverse "/content/docs/en/6-3//*" where isdescendantnode([a], [/content/docs/en/6-3]) */
   

   Explore a consulta e os resultados via QueryBuilder Debugger e AEM Chrome Plug-in.