Documentazione

Frammenti che non vengono risolti nell’API OSGi del servizio di output in AEM

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

In Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS), i riferimenti ai frammenti all’interno dei file XDP non vengono risolti quando si utilizza l’API OSGi del servizio di output. Questo problema si verifica quando i percorsi relativi non vengono interpretati correttamente a causa di una configurazione errata della directory principale del contenuto o di riferimenti a frammenti errati. Per risolvere il problema, configura la directory principale del contenuto e utilizza i percorsi relativi corretti.

Descrizione description

Ambiente

  • Prodotto: Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS)
  • Istanza: Sviluppo

Problema/Sintomi

  • Nei registri vengono visualizzati errori quali javax.jcr.PathNotFoundException e javax.jcr.RepositoryException.
  • I percorsi dei frammenti incorporati nei file XDP con riferimenti relativi non vengono risolti come previsto.

Risoluzione resolution

Per risolvere i problemi di risoluzione dei frammenti nel servizio di output di AEM Forms, effettua le seguenti operazioni:

  1. Imposta il parametro contentRoot sulla directory di livello principale che contiene sia gli XDP principali che le cartelle dei frammenti. Ad esempio, se la cartella XDP principale è /content/dam/formsanddocuments/main-xdps e i frammenti si trovano in /content/dam/formsanddocuments/fragments, impostare la directory principale del contenuto su /content/dam/formsanddocuments/.  Consulta Generazione di documenti PDF tramite frammenti.
  2. Nel file XDP principale, fornisci i percorsi relativi dei frammenti in base alla directory principale del contenuto impostata nel passaggio 1. Ad esempio, se un frammento di codice a barre si trova in /content/dam/formsanddocuments/fragments/barcode.xdp, utilizza ./fragments/barcode.xdp come percorso di riferimento nell'XDP principale.
  3. Non utilizzare percorsi assoluti come /content/dam/formsanddocuments/fragments/xdp/barcode.xdp.
  4. Evitare di fare riferimento a percorsi che si spostano verso l'alto dal percorso XDP principale (ad esempio, ../../barcode.xdp).
  5. Quando si chiama outputService.generatePDFOutput(templateName, data, options), fornire il percorso completo del file XDP principale (ad esempio crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp) come nome del modello.
  6. Dopo aver implementato queste regolazioni, verifica tutti gli scenari per garantire un comportamento coerente tra diversi XDP e frammenti.

Lettura correlata

Servizio di output nella Guida utente di AEM.

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