DocumentaçãoKCS da Experience Cloud

Solução de problemas de falhas de geração de saída no AEM Guides após a atualização de DITA-OT/Saxon

Última atualização: 30 de agosto de 2026

Nos Guias do Adobe Experience Manager (AEM), os trabalhos de geração de saída falham intermitentemente após a atualização de um pacote DITA-OT/Saxon personalizado, mesmo quando o conteúdo e a configuração de origem permanecem inalterados. O problema inclui erros de URI de documento duplicado e falhas de inicialização relacionadas a dependências ausentes durante a geração de saída. Para corrigir esse problema, atualize a configuração DITA-OT, verifique as dependências necessárias e recarregue a configuração do perfil DITA afetado.

Descrição description

Ambiente

Adobe Experience Manager Guides com um pacote DITA-OT/Saxon personalizado (todas as versões; problema observado após a atualização DITA-OT/Saxon)

Problema/Sintomas

  • Os trabalhos de geração de saída falham intermitentemente.
  • Falha de inicialização: erro ao carregar org/slf4j/Logger durante a inicialização DITA-OT.
  • Falha de transformação: erro de document-URI duplicado referenciando subjectScheme.ditamap.
  • Execuções bem-sucedidas e com falha ocorrem com a mesma configuração e conteúdo.

Causa

  • O erro de URI de documento duplicado provavelmente se deve à validação mais rigorosa ou ao manuseio de URI introduzido pela versão atualizada DITA-OT/Saxon, fazendo com que o mesmo documento de esquema de assunto seja resolvido mais de uma vez.
  • A falha de inicialização org/slf4j/Logger aponta para uma dependência ausente, um pacote incompleto ou uma configuração incorreta do classpath no pacote DITA-OT personalizado atualizado.
  • As implantações por meio do código podem não acionar a sincronização de perfil na memória necessária, exigindo um salvamento manual para recarregar a configuração.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Adicione subjectScheme.ditamap à lista de exclusão de verificação de mapa duplicado na configuração DITA-OT/Saxon. Depois de aplicar a alteração, valide se a geração de saída funciona como esperado e revise os resultados para verificar se há efeitos colaterais não desejados.
  2. Verifique se todas as dependências do SLF4J e os arquivos JAR necessários estão presentes no pacote DITA-OT personalizado implantado no AEM.
  3. Verifique se o pacote ZIP DITA-OT está completo e inclui todas as bibliotecas necessárias.
  4. Revise a configuração do classpath no perfil DITA e confirme se ele contém todas as dependências necessárias para o kit de ferramentas atualizado.
  5. Se o perfil DITA foi implantado por meio de código ou um pacote, recarregue manualmente a configuração abrindo o perfil DITA afetado na interface do AEM Guides, removendo os valores de caminho atribuídos no momento, salvando o perfil, reatribuindo os mesmos valores de caminho e salvando o perfil novamente. Aguarde aproximadamente de 10 a 15 minutos para que a configuração se propague.
  6. Tente gerar novamente a saída.
  7. Compare o pacote DITA-OT local com o pacote implantado no AEM e confirme se os dois pacotes são consistentes.
  8. Se o problema persistir, colete e revise os logs de erro de trabalhos de geração com falha para obter solução de problemas adicional.
  9. Execute um trabalho de geração de saída e verifique se os erros não ocorrem mais e se a saída é gerada com êxito.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles