DITA-Zuordnung oder Topic-Verweise werden aufgrund der veralteten fmPostProcessedAt-Eigenschaft beschädigt

Last update: Wed Jul 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Bei der Arbeit in Adobe Experience Manager as a Cloud Service (AEMaaCS) oder AEM 6.5 mit AEM Guides können DITA-Map- oder Themenverweise beschädigt erscheinen, und Ausgabevorgaben fehlen möglicherweise in der Benutzeroberfläche. Dies tritt in der Regel auf, wenn Assets aufgrund einer veralteten fmPostProcessedAt-Eigenschaft nicht mehr synchronisiert sind - häufig nach manueller Bereitstellung oder Migration. Um das Problem zu beheben, verarbeiten Sie die betroffenen Assets erneut mit dem Workflow DAM-Update-Asset .

Beschreibung description

Umgebung

Product: Adobe Experience Manager (AEM) - Sites
Versionen: AEM 6.5, AEM as a Cloud Service (AEMaaCS)

Problem/Symptome

Nach der Bereitstellung erscheinen DITA Map-Themenverweise in der Autoren-Benutzeroberfläche beschädigt (rot), obwohl die Themen im Repository vorhanden sind.
Die Generierung von PDF oder anderen Ausgaben schlägt aufgrund nicht aufgelöster oder fehlerhafter Themenverweise fehl.
Neu erstellte Ausgabevorgaben verschwinden nach einer Seitenaktualisierung oder Dokumentationserstellung von der AEM Guides-Benutzeroberfläche, sind jedoch in CRXDE sichtbar.
/bin/guides/presets Endpunkt gibt einen 500-Server Fehler für betroffene Zuordnungen zurück.
Warn-/Fehlerprotokolle enthalten Meldungen wie:
- Knoten für ref GUID-xxxx.ditamap… gefunden, aber aufgrund von Nicht-Synchronisierung wird null zurückgegeben
- com.adobe.fmdita.rest.presets.PresetsAPI Fehler: {„errorCode“:„DXML_MESSAGE_0004“}
- java.lang.NullPointerException…
Die manuelle Bereitstellung oder Migration von DITA-Inhaltspaketen zwischen Umgebungen führt dazu, dass DITA-Assets nicht mehr synchronisiert sind.

Ursache

Das Problem tritt auf, wenn DITA-Assets nicht mehr synchronisiert sind, normalerweise aufgrund einer Diskrepanz zwischen den jcr:created- und fmPostProcessedAt. Diese Diskrepanz verhindert, dass die Guides-Benutzeroberfläche und APIs Themenreferenzen und Ausgabevorgaben korrekt auflösen.

Häufige Ursachen für diesen nicht synchronisierten Status sind:

Migration von DITA-Inhalten über Paket oder Pipeline ohne Auslösen der Nachbearbeitung.
Manuelles Importieren oder Bearbeiten von DITA-Assets in AEM.
Unvollständige oder fehlgeschlagene Asset-Workflow-Verarbeitung nach der Bereitstellung.

Auflösung resolution

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