설명서

들어오는 링크가 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가 있습니다.

옵션 A - 집계 깊이 조정:

  1. CRXDE Lite를 사용하여 링크가 포함된 노드의 계층 구조를 확인하십시오.

  2. 페이지 구조를 검토하고 링크 노드가 더 낮은 수준에 있도록 조정합니다.

  3. 연결 노드가 깊이 중첩되어 있으면 Lucene 인덱스를 업데이트하여 들어오는 링크 감지를 위해 인덱싱되는 깊이를 높입니다(예: include4, include5 등의 집계 정의를 /oak:index/cqPageLucene/aggregates/cq:PageContent 아래에 추가).  jcr:content에서 인덱스를 탐색하여 링크를 감지하는 정도를 정의합니다.

  4. 변경 후 인덱스 노드를 저장하고 리인덱싱을 트리거하여 적용합니다.

옵션 B - 사용자 지정 인덱스 설정 되돌리기:

참고: 다시 인덱싱하면 성능에 영향을 줄 수 있습니다.  트래픽이 적은 기간 동안 이 작업을 예약하십시오.

  1. CRXDE Lite의 /oak:index/cqPageLucene(으)로 이동합니다.
  2. 사용자 정의 분석기 또는 잘못 구성된 속성을 제거합니다.
  3. fulltextEnabled 플래그를 OOTB 값으로 다시 설정합니다.
  4. JMX 콘솔 또는 로그를 통해 reindex = true을(를) 설정하고 모니터링합니다.

옵션 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 쿼리 빌더 디버거 - 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