Documentation

Les fragments ne sont pas résolus dans l’API OSGi du service Output dans AEM

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

Dans Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS), les références aux fragments dans les fichiers XDP ne sont pas résolues lors de l’utilisation de l’API OSGi du service Output. Ce problème se produit lorsque les chemins d’accès relatifs ne sont pas interprétés correctement en raison d’une configuration incorrecte de la racine de contenu ou de références de fragment incorrectes. Pour résoudre ce problème, configurez la racine de contenu et utilisez les chemins d’accès relatifs appropriés.

Description description

Environnement

  • Produit : Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS)
  • Instance: Développement

Problème/Symptômes

  • Des erreurs telles que javax.jcr.PathNotFoundException et javax.jcr.RepositoryException apparaissent dans les journaux.
  • Les chemins de fragment incorporés dans des fichiers XDP avec des références relatives ne sont pas résolus comme prévu.

Résolution resolution

Pour résoudre les problèmes de résolution de fragment dans le service AEM Forms Output, procédez comme suit :

  1. Définissez le paramètre contentRoot sur le répertoire de niveau supérieur qui contient les fichiers XDP principaux et les dossiers de fragments. Par exemple, si votre dossier XDP principal est /content/dam/formsanddocuments/main-xdps et que vos fragments se trouvent sous /content/dam/formsanddocuments/fragments, définissez la racine de contenu sur /content/dam/formsanddocuments/.  Pour plus d'informations, consultez la section Générer des documents PDF à l'aide de fragments.
  2. Dans votre fichier XDP principal, indiquez les chemins d’accès relatifs aux fragments en fonction de la racine de contenu définie à l’étape 1. Par exemple, si un fragment de code-barres se trouve à l’emplacement /content/dam/formsanddocuments/fragments/barcode.xdp, utilisez ./fragments/barcode.xdp comme chemin de référence dans votre fichier XDP principal.
  3. N’utilisez pas de chemins absolus tels que /content/dam/formsanddocuments/fragments/xdp/barcode.xdp.
  4. Évitez de référencer des chemins qui naviguent vers le haut à partir de l’emplacement XDP principal (par exemple, ../../barcode.xdp).
  5. Lors de l’appel de outputService.generatePDFOutput(templateName, data, options), indiquez le chemin d’accès complet de votre fichier XDP principal (par exemple, crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp) comme nom du modèle.
  6. Après avoir implémenté ces ajustements, testez tous les scénarios pour garantir un comportement cohérent entre les différents XDP et fragments.

Lecture connexe

Service Output dans le Guide de l’utilisateur d’AEM.

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