Solución de problemas de errores de generación de resultados en AEM Guides después de la actualización de DITA-OT/Saxon
En las guías de Adobe Experience Manager (AEM), los trabajos de generación de resultados fallan intermitentemente después de actualizar un paquete DITA-OT/Saxon personalizado, incluso cuando el contenido y la configuración de origen permanecen sin cambios. El problema incluye errores de URI de documento duplicados y errores de inicialización relacionados con dependencias que faltan durante la generación de salida. Para solucionar este problema, actualice la configuración de DITA-OT, compruebe las dependencias necesarias y vuelva a cargar la configuración del perfil DITA afectada.
Descripción description
Entorno
Adobe Experience Manager Guides con un paquete DITA-OT/Saxon personalizado (todas las versiones; problema observado tras la actualización de DITA-OT/Saxon)
Problema/Síntomas
- Los trabajos de generación de salida fallan intermitentemente.
- Error de inicialización: error al cargar org/slf4j/Logger durante el inicio de DITA-OT.
- Error de transformación: error duplicado de URI de documento que hace referencia a subjectScheme.ditamap.
- Las ejecuciones correctas y fallidas se producen con la misma configuración y contenido.
Causa
- Es probable que el error de URI de documento duplicado se deba a una validación o manejo de URI más estrictos introducidos por la versión actualizada de DITA-OT/Saxon, lo que provoca que el mismo documento de esquema de asunto se resuelva más de una vez.
- El error de inicialización
org/slf4j/Loggerseñala a una dependencia que falta, a un paquete incompleto o a una configuración incorrecta de la ruta de clase en el paquete DITA-OT personalizado actualizado. - Es posible que las implementaciones mediante código no almacenen en déclencheur la sincronización de perfiles en memoria necesaria, lo que requiere un guardado manual para volver a cargar la configuración.
Resolución resolution
Siga los pasos a continuación para resolver el problema:
- Agregue
subjectScheme.ditamapa la lista de exclusión de análisis de mapas duplicados en su configuración de DITA-OT/Saxon. Después de aplicar el cambio, valide que la generación de resultados funciona según lo esperado y revise los resultados para ver si hay efectos secundarios no deseados. - Compruebe que todas las dependencias SLF4J y archivos JAR necesarios estén presentes en el paquete DITA-OT personalizado implementado en AEM.
- Asegúrese de que el paquete DITA-OT ZIP esté completo e incluya todas las bibliotecas requeridas.
- Revise la configuración de la ruta de clase en el perfil DITA y confirme que contiene todas las dependencias necesarias para el kit de herramientas actualizado.
- Si el perfil DITA se ha implementado mediante código o un paquete, vuelva a cargar manualmente la configuración abriendo el perfil DITA afectado en la interfaz de usuario de AEM Guides, quitando los valores de ruta asignados actualmente, guardando el perfil, reasignando los mismos valores de ruta y guardando el perfil de nuevo. Espere aproximadamente de 10 a 15 minutos para que la configuración se propague.
- Vuelva a intentar la generación de salida.
- Compare el paquete DITA-OT local con el paquete implementado en AEM y confirme que ambos paquetes son coherentes.
- Si el problema persiste, recopile y revise los registros de errores de los trabajos de generación con errores para obtener más información sobre la solución de problemas.
- Ejecute un trabajo de generación de resultados y compruebe que ya no se producen los errores y que la salida se genera correctamente.