Résolution des problèmes de génération de sortie dans AEM Guides après la mise à niveau DITA-OT/Saxon
Dans Adobe Experience Manager (AEM) Guides, les tâches de génération de sortie échouent par intermittence après la mise à niveau d’un package DITA-OT/Saxon personnalisé, même si le contenu et la configuration source restent inchangés. Le problème inclut des erreurs d’URI de document en double et des échecs d’initialisation liés à des dépendances manquantes lors de la génération de la sortie. Pour résoudre ce problème, mettez à jour la configuration DITA-OT, vérifiez les dépendances requises et rechargez la configuration de profil DITA affectée.
Description description
Environnement
Adobe Experience Manager Guides avec un package personnalisé DITA-OT/Saxon (toutes les versions ; problème observé après la mise à niveau DITA-OT/Saxon)
Problème/Symptômes
- Les traitements de génération de sortie échouent par intermittence.
- Échec de l’initialisation : erreur lors du chargement de org/slf4j/Logger au démarrage de DITA-OT.
- Échec de la transformation : erreur document-URI en double référençant subjectScheme.ditamap.
- Les exécutions réussies et en échec se produisent avec la même configuration et le même contenu.
Cause
- L’erreur document-URI en double est probablement due à une validation ou à une gestion des URI plus strictes introduites par la version DITA-OT/Saxon mise à niveau, ce qui entraîne la résolution plus d’une fois du même document de schéma d’objet.
- L’échec d’initialisation du
org/slf4j/Loggerpointe vers une dépendance manquante, un package incomplet ou une mauvaise configuration du chemin de classe dans le package DITA-OT personnalisé mis à jour. - Les déploiements via le code peuvent ne pas déclencher la synchronisation de profil en mémoire nécessaire, ce qui nécessite un enregistrement manuel pour recharger la configuration.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème :
- Ajoutez
subjectScheme.ditamapà la liste d’exclusion de scan de carte en double dans votre configuration DITA-OT/Saxon. Après avoir appliqué la modification, vérifiez que la génération de sortie fonctionne comme prévu et examinez les résultats pour détecter tout effet secondaire inattendu. - Vérifiez que toutes les dépendances SLF4J et tous les fichiers JAR requis sont présents dans le package DITA-OT personnalisé déployé sur AEM.
- Assurez-vous que le package ZIP DITA-OT est complet et inclut toutes les bibliothèques requises.
- Passez en revue la configuration du chemin de classe dans le profil DITA et vérifiez qu’elle contient toutes les dépendances requises pour la boîte à outils mise à jour.
- Si le profil DITA a été déployé par le biais d’un code ou d’un package, rechargez manuellement la configuration en ouvrant le profil DITA concerné dans l’interface utilisateur d’AEM Guides, en supprimant les valeurs de chemin d’accès actuellement attribuées, en enregistrant le profil, en réattribuant les mêmes valeurs de chemin d’accès et en enregistrant à nouveau le profil. Patientez environ 10 à 15 minutes pour que la configuration se propage.
- Réessayez la génération de la sortie.
- Comparez le package DITA-OT local avec le package déployé sur AEM et vérifiez que les deux packages sont cohérents.
- Si le problème persiste, collectez et examinez les journaux d’erreurs des tâches de génération ayant échoué pour effectuer un dépannage supplémentaire.
- Exécutez une tâche de génération de sortie et vérifiez que les erreurs ne se produisent plus et que la sortie est générée avec succès.