Documentação

Os links de entrada não mostram todos os links de páginas no Adobe Experience Manager

Last update: Thu Oct 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Se algumas páginas estiverem ausentes na exibição de links recebidos no Adobe Experience Manager, o problema pode ser devido aos nós de link profundamente aninhados ou às configurações de índice personalizadas. Este artigo explica como resolvê-lo ajustando a profundidade do índice Lucene, revertendo configurações personalizadas ou testando opções de configuração avançadas.

Descrição description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Experience Manager (AEM) 6.5

Problemas/Sintomas

  • Os links de entrada mostram contagens baixas ou inalteradas apesar de novas referências.
  • Consultas de texto completo retornam mais resultados do que o mostrado na guia Referências.
  • O problema pode ocorrer em ambientes compartilhados, mas não em novas configurações locais prontas para uso (OOTB).

Resolução resolution

Há três caminhos de solução de problemas: A, B, C.

Opção A - ajustar profundidade da agregação:

  1. Verifique a hierarquia dos nós que contêm o link usando o CRXDE Lite.

  2. Revise a estrutura da página e ajuste-a para que o nó do link esteja localizado em um nível mais raso.

  3. Se o nó de vinculação permanecer profundamente aninhado, atualize o índice Lucene para aumentar a profundidade que está sendo indexada para detecção de link de entrada (por exemplo, adicione definições de agregação como include4, include5 em /oak:index/cqPageLucene/aggregates/cq:PageContent).  Eles definem a profundidade que o índice deve percorrer em jcr:content para detectar links.

  4. Depois de fazer alterações, salve o nó do índice e acione a reindexação para aplicá-las.

Opção B - reverter configurações de índice personalizadas:

Observação: a reindexação pode afetar o desempenho.  Agendar esta tarefa durante períodos de tráfego baixo.

  1. Navegue até /oak:index/cqPageLucene no CRXDE Lite.
  2. Remova analisadores personalizados ou propriedades configuradas incorretamente.
  3. Redefinir sinalizadores fulltextEnabled para valores OOTB.
  4. Definir reindex = true e monitorar via console ou logs JMX.

Opção C - desabilitar configuração avançada (para teste):

  1. Vá para /system/console/configMgr e localize IncomingLinksReferenceProvider.
  2. Desative temporariamente essa configuração para verificar se mais links de entrada aparecem. Isso pode ajudar a determinar se a configuração está suprimindo os resultados.
  3. Reative a configuração após o teste para restaurar o comportamento normal.

Validação

  1. Use o SQL2 para verificar as contagens reais de links (o caminho /content/we-retail/us/en/about-us) é um exemplo de página de destino. Substitua-o pelo caminho real de seu destino de link.

    code language-none 
    SELECT [  jcr:path]
    FROM [  cq:Page]
    WHERE CONTAINS(*, '"/content/we-retail/us/en/about-us"')

  2. Compare os resultados da query com o que é mostrado na guia References para confirmar a discrepância.

Ferramentas úteis para validação de consulta:

Para auxiliar na solução de problemas e na validação de consultas de links recebidos, use as seguintes ferramentas disponíveis no AEM:

  1. Ferramenta de desempenho de consulta- http://localhost:4502/libs/granite/operations/content/diagnosistools/queryPerformance.html
    • Permite testar e analisar consultas SQL2 e QueryBuilder para obter insights de desempenho.
  2. Depurador do Construtor de consultas JCR- http://localhost:4502/libs/cq/search/content/querydebug.html
    • Permite a execução e a depuração de consultas do QueryBuilder com saída detalhada.

Causa

  • Nós profundamente aninhados em jcr:content podem não ser indexados por padrão, fazendo com que o AEM perca links em níveis mais profundos. Ajustar os agregados de Lucene ajuda a melhorar o reconhecimento de profundidade.
  • As configurações de índice Lucene personalizadas (por exemplo, analisadores ou propriedades mal configuradas) em /oak:index/cqPageLucene podem restringir a indexação de texto completo e afetar a detecção de links.
  • Configurações avançadas de detecção de links, como IncomingLinksReferenceProvider, podem suprimir a visibilidade do link de entrada. Desabilitar temporariamente esse provedor pode revelar resultados suprimidos e ajudar na depuração.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f