Fehlerbehebung bei Fehlern bei der Ausgabegenerierung in AEM Guides nach dem DITA-OT/Saxon-Upgrade

Letzte Aktualisierung: 30. August 2026

In Adobe Experience Manager (AEM) Guides schlagen Ausgabegenerierungsvorgänge nach dem Upgrade eines benutzerdefinierten DITA-OT/Saxon-Pakets gelegentlich fehl, auch wenn der Quellinhalt und die Konfiguration unverändert bleiben. Das Problem umfasst Fehler bei doppelten Dokument-URIs und Initialisierungsfehler im Zusammenhang mit fehlenden Abhängigkeiten während der Ausgabegenerierung. Um dieses Problem zu beheben, aktualisieren Sie die DITA-OT-Konfiguration, überprüfen Sie die erforderlichen Abhängigkeiten und laden Sie die betroffene DITA-Profilkonfiguration neu.

Beschreibung description

Umgebung

Adobe Experience Manager Guides mit einem benutzerdefinierten DITA-OT/Saxon-Paket (alle Versionen; Problem nach DITA-OT/Saxon-Upgrade beobachtet)

Problem/Symptome

Ausgabegenerierungsvorgänge schlagen gelegentlich fehl.
Initialisierungsfehler: Fehler beim Laden von org/slf4j/Logger beim DITA-OT-Start.
Umwandlungsfehler: Fehler wegen doppelten Dokument-URI mit Verweis auf subjectScheme.ditamap.
Erfolgreiche und fehlgeschlagene Ausführungen erfolgen mit derselben Konfiguration und demselben Inhalt.

Ursache

Der Fehler beim Duplizieren des Dokument-URI ist wahrscheinlich auf eine strengere Validierung oder URI-Behandlung zurückzuführen, die mit der aktualisierten DITA-OT/Saxon-Version eingeführt wurde, sodass dasselbe Subjektschema-Dokument mehrmals aufgelöst wird.
Der org/slf4j/Logger Initialisierungsfehler verweist auf eine fehlende Abhängigkeit, ein unvollständiges Paket oder eine Klassenpfad-Fehlkonfiguration im aktualisierten benutzerdefinierten DITA-OT-Paket.
Bei Bereitstellungen per Code tritt möglicherweise kein Trigger bei der erforderlichen Profilsynchronisierung im Arbeitsspeicher auf. Daher ist ein manuelles Speichern erforderlich, um die Konfiguration neu zu laden.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Fügen Sie in Ihrer DITA-OT/Saxon-Konfiguration subjectScheme.ditamap zur Ausschlussliste für die Suche nach doppelten Karten hinzu. Überprüfen Sie nach dem Anwenden der Änderung, ob die Ausgabegenerierung erwartungsgemäß funktioniert, und überprüfen Sie die Ergebnisse auf unbeabsichtigte Nebenwirkungen.
Überprüfen Sie, ob alle erforderlichen SLF4J-Abhängigkeiten und JAR-Dateien im benutzerdefinierten DITA-OT-Paket vorhanden sind, das in AEM bereitgestellt wird.
Stellen Sie sicher, dass das DITA-OT-ZIP-Paket vollständig ist und alle erforderlichen Bibliotheken enthält.
Überprüfen Sie die Klassenpfadkonfiguration im DITA-Profil und stellen Sie sicher, dass sie alle erforderlichen Abhängigkeiten für das aktualisierte Toolkit enthält.
Wenn das DITA-Profil über einen Code oder ein Paket bereitgestellt wurde, laden Sie die Konfiguration manuell neu, indem Sie das betroffene DITA-Profil in der AEM Guides-Benutzeroberfläche öffnen, die aktuell zugewiesenen Pfadwerte entfernen, das Profil speichern, dieselben Pfadwerte neu zuweisen und das Profil erneut speichern. Warten Sie etwa 10 bis 15 Minuten, bis die Konfiguration sich ausbreitet.
Ausgabegenerierung wiederholen.
Vergleichen Sie das lokale DITA-OT-Paket mit dem in AEM bereitgestellten Paket und stellen Sie sicher, dass beide Pakete konsistent sind.
Wenn das Problem weiterhin besteht, sammeln und überprüfen Sie zur weiteren Fehlerbehebung Fehlerprotokolle aus fehlgeschlagenen Generierungsaufträgen.
Führen Sie einen Ausgabegenerierungsauftrag aus und stellen Sie sicher, dass die Fehler nicht mehr auftreten und dass die Ausgabe erfolgreich generiert wird.