설명서Experience Cloud KCS

DITA-OT/Saxon 업그레이드 후 AEM Guides의 출력 생성 오류 문제 해결

마지막 업데이트: 2026년 8월 30일

Adobe Experience Manager(AEM) Guides에서 사용자 지정 DITA-OT/Saxon 패키지를 업그레이드한 후 소스 콘텐츠와 구성이 변경되지 않은 경우에도 출력 생성 작업이 간헐적으로 실패합니다. 이 문제에는 출력 생성 중 누락된 종속성과 관련된 중복 문서 URI 오류 및 초기화 오류가 포함됩니다. 이 문제를 해결하려면 DITA-OT 구성을 업데이트하고 필요한 종속성을 확인한 다음 영향을 받는 DITA 프로필 구성을 다시 로드합니다.

설명 description

환경

사용자 지정 DITA-OT/Saxon 패키지가 포함된 Adobe Experience Manager Guides(모든 버전, DITA-OT/Saxon 업그레이드 후 관찰된 문제)

문제/증상

  • 출력 생성 작업이 간헐적으로 실패합니다.
  • 초기화 실패: DITA-OT를 시작하는 동안 org/slf4j/Logger를 로드하는 동안 오류가 발생했습니다.
  • 변환 실패: subjectScheme.ditamap를 참조하는 문서 URI 중복 오류.
  • 성공한 실행과 실패한 실행은 동일한 구성 및 콘텐츠에서 발생합니다.

원인

  • 중복된 document-URI 오류는 업그레이드된 DITA-OT/Saxon 버전에서 도입된 더 엄격한 유효성 검사 또는 URI 처리로 인해 동일한 주제 스키마 문서가 두 번 이상 해결될 수 있습니다.
  • org/slf4j/Logger 초기화 실패는 업데이트된 사용자 지정 DITA-OT 패키지에서 누락된 종속성, 불완전한 패키지 또는 클래스 경로 잘못된 구성을 가리킵니다.
  • 코드를 통한 배포는 필요한 메모리 내 프로필 동기화를 트리거하지 않을 수 있으므로 구성을 다시 로드하려면 수동 저장이 필요합니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. DITA-OT/Saxon 구성의 중복 맵 스캔 제외 목록에 subjectScheme.ditamap을(를) 추가합니다. 변경 사항을 적용한 후 출력 생성이 예상대로 작동하는지 확인하고 의도하지 않은 부작용이 있는지 결과를 검토하십시오.
  2. 필요한 모든 SLF4J 종속성 및 JAR 파일이 AEM에 배포된 사용자 지정 DITA-OT 패키지에 있는지 확인합니다.
  3. DITA-OT ZIP 패키지가 완전하고 모든 필수 라이브러리를 포함하는지 확인합니다.
  4. DITA 프로필에서 클래스 경로 구성을 검토하고 업데이트된 툴킷에 필요한 모든 종속성이 포함되어 있는지 확인합니다.
  5. DITA 프로파일이 코드 또는 패키지를 통해 배포된 경우 AEM Guides UI에서 영향을 받는 DITA 프로파일을 열고, 현재 지정된 경로 값을 제거하고, 프로파일을 저장하고, 동일한 경로 값을 재지정하고, 프로파일을 다시 저장하여 구성을 수동으로 다시 로드합니다. 구성이 전파될 때까지 약 10~15분 정도 기다립니다.
  6. 출력 생성을 다시 시도하십시오.
  7. 로컬 DITA-OT 패키지를 AEM에 배포된 패키지와 비교하고 두 패키지가 일관되는지 확인합니다.
  8. 문제가 지속되면 실패한 생성 작업에서 오류 로그를 수집하고 검토하여 추가 문제 해결을 확인하십시오.
  9. 출력 생성 작업을 실행하고 더 이상 오류가 발생하지 않고 해당 출력이 성공적으로 생성되는지 확인하십시오.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles