Documentação

Resultados de consulta inconsistentes na API do Construtor de consultas do AEM

Last update: Mon Nov 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

No Adobe Experience Manager (AEM), a execução de uma consulta com a API do Construtor de consultas retorna resultados inconsistentes se um índice não intencional for usado. Para corrigir, especifique o índice desejado usando um index tag na API do Construtor de Consultas.

Descrição description

Ambiente

  • Produto: AEM Managed Services, Sites, v6.5
  • Instância: Produção

Problema/Sintomas

Os resultados da consulta são inconsistentes quando um índice não intencional é usado durante a execução da consulta.

Resolução resolution

Para corrigir esse problema, siga estas etapas

  1. Atribua uma marca à definição de índice personalizado em /oak:index/<index> especificando a propriedade tags com um valor personalizado.

  2. Use o parâmetro p.indexTag na consulta da API do Construtor de Consultas.

  3. Adicionar p.indexTag=<tagname> à consulta, onde <tagname> corresponde à marca de índice personalizada.

  4. Verifique se a consulta usa o índice personalizado desejado. Por exemplo:

    • Definição de Índice Personalizado de Exemplo (em /oak:index/fullTextSearch): jcr:mixinTypes="[ rep:AccessControllable] "
      async="[ async,nrt] "
      compatVersion="{Long}2"
      evaluatePathRestrictions="{Boolean}true"
      excludedPaths="[ /var,/etc/replication,/etc/workflow/instances,/jcr:system] "
      includedPaths="[ /content/mysite] "
      queryPaths="[ /content/mysite] "
      reindex="{Boolean}false"
      reindexCount="{Long}1"
      seed="{Long}-4788584413483415353"
      type="lucene"
      tags="[ customSearch] "
    • Consulta XPath usando um índice específico: /jcr:root/content/data/element(*, cq:Page)[ (jcr:contains(., 'courses'))] option (index tag customSearch)
    • Consulta de API equivalente do construtor de consulta: fulltext=courses
      type=cq:Page
      path=/content/mysite
      p.limit=10
      p.indexTag=customSearch

  5. Execute a consulta atualizada para verificar resultados consistentes e precisos com o índice personalizado especificado (customSearch).

Leituras relacionadas

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f