Dokumentation

DITA Map- eller ämnesreferenser bryts på grund av inaktuell fmPostProcsedAt-egenskap

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

När du arbetar i Adobe Experience Manager as a Cloud Service (AEMaaCS) eller AEM 6.5 med AEM Guides kan DITA Map- eller ämnesreferenser se trasiga ut, och förinställningar för utdata kan saknas i användargränssnittet. Detta inträffar vanligtvis när resurser inte är synkroniserade på grund av en inaktuell fmPostProcessedAt-egenskap, ofta efter manuell distribution eller migrering. Du löser problemet genom att bearbeta om de berörda resurserna med hjälp av arbetsflödet DAM-uppdatering.

Beskrivning description

Miljö

  • Produkt: Adobe Experience Manager (AEM) - Webbplatser
  • Versioner: AEM 6.5, AEM as a Cloud Service (AEMaaCS)

Problem/symtom

  • DITA Map-ämnesreferenser visas som brutna (röda) i författargränssnittet efter distributionen, även om ämnena finns i databasen.

  • Det går inte att generera PDF eller andra utdata på grund av olösta eller brutna ämnesreferenser.

  • Förinställningar för nya utdata försvinner från AEM Guides-gränssnittet efter en siduppdatering eller dokumentationsgenerering, men visas i CRXDE.

  • /bin/guides/presets-slutpunkten returnerar ett 500 server-fel för påverkade kartor.

  • Varnings-/felloggarna innehåller meddelanden som:

    • En nod för ref-GUID-xxxx.ditamap hittades… men returnerade null på grund av osynkroniserad
    • com.adobe.fmdita.rest.presets.PresetsAPI-fel: {"errorCode":"DXML_MESSAGE_0004"}
    • java.lang.NullPointerException…

  • Manuell distribution eller migrering av DITA-innehållspaket mellan miljöer gör att DITA-resurser blir osynkroniserade.

Orsak

Problemet inträffar när DITA-resurser inte är synkroniserade, vanligtvis på grund av en felmatchning mellan egenskaperna jcr:created och fmPostProcessedAt. Denna felmatchning förhindrar att stödlinjernas användargränssnitt och API:er löser ämnesreferenser och utdatainställningar på rätt sätt.

Vanliga orsaker till det här osynkroniserade läget är:

  • Migrering av DITA-innehåll via paket eller pipeline utan att utlösa efterbearbetning.
  • Manuell import eller redigering av DITA-resurser i AEM.
  • Ofullständig eller misslyckad bearbetning av resursarbetsflöde efter distribution.

Upplösning resolution

Så här löser du problemet:

  1. Identifiera resurser som markerats som osynkroniserade genom att kontrollera om det finns felaktiga värden för jcr:created och fmPostProcessedAt i felloggarna.

  2. Bearbeta de berörda resurserna på nytt med hjälp av DAM-uppdateringsarbetsflödet i AEM, som inkluderar steget DXML Post Process Initiator (com.adobe.fmdita.postprocess.PostProcessJobInitiator) som ser till att värdet fmPostProcessedAt uppdateras korrekt.

  3. Skapa ett anpassat arbetsflöde om det behövs:

    • Konfigurera en ny arbetsflödesmodell i AEM som endast innehåller steget DXML Post Process Initiator.
    • Kör det här arbetsflödet på den berörda kartan eller avsnittet för att uppdatera synkroniseringsstatusen.

  4. Kontrollera att brutna ämnesreferenser är lösta, att utdatagenereringen har slutförts, att förinställningarna visas korrekt i AEM Guides-gränssnittet och att /bin/guides/presets returnerar det förväntade resultatet.

Relaterad läsning

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f