Documentazione

I collegamenti in arrivo non mostrano tutte le pagine di collegamento in Adobe Experience Manager

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

Se alcune pagine non sono presenti nella visualizzazione dei collegamenti in entrata in Adobe Experience Manager, il problema potrebbe essere dovuto a nodi di collegamento annidati in profondità o configurazioni di indice personalizzate. Questo articolo spiega come risolverlo regolando la profondità dell’indice Lucene, ripristinando le impostazioni personalizzate o testando le opzioni di configurazione avanzate.

Descrizione description

Ambiente

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

Problemi/Sintomi

  • I collegamenti in ingresso mostrano conteggi bassi o invariati nonostante i nuovi riferimenti.
  • Le query full-text restituiscono più risultati di quelli visualizzati nella scheda Riferimenti.
  • Il problema potrebbe verificarsi in ambienti condivisi ma non in nuove impostazioni locali predefinite (OOTB).

Risoluzione resolution

Sono disponibili tre percorsi di risoluzione dei problemi: A, B, C.

Opzione A - Regola profondità aggregata:

  1. Controlla la gerarchia dei nodi che contengono il collegamento utilizzando CRXDE Lite.

  2. Rivedi la struttura della pagina e regolala in modo che il nodo del collegamento si trovi a un livello più basso.

  3. Se il nodo di collegamento rimane profondamente nidificato, aggiornare l'indice Lucene per aumentare la profondità indicizzata per il rilevamento dei collegamenti in ingresso (ad esempio, aggiungere definizioni di aggregazione come include4, include5 in /oak:index/cqPageLucene/aggregates/cq:PageContent).  Questi definiscono il livello di profondità di attraversamento dell'indice in jcr:content per rilevare i collegamenti.

  4. Dopo aver apportato le modifiche, salva il nodo indice e attiva la reindicizzazione per applicarle.

Opzione B - Ripristina impostazioni indice personalizzate:

Nota: la reindicizzazione può influire sulle prestazioni.  Pianifica l'attività durante i periodi con traffico ridotto.

  1. Passare a /oak:index/cqPageLucene in CRXDE Lite.
  2. Rimuovi eventuali analizzatori personalizzati o proprietà non configurate correttamente.
  3. Reimposta fulltextEnabled flag su valori OOTB.
  4. Imposta reindex = true e monitora tramite la console JMX o i registri.

Opzione C - disabilita configurazione avanzata (per il test):

  1. Vai a /system/console/configMgr e individua IncomingLinksReferenceProvider.
  2. Disattiva temporaneamente questa configurazione per verificare se sono presenti altri collegamenti in ingresso. Questo può aiutare a determinare se la configurazione sta eliminando i risultati.
  3. Riattiva la configurazione dopo il test per ripristinare il comportamento normale.

Convalida

  1. Utilizzare SQL2 per verificare i conteggi di collegamenti effettivi (il percorso /content/we-retail/us/en/about-us) è una pagina di destinazione di esempio. Sostituiscilo con il percorso effettivo della destinazione del collegamento.

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

  2. Per confermare la discrepanza, confronta i risultati della query con quelli visualizzati nella scheda Riferimenti.

Strumenti utili per la convalida delle query:

Per assistenza nella risoluzione dei problemi e nella convalida delle query di collegamento in arrivo, utilizza i seguenti strumenti disponibili in AEM:

  1. Strumento Prestazioni Query: http://localhost:4502/libs/granite/operations/content/diagnosistools/queryPerformance.html
    • Consente di testare e analizzare le query SQL2 e QueryBuilder per ottenere informazioni sulle prestazioni.
  2. Debugger JCR Query Builder- http://localhost:4502/libs/cq/search/content/querydebug.html
    • Consente l'esecuzione e il debug di query QueryBuilder con output dettagliato.

Causa

  • I nodi fortemente nidificati in jcr:content potrebbero non essere indicizzati per impostazione predefinita, causando la perdita di collegamenti in AEM a livelli più profondi. La regolazione degli aggregati Lucene aiuta a migliorare il riconoscimento della profondità.
  • Le configurazioni dell'indice Lucene personalizzato (ad esempio, analizzatori o proprietà non configurate correttamente) in /oak:index/cqPageLucene possono limitare l'indicizzazione full-text e influire sul rilevamento dei collegamenti.
  • Le configurazioni avanzate di rilevamento dei collegamenti, ad esempio IncomingLinksReferenceProvider, potrebbero impedire la visibilità dei collegamenti in ingresso. La disabilitazione temporanea di questo provider può rivelare i risultati soppressi e agevolare il debug.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f