Documentação

Fragmentos não resolvidos na API OSGi do serviço de saída no AEM

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

No Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS), as referências de fragmento em arquivos XDP não são resolvidas ao usar a API OSGi do serviço de saída. Esse problema ocorre quando caminhos relativos não são interpretados corretamente devido à configuração inadequada da raiz do conteúdo ou a referências de fragmento incorretas. Para resolver o problema, configure a raiz do conteúdo e use caminhos relativos corretos.

Descrição description

Ambiente

  • Produto: Adobe Experience Manager Forms as a Cloud Service (AEMFaaCS)
  • Instância: Desenvolvimento

Problema/Sintomas

  • Erros como javax.jcr.PathNotFoundException e javax.jcr.RepositoryException aparecem nos logs.
  • Caminhos de fragmento incorporados em arquivos XDP com referências relativas não são resolvidos conforme esperado.

Resolução resolution

Siga estas etapas para resolver problemas de resolução de fragmento no AEM Forms Output Service:

  1. Defina o parâmetro contentRoot para o diretório de nível superior que contém XDPs principais e pastas de fragmento. Por exemplo, se a pasta XDP principal for /content/dam/formsanddocuments/main-xdps e os fragmentos estiverem localizados em /content/dam/formsanddocuments/fragments, defina a raiz do conteúdo como /content/dam/formsanddocuments/.  Consulte Gerando documentos pdf usando fragmentos.
  2. No arquivo XDP principal, forneça caminhos relativos para fragmentos com base na raiz do conteúdo definida na etapa 1. Por exemplo, se um fragmento de código de barras estiver localizado em /content/dam/formsanddocuments/fragments/barcode.xdp, use ./fragments/barcode.xdp como o caminho de referência no XDP principal.
  3. Não use caminhos absolutos como /content/dam/formsanddocuments/fragments/xdp/barcode.xdp.
  4. Evite referenciar caminhos que navegam para cima a partir do local XDP principal (por exemplo, ../../barcode.xdp).
  5. Ao chamar outputService.generatePDFOutput(templateName, data, options), forneça o caminho completo do seu arquivo XDP principal (por exemplo, crx:///content/dam/formsanddocuments/af-personal/main-xdps/CM201-0822.xdp) como o nome do modelo.
  6. Depois de implementar esses ajustes, teste todos os cenários para garantir um comportamento consistente em diferentes XDPs e fragmentos.

Leitura relacionada

Serviço de saída no Guia do Usuário do AEM.

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