ドキュメント

着信リンクに、Adobe Experience Managerのすべてのリンクページが表示されない

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

Adobe Experience Managerの受信リンクビューに一部のページが表示されない場合、深くネストされたリンクノードまたはカスタムインデックス設定が原因である可能性があります。 この記事では、Lucene インデックスの深度の調整、カスタム設定の元に戻す、詳細設定オプションのテストによる解決方法を説明します。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service（AEMaaCS）
  • Adobe Experience Manager（AEM） 6.5

問題/症状

  • 新しい参照にもかかわらず、着信リンクのカウントが低いか変化していない。
  • フルテキスト クエリを実行すると、[ 参照 ] タブに表示されているよりも多くの結果が返されます。
  • この問題は、共有環境では発生しますが、新しいローカルの標準（OOTB）設定では発生しない可能性があります。

解決策 resolution

A、B、C の 3 つのトラブルシューティングパスがあります。

オプション A – 集計の深さを調整：

  1. CRXDE Lite を使用して、リンクを含むノードの階層を確認します。

  2. ページの構造を確認し、リンクノードがより浅いレベルに配置されるように調整します。

  3. リンクノードが深くネストされたままの場合は、Lucene インデックスを更新して、着信リンク検出用にインデックスされる深さを増やします（例えば、/oak:index/cqPageLucene/aggregates/cq:PageContent の下に include4、include5 などの集計定義を追加します）。  これらの定義は、リンクを検出するために、インデックスが jcr:content 下をトラバースする深さを定義します。

  4. 変更を加えた後、インデックスノードとトリガーのインデックス再作成を保存して、適用します。

オプション B - カスタムインデックス設定を元に戻す：

メモ：インデックス再作成は、パフォーマンスに影響を与える可能性があります。  トラフィックが少ない時間帯にこのタスクをスケジュールします。

  1. CRXDE Liteの /oak:index/cqPageLucene に移動します。
  2. カスタムアナライザーや誤った設定のプロパティを削除します。
  3. fulltextEnabled フラグを OOTB 値にリセットします。
  4. reindex = true を設定し、JMX コンソールまたはログを使用して監視します。

オプション C – 詳細設定を無効にする（テスト用）:

  1. /system/console/configMgr に移動して、IncomingLinksReferenceProvider を見つけます。
  2. この設定を一時的に無効にして、さらに着信リンクが表示されるかどうかを確認します。 これは、設定によって結果が抑制されているかどうかを判断するのに役立ちます。
  3. テスト後に設定を再度有効にして、通常の動作に戻します。

検証

  1. SQL2 を使用して、実際のリンク数を確認します（パス /content/we-retail/us/en/about-us) はサンプルターゲットページです）。 これをリンクターゲットの実際のパスに置き換えます。

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

  2. クエリ結果を「参照」タブに表示されるものと比較して、不一致を確認します。

クエリの検証に役立つツール：

受信リンククエリのトラブルシューティングと検証を支援するには、AEMで使用できる次のツールを使用します。

  1. クエリパフォーマンスツール - http://localhost:4502/libs/granite/operations/content/diagnosistools/queryPerformance.html
    • では、SQL2 クエリと QueryBuilder クエリをテストおよび分析して、パフォーマンスに関するインサイトを得ることができます。
  2. JCR Query Builder デバッガー – http://localhost:4502/libs/cq/search/content/querydebug.html
    • 詳細な出力を含む QueryBuilder クエリの実行とデバッグを有効にします。

原因：

  • jcr:content の下の深くネストされたノードは、デフォルトではインデックスが作成されない可能性があり、AEMの深いレベルでリンクが欠落する原因となります。 Lucene 集計の調整は、深度認識の改善に役立ちます。
  • /oak:index/cqPageLucene の下のカスタム Lucene インデックス設定（アナライザーや誤った設定のプロパティなど）は、フルテキストのインデックス作成を制限し、リンクの検出に影響を与える可能性があります。
  • IncomingLinksReferenceProvider などの高度なリンク検出設定では、着信リンクの表示が抑制される場合があります。 このプロバイダーを一時的に無効にすると、抑制された結果が表示され、デバッグに役立つ場合があります。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f