Dokumentation

Fragmente werden in der Ausgabe-Service-OSGi-API in AEM nicht aufgelöst

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

In Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS) können Fragmentverweise in XDP-Dateien nicht aufgelöst werden, wenn die OSGi-API des Ausgabe-Services verwendet wird. Dieses Problem tritt auf, wenn relative Pfade aufgrund einer fehlerhaften Konfiguration des Inhaltsstamms oder falscher Fragmentverweise nicht korrekt interpretiert werden. Um das Problem zu beheben, konfigurieren Sie den Inhaltsstamm und verwenden Sie die richtigen relativen Pfade.

Beschreibung description

Umgebung

  • Produkt: Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS)
  • instance: Development

Problem/Symptome

  • Fehler wie .javax.jcr.PathNotFoundException und javax.jcr.RepositoryException werden in Protokollen angezeigt.
  • Fragmentpfade, die in XDP-Dateien mit relativen Verweisen eingebettet sind, werden nicht wie erwartet aufgelöst.

Auflösung resolution

Führen Sie die folgenden Schritte aus, um Probleme mit der Fragmentauflösung im AEM Forms Output Service zu beheben:

  1. Legen Sie den contentRoot-Parameter auf das Verzeichnis der obersten Ebene fest, das sowohl Haupt-XDPs als auch Fragmentordner enthält. Wenn sich beispielsweise Ihr XDP-Hauptordner /content/dam/formsanddocuments/main-xdps und Ihre Fragmente unter /content/dam/formsanddocuments/fragments befinden, legen Sie den Inhaltsstamm auf /content/dam/formsanddocuments/ fest.  Siehe Erstellen von PDF-Dokumenten mithilfe von Fragmenten.
  2. Geben Sie in Ihrer XDP-Hauptdatei relative Pfade für Fragmente an, die auf dem in Schritt 1 festgelegten Inhaltsstamm basieren. Wenn sich beispielsweise ein Barcode-Fragment unter /content/dam/formsanddocuments/fragments/barcode.xdp befindet, verwenden Sie ./fragments/barcode.xdp als Referenzpfad in Ihrer Haupt-XDP.
  3. Verwenden Sie keine absoluten Pfade wie /content/dam/formsanddocuments/fragments/xdp/barcode.xdp.
  4. Referenzieren Sie keine Pfade, die vom XDP-Hauptspeicherort nach oben navigieren (z. B. ../../barcode.xdp).
  5. Geben Sie beim Aufrufen von outputService.generatePDFOutput(templateName, data, options) den vollständigen Pfad Ihrer XDP-Hauptdatei (z. B. crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp) als Namen der Vorlage an.
  6. Testen Sie nach der Implementierung dieser Anpassungen alle Szenarien, um ein konsistentes Verhalten über verschiedene XDPs und Fragmente hinweg sicherzustellen.

Verwandtes Lesen

Output-) im AEM-Benutzerhandbuch.

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