Risoluzione dei problemi di generazione dell’output in AEM Guides dopo l’aggiornamento DITA-OT/Saxon
Nelle guide di Adobe Experience Manager (AEM), i processi di generazione dell’output non riescono in modo intermittente dopo l’aggiornamento di un pacchetto DITA-OT/Saxon personalizzato, anche quando il contenuto e la configurazione di origine rimangono invariati. Il problema include errori Document-URI duplicati ed errori di inizializzazione correlati a dipendenze mancanti durante la generazione dell’output. Per risolvere il problema, aggiornare la configurazione DITA-OT, verificare le dipendenze richieste e ricaricare la configurazione del profilo DITA interessata.
Descrizione description
Ambiente
Adobe Experience Manager Guides con pacchetto DITA-OT/Saxon personalizzato (tutte le versioni; problema osservato dopo l’aggiornamento DITA-OT/Saxon)
Problema/Sintomi
- I processi di generazione dell’output hanno esito negativo a intermittenza.
- Errore di inizializzazione: errore durante il caricamento di org/slf4j/Logger durante l’avvio di DITA-OT.
- Errore di trasformazione: errore URI documento duplicato che fa riferimento a subjectScheme.ditamap.
- Le esecuzioni riuscite e non riuscite si verificano con la stessa configurazione e lo stesso contenuto.
Causa
- L’errore di URI documento duplicato è probabilmente dovuto a una convalida o a una gestione URI più rigorosa introdotta dalla versione aggiornata DITA-OT/Saxon, che causa la risoluzione più di una volta dello stesso documento dello schema soggetto.
- L’errore di inizializzazione
org/slf4j/Loggerindica una dipendenza mancante, un pacchetto incompleto o una configurazione errata del classpath nel pacchetto DITA-OT personalizzato aggiornato. - Le distribuzioni tramite il codice potrebbero non attivare la sincronizzazione del profilo in memoria necessaria e richiedere un salvataggio manuale per ricaricare la configurazione.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
- Aggiungere
subjectScheme.ditamapall’elenco di esclusione della scansione con mappa duplicata nella configurazione DITA-OT/Saxon. Dopo aver applicato la modifica, verificare che la generazione di output funzioni come previsto e rivedere i risultati per eventuali effetti collaterali non desiderati. - Verifica che tutte le dipendenze SLF4J e i file JAR richiesti siano presenti nel pacchetto DITA-OT personalizzato distribuito in AEM.
- Verificare che il pacchetto ZIP DITA-OT sia completo e che includa tutte le librerie richieste.
- Esaminare la configurazione del percorso di classe nel profilo DITA e verificare che contenga tutte le dipendenze richieste per il toolkit aggiornato.
- Se il profilo DITA è stato distribuito tramite codice o un pacchetto, ricaricare manualmente la configurazione aprendo il profilo DITA interessato nell’interfaccia utente di AEM Guides, rimuovendo i valori di percorso attualmente assegnati, salvando il profilo, riassegnando gli stessi valori di percorso e salvando nuovamente il profilo. Attendere circa 10-15 minuti per la propagazione della configurazione.
- Riprovare la generazione dell’output.
- Confrontare il pacchetto DITA-OT locale con il pacchetto distribuito in AEM e verificare che entrambi i pacchetti siano coerenti.
- Se il problema persiste, raccogli e rivedi i registri di errore dai processi di generazione non riusciti per una ulteriore risoluzione dei problemi.
- Esegui un processo di generazione dell’output e verifica che gli errori non si verifichino più e che l’output venga generato correttamente.