Documentation

Les liens entrants n’affichent pas toutes les pages de liaison dans Adobe Experience Manager

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

Si certaines pages sont manquantes dans la vue des liens entrants dans Adobe Experience Manager, le problème peut être dû à des nœuds de lien profondément imbriqués ou à des configurations d’index personnalisées. Cet article explique comment le résoudre en ajustant la profondeur de l’index Lucene, en rétablissant les paramètres personnalisés ou en testant les options de configuration avancées.

Description description

Environnement

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

Problèmes/Symptômes

  • Le nombre de liens entrants est faible ou inchangé malgré de nouvelles références.
  • Les requêtes en texte intégral renvoient plus de résultats que ce qui est indiqué dans l’onglet Références .
  • Le problème peut se produire dans les environnements partagés, mais pas dans les nouvelles configurations locales prêtes à l’emploi.

Résolution resolution

Il existe trois chemins de dépannage A, B et C.

Option A - ajuster la profondeur de l’agrégat :

  1. Vérifiez la hiérarchie des nœuds qui contiennent le lien à l’aide de CRXDE Lite.

  2. Examinez la structure de la page et ajustez-la afin que le nœud du lien se trouve à un niveau moins profond.

  3. Si le nœud de liaison reste profondément imbriqué, mettez à jour l’index Lucene pour augmenter la profondeur indexée pour la détection des liens entrants (par exemple, ajoutez des définitions d’agrégat telles que include4, include5 sous /oak:index/cqPageLucene/aggregates/cq:PageContent).  Ils définissent la profondeur à laquelle l’index doit parcourir sous jcr:content pour détecter les liens.

  4. Après avoir apporté des modifications, enregistrez le nœud d’index et déclenchez la réindexation pour les appliquer.

Option B - rétablir les paramètres d’index personnalisés :

Remarque : la réindexation peut avoir un impact sur les performances.  Planifiez cette tâche pendant les périodes de faible trafic.

  1. Accédez à /oak:index/cqPageLucene dans CRXDE Lite.
  2. Supprimez tous les analyseurs personnalisés ou les propriétés mal configurées.
  3. Réinitialisez les indicateurs de fulltextEnabled aux valeurs prêtes à l’emploi.
  4. Définissez reindex = true et surveillez via la console JMX ou les journaux.

Option C - Désactiver la configuration avancée (pour le test) :

  1. Accédez à /system/console/configMgr et localisez IncomingLinksReferenceProvider.
  2. Désactivez temporairement cette configuration pour vérifier si d’autres liens entrants apparaissent. Cela peut aider à déterminer si la configuration supprime les résultats.
  3. Réactivez la configuration après l’avoir testée pour restaurer un comportement normal.

Validation

  1. Utilisez SQL2 pour vérifier le nombre réel de liens (le chemin /content/we-retail/us/en/about-us) est un exemple de page cible. Remplacez-le par le chemin d’accès réel de votre cible de lien.

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

  2. Comparez les résultats de la requête à ceux affichés dans l’onglet Références pour confirmer l’incohérence.

Outils utiles pour la validation des requêtes :

Pour faciliter la résolution des problèmes et la validation des requêtes de lien entrant, utilisez les outils suivants disponibles dans AEM :

  1. Outil de performance des requêtes - http://localhost:4502/libs/granite/operations/content/diagnosistools/queryPerformance.html
    • Permet de tester et d’analyser les requêtes SQL2 et QueryBuilder pour obtenir des informations sur les performances.
  2. Débogueur Query Builder JCR - http://localhost:4502/libs/cq/search/content/querydebug.html
    • Permet l’exécution et le débogage des requêtes QueryBuilder avec une sortie détaillée.

Cause

  • Les nœuds profondément imbriqués sous jcr:content peuvent ne pas être indexés par défaut, ce qui peut entraîner l’absence de liens vers AEM à des niveaux plus profonds. L’ajustement des agrégats Lucene permet d’améliorer la reconnaissance de la profondeur.
  • Les configurations d’index Lucene personnalisées (par exemple, des analyseurs ou des propriétés mal configurées) sous /oak:index/cqPageLucene peuvent restreindre l’indexation de texte intégral et affecter la détection des liens.
  • Les configurations avancées de détection des liens, telles que IncomingLinksReferenceProvider, peuvent supprimer la visibilité des liens entrants. La désactivation temporaire de ce fournisseur peut afficher les résultats supprimés et faciliter le débogage.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f