Dokumentation

Fragment som inte löses i OSGi API:t för Output Service i AEM

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

I Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS) går det inte att matcha fragmentreferenser i XDP-filer när OSGi-API:t för utdatatjänsten används. Detta problem uppstår när relativa sökvägar inte tolkas korrekt på grund av felaktig konfiguration av innehållsroten eller felaktiga fragmentreferenser. Du löser problemet genom att konfigurera innehållsroten och använda rätt relativa sökvägar.

Beskrivning description

Miljö

  • Produkt: Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS)
  • Instans: Utveckling

Problem/symtom

  • Fel som javax.jcr.PathNotFoundException och javax.jcr.RepositoryException visas i loggar.
  • Fragmentsökvägar som är inbäddade i XDP-filer med relativa referenser tolkas inte som förväntat.

Upplösning resolution

Följ de här stegen för att lösa fragmentlösningsproblem i AEM Forms Output Service:

  1. Ställ in parametern contentRoot på den översta katalogen som innehåller både huvud-XDP:er och fragmentmappar. Om till exempel din XDP-huvudmapp är /content/dam/formsanddocuments/main-xdps och dina fragment finns under /content/dam/formsanddocuments/fragments anger du innehållsroten till /content/dam/formsanddocuments/.  Se Generera PDF-dokument med fragment.
  2. I XDP-huvudfilen anger du relativa sökvägar för fragment baserat på innehållets rotuppsättning i steg 1. Om till exempel ett streckkodsfragment finns på /content/dam/formsanddocuments/fragments/barcode.xdp använder du ./fragments/barcode.xdp som referenssökväg i XDP-huvudfilen.
  3. Använd inte absoluta sökvägar som /content/dam/formsanddocuments/fragments/xdp/barcode.xdp.
  4. Undvik att referera till sökvägar som navigerar uppåt från XDP-huvudplatsen (till exempel ../../barcode.xdp).
  5. När du anropar outputService.generatePDFOutput(templateName, data, options) anger du den fullständiga sökvägen till XDP-huvudfilen (till exempel crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp) som mallnamn.
  6. När du har implementerat justeringarna testar du alla scenarier för att säkerställa konsekvent beteende i olika XDP-filer och fragment.

Relaterad läsning

Utdatatjänst i AEM användarhandbok.

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