설명서

AEM의 출력 서비스 OSGi API에서 조각이 해결되지 않음

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Experience Manager Forms as a Cloud Service(AEMFaaCS)에서 출력 서비스 OSGi API를 사용할 때 XDP 파일 내의 조각 참조를 확인하지 못했습니다. 이 문제는 콘텐츠 루트의 부적절한 구성 또는 잘못된 조각 참조로 인해 상대 경로가 올바르게 해석되지 않을 때 발생합니다. 이 문제를 해결하려면 컨텐츠 루트를 구성하고 올바른 상대 경로를 사용합니다.

설명 description

환경

  • 제품: Adobe Experience Manager Forms as a Cloud Service(AEMFaaCS)
  • 인스턴스: 개발

문제/증상

  • javax.jcr.PathNotFoundException 및 javax.jcr.RepositoryException ​과 같은 오류가 로그에 표시됩니다.
  • 상대 참조가 있는 XDP 파일에 포함된 조각 경로는 예상대로 확인되지 않습니다.

해결 방법 resolution

AEM Forms 출력 서비스의 조각 해결 문제를 해결하려면 다음 단계를 따르십시오.

  1. contentRoot 매개 변수를 주 XDP와 조각 폴더가 모두 포함된 최상위 디렉터리로 설정하십시오. 예를 들어 기본 XDP 폴더가 /content/dam/formsanddocuments/main-xdps이고 조각이 /content/dam/formsanddocuments/fragments 아래에 있는 경우 콘텐츠 루트를 /content/dam/formsanddocuments/(으)로 설정합니다.  조각을 사용하여 PDF 문서 생성을 참조하세요.
  2. 기본 XDP 파일에서 1단계에서 설정한 콘텐츠 루트를 기반으로 조각에 대한 상대 경로를 제공합니다. 예를 들어 바코드 조각이 /content/dam/formsanddocuments/fragments/barcode.xdp에 있으면 ./fragments/barcode.xdp을(를) 기본 XDP에서 참조 경로로 사용합니다.
  3. /content/dam/formsanddocuments/fragments/xdp/barcode.xdp과(와) 같은 절대 경로를 사용하지 마십시오.
  4. 기본 XDP 위치에서 위쪽으로 이동하는 경로를 참조하지 마십시오(예: ../../barcode.xdp).
  5. outputService.generatePDFOutput(templateName, data, options)을(를) 호출할 때 기본 XDP 파일의 전체 경로(예: crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp)를 템플릿 이름으로 제공하십시오.
  6. 이러한 조정을 구현한 후 모든 시나리오를 테스트하여 다양한 XDP 및 조각에서 일관된 동작이 보장되도록 하십시오.

관련 읽기

AEM 사용 안내서의 출력 서비스.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f