Beheben von DITA-Nachbearbeitungsfehlern aufgrund von B-Tree-Indexfehlern in AEM Guides
Die Nachbearbeitung von DITA- und DITAMAP-Dateien in Adobe Experience Manager (AEM) Guides kann aufgrund von Inkonsistenzen im B-Tree-Referenzindex fehlschlagen, häufig nachdem Sie Inhalte im DAM gelöscht und erneut hochgeladen haben. Um das Problem zu beheben, laden Sie den Inhalt hoch und extrahieren Sie ihn an einen neuen Speicherort im DAM.
Beschreibung description
Umgebung
Handbücher zu Adobe Experience Manager (AEM)
Symptome
Nachbearbeitungsfehler können in AEM Guides auftreten, wenn mit DITA- und DITAMAP-Dateien gearbeitet wird, die gelöscht und erneut in DAM aufgenommen wurden. Dieses Problem tritt in der Regel auf, wenn die erwarteten Eigenschaften im jcr:content der betroffenen Dateien fehlen und wiederholte Versuche, diese Dateien zu öffnen oder zu speichern, denselben Trigger aufweisen.
Das Problem hängt oft mit der Methode zusammen, die zum Löschen des Inhalts verwendet wird, insbesondere wenn das Löschen außerhalb der standardmäßigen AEM-Benutzeroberfläche durchgeführt wurde, was dazu führen kann, dass der B-Tree-Referenzindex in einem inkonsistenten Zustand verbleibt. Daher kann die Nachbearbeitung nicht erfolgreich abgeschlossen werden, und die Dateien verbleiben in einem Fehlerstatus.
Lösung resolution
Führen Sie diese Schritte aus, um das Problem zu beheben.
-
Löschen Sie die betroffene ZIP-Datei und alle extrahierten Inhalte aus dem DAM.
-
Laden Sie die ZIP-Datei hoch und extrahieren Sie sie in einen neuen Ordner oder einen anderen Pfad im DAM (verwenden Sie nicht den ursprünglichen Ordner erneut).
-
Stellen Sie nach der Extraktion sicher, dass die Nachbearbeitung für die Dateien am neuen Speicherort erfolgreich abgeschlossen wurde.
-
(Optional) Verwenden Sie die folgenden Endpunkte, um den B-Tree-Referenzindex zu überprüfen und zu reparieren:
- GET
/bin/fmdita/validatebtree?operation=validate(meldet fehlerhafte Inhaltsreferenzen) - GET
/bin/fmdita/validatebtree?operation=patch(versucht fehlerhafte Verweise zu korrigieren)
Hinweis: Bei diesen Vorgängen können Diagnoseinformationen bereitgestellt werden, das Problem wird jedoch möglicherweise nicht immer behoben.
- GET
-
Vergewissern Sie sich, dass das Löschen von Inhalten über die AEM-Benutzeroberfläche und nicht direkt über CRX/DE erfolgt, um Indexinkonsistenzen in Zukunft zu vermeiden.
-
Wenn das Problem nach Befolgung dieser Schritte weiterhin besteht, sammeln Sie vollständige Fehlerprotokolle über den Upload- und Extraktionsprozess und wenden Sie sich an den Adobe-Support, um weitere Hilfe zu erhalten.
Um die Auflösung zu überprüfen, stellen Sie sicher, dass die Nachbearbeitung fehlerfrei abgeschlossen wird und die erwarteten Eigenschaften auf dem jcr:content Knoten der aufgenommenen Dateien vorhanden sind.