Dokumentation

Assets hoppades över i DXML-efterbearbetning på grund av cachelagring i AEM Guides

Last update: Thu Oct 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

DXML-efterbearbetning i AEM Guides spelar en viktig roll när det gäller att säkerställa att metadata för resurser - som titlar, dokumenttillstånd och länkar - synkroniseras och återges korrekt i hela användargränssnittet. På så sätt kan du visa korrekt och navigera i redigerat innehåll på ett tillförlitligt sätt. Om resurser i AEM Guides inte bearbetas korrekt, t.ex. saknade metadata, brutna ämneslänkar eller ofullständiga utdatainställningar, kan problemet bero på cachelagrade sökvägar i DXML-efterbearbetaren. I den här artikeln beskrivs hur du identifierar ignorerade sökvägar i databasen och tar bort dem för att återställa korrekt bearbetning av resurser och synkronisering av metadata.

Beskrivning description

Miljö

  • Produkt: Adobe Experience Manager (AEM) Managed Services
  • Version: AEM 6.5, Guides 4.0+

Problem/symtom

  • Fältet Titel i DITA-filer behåller inte uppdateringar och återgår till det tidigare läget efter uppdateringen.
  • Fältet Dokumenttillstånd saknas i egenskapskonsolen men visas i panelen Filegenskaper.
  • Filerna visas som Arkiv i stället för som den förväntade Ämne-typen i guider.
  • Ämnen som läggs till på kartor visas i rött, vilket anger brutna eller otillgängliga länkar, i stället för blått.
  • Utdatainställningar kan saknas för nyligen skapade kartor om resurserna finns i sökvägar som listas under noden /var/dxml/postprocess/ignoredPaths i CRX/DE. Dessa sökvägar behandlas som undantagna från DXML-efterbearbetning och problemet kan uppstå på alla platser som definieras i den noden.
  • Referenserna som används i och utgående länkar under filegenskaper uppdateras inte korrekt.

Upplösning resolution

Orsaken till problemet är att efterbearbetningsarbetsflöden ignorerar specifika sökvägar på grund av cachelagrade resurssökvägar. AEM Guides har en OSGi-konfiguration som gör att administratörer kan ange vilka mappar som ska uteslutas från efterbearbetning - se Inaktivera efterbearbetning för en mapp i AEM Guides-dokumentationen. Utöver den här konfigurationen innehåller databasen en nod på /var/dxml/postprocess/ignoredPaths som fungerar som ett cacheminne med sökvägar som ska hoppas över. Om en resurs finns på någon av dessa sökvägar ignoreras den under DXML-efterbearbetningen och loggmeddelanden på INFO-nivå som följande kan visas:

[POSTPROCESSING] Sökvägen ignorerades på grund av cachekonfigurationen
[ POSTPROCESSING ] Hoppar över efterbearbetning för nyttolast: /content/dam/< path-to-asset>

Steg att lösa

  1. Kontrollera att de berörda sökvägarna listas under /var/dxml/postprocess/ignoredPaths i CRX/DE. Navigera till den här noden och sök efter egenskaper som motsvarar ignorerade sökvägar. Anvisningar finns i Komma igång med CRXDE Lite i AEM as a Cloud Service användarhandbok.

  2. Ta bort onödiga poster från noden ignoredPaths: Behåll bara /content/dam/projects/translation_output, som är ett standardvärde. Anvisningar finns i Ta bort egenskaper och noder med cURL i användarhandboken för AEM 6.5. Om du POST en egenskap med ett tomt värde för en nod, kommer AEM att ta bort den egenskapen. Använd följande format om du vill ta bort en egenskap från en viss nod:

    code language-none 
    curl -u 'userId:password' \
-F "propertyName=" \
http://localhost:4502/path/to/node

    propertyName ska ersättas med namnet på egenskapen som du vill ta bort.

    path/to/node ska vara databassökvägen där egenskapen finns. Om du lämnar värdet efter likhetstecknet (=) tomt kommer AEM att ta bort den angivna egenskapen.

    Obs!: Du måste upprepa kommandot för varje egenskap som du vill ta bort från noden.

  3. Ta bort alla andra poster som är relaterade till påverkade banor. Eller ta bara bort de sökvägar som gör att de berörda resurserna ignoreras. Anvisningar finns i Sling-innehåll i användarhandboken för AEM 6.5.

  4. Kör om arbetsflödet för DAM-uppdatering av tillgångar på alla resurser under de berörda sökvägarna. Detta garanterar generering av metadata och korrekt bearbetning av resurser. Anvisningar finns i Köra arbetsflöde för DAM-uppdatering i AEM Assets självstudiekurs.

  5. Verifiera att:

    1. Titlarna finns kvar efter uppdateringar.

    2. Fältet Dokumenttillstånd visas korrekt i alla gränssnitt.

    3. Filikoner visas som ämne.

    4. Ämnen visas i blått när de läggs till på kartor.

    5. Alla förinställningar för utdata är tillgängliga för nya kartor.

    6. Referenser (Används i, Utgående länkar) uppdateras korrekt.

      Du kan referera till Rapporter i AEM Guides i AEM Guides-dokumentationen om du vill utveckla en kontrollista för validering, verifiera innehållslägen, referenser och utdatarelaterade egenskaper för resurser och kartor.

När du har rensat de ignorerade sökvägarna och kört om arbetsflödena för resurser, visas de resurser och metadata som saknas tidigare och visas korrekt i AEM Guides. Titlar, dokumentlägen, länkar och förinställningar för utdata uppdateras som förväntat, vilket bekräftar att bearbetningen har återupptagits normalt.

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