DokumentationExperience Cloud KCS

Die Generierung der AEM Guides-Ausgabe schlägt aufgrund von verwaisten JCR-Versionsverweisen fehl

Letzte Aktualisierung: 30. Oktober 2026

Die Generierung von Adobe Experience Manager (AEM) Guides-Ausgaben kann hängen bleiben oder fehlschlagen, wenn ein DITA-Thema in der Abhängigkeitsstruktur einen fehlenden oder verwaisten JCR-Versionsverweis aufweist. Um das Problem zu beheben, identifizieren Sie das betroffene Thema, erstellen Sie eine neue Version, wiederholen Sie die Ausgabegenerierung und überprüfen Sie, ob der Auftrag erfolgreich abgeschlossen wurde.

Beschreibung description

Umgebung

  • Adobe Experience Manager Guides (AEM) (alle unterstützten Versionen)
  • Autoreninstanz

Problem/Symptome

  • Die Ausgabenerstellung für DITA-Zuordnungen wird nicht abgeschlossen oder bleibt über längere Zeiträume hängen.
  • Die Autorenleistung wird während des Vorfalls in der gesamten Instanz beeinträchtigt.
  • Fehlerprotokolle enthalten Meldungen wie: j avax.jcr.version.VersionException: Keine solche Version
  • Andere Ausgabegenerierungsaufträge in derselben Warteschlange können ebenfalls blockiert werden.

Grundursache

Ein fehlender oder verwaister JCR-Versionsverweis für ein DITA-Thema in der Abhängigkeitsstruktur verursacht das Problem, häufig aufgrund gleichzeitiger Vorgänge beim Einchecken von Versionen und bei der Asset-Verarbeitung.

Lösung resolution

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

  1. Überprüfen Sie die Fehlerprotokolle, um das betroffene DITA-Thema und die fehlende Version zu identifizieren, auf die im Fehler VersionException verwiesen wird.
  2. Überprüfen Sie im AEM-Repository, ob die referenzierte Version für das betroffene DITA-Thema vorhanden ist.
  3. Öffnen Sie das betroffene DITA-Thema im Guides-Editor.
  4. Nehmen Sie eine kleinere Änderung oder ein erneutes Speichern des Themas vor, und checken Sie dann eine neue Version ein. Wenden Sie die Genehmigt an, falls der Workflow dies erfordert.
  5. Wiederholen Sie den Ausgabenerstellungsprozess (Veröffentlichungsprozess) für die DITA-Zuordnung.
  6. Überwachen Sie den Vorgang, um zu bestätigen, dass die Ausgabegenerierung erfolgreich abgeschlossen wurde.
  7. Wenn das Problem weiterhin besteht, erfassen Sie die entsprechenden Fehlerprotokolle und wenden Sie sich an den Adobe-Support, um weitere Hilfe zu erhalten.
recommendation-more-help
experience-cloud-kcs-help-kbarticles