Documentazione

Assets non eseguito nella post-elaborazione DXML a causa della memorizzazione nella cache in AEM Guides

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

La post-elaborazione DXML in AEM Guides svolge un ruolo fondamentale nel garantire che i metadati delle risorse, come titoli, stati dei documenti e riferimenti di collegamento, vengano sincronizzati e renderizzati correttamente nell’interfaccia utente. Ciò consente una visualizzazione accurata e una navigazione affidabile all’interno dei contenuti creati. Se le risorse in AEM Guides non vengono elaborate correttamente, ad esempio metadati mancanti, collegamenti ad argomenti interrotti o predefiniti di output incompleti, il problema può essere dovuto ai percorsi memorizzati nella cache nel postprocessore DXML. Questo articolo spiega come identificare i percorsi ignorati nell’archivio e rimuoverli per ripristinare la corretta elaborazione delle risorse e la sincronizzazione dei metadati.

Descrizione description

Ambiente

  • Prodotto: Adobe Experience Manager (AEM) Managed Services
  • Versione: AEM 6.5, Guide 4.0+

Problemi/Sintomi

  • Il campo Titolo nei file DITA non mantiene gli aggiornamenti e torna allo stato precedente dopo l'aggiornamento.
  • Il campo Stato documento è assente nella console Proprietà, ma visibile nel pannello Proprietà file.
  • I file vengono visualizzati come File invece del tipo Argomento previsto in Guide.
  • Gli argomenti aggiunti alle mappe vengono visualizzati in rosso, a indicare i collegamenti interrotti o non disponibili, anziché in blu.
  • I predefiniti di output possono mancare per le mappe appena create se le risorse risiedono in percorsi elencati nel nodo /var/dxml/postprocess/ignoredPaths in CRX/DE. Questi percorsi vengono trattati come esclusi dalla post-elaborazione DXML e il problema può verificarsi in qualsiasi posizione definita in tale nodo.
  • I riferimenti Usati in e Collegamenti in uscita in Proprietà file non vengono aggiornati correttamente.

Risoluzione resolution

La causa principale di questo problema è che i flussi di lavoro di post-elaborazione ignorano percorsi specifici a causa dei percorsi delle risorse memorizzate nella cache. AEM Guides fornisce una configurazione OSGi che consente agli amministratori di specificare quali cartelle escludere dalla post-elaborazione. Vedere Disattivazione della post-elaborazione per una cartella nella documentazione di AEM Guides. Oltre a questa configurazione, l'archivio contiene un nodo in /var/dxml/postprocess/ignoredPaths che funge da cache di percorsi da ignorare. Se una risorsa risiede in uno di questi percorsi, verrà ignorata durante la post-elaborazione DXML e possono essere visualizzati messaggi di registro a livello INFO come i seguenti:

Percorso [POSTELABORAZIONE] ignorato a causa della configurazione della cache
[ POSTELABORAZIONE] Salto post-elaborazione per payload: /content/dam/< path-to-asset>

Passaggi da risolvere

  1. Verificare che i percorsi interessati siano elencati in /var/dxml/postprocess/ignoredPaths in CRX/DE. Passa a questo nodo e controlla le proprietà corrispondenti ai percorsi ignorati. Per i passaggi, fare riferimento a Guida introduttiva a CRXDE Lite nella Guida utente di AEM as a Cloud Service.

  2. Rimuovere le voci non necessarie dal nodo ignoredPaths: mantenere solo /content/dam/projects/translation_output, che è un valore predefinito. Per i passaggi, fare riferimento a Come eliminare proprietà e nodi con cURL nella Guida utente di AEM 6.5. Se POST una proprietà con un valore vuoto in un nodo, AEM eliminerà tale proprietà. Per rimuovere una proprietà da un determinato nodo, utilizza il formato seguente:

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

    Sostituire propertyName con il nome della proprietà che si desidera rimuovere.

    path/to/node deve essere il percorso dell'archivio in cui esiste la proprietà. Se si lascia vuoto il valore dopo il segno di uguale (=), AEM è in grado di eliminare la proprietà specificata.

    Nota: Sarà necessario ripetere il comando per ogni proprietà che si desidera rimuovere dal nodo.

  3. Elimina tutte le altre voci correlate ai percorsi interessati. Oppure elimina solo i percorsi che fanno sì che le risorse interessate vengano ignorate. Per i passaggi, consulta Contenuto Sling nella Guida utente di AEM 6.5.

  4. Esegui nuovamente il flusso di lavoro Aggiorna risorsa DAM su tutte le risorse nei percorsi interessati. Ciò garantisce la generazione di metadati e la corretta elaborazione delle risorse. Per i passaggi, consulta Esecuzione del flusso di lavoro Aggiorna risorsa DAM nell'esercitazione di AEM Assets.

  5. Verifica che:

    1. I titoli persistono dopo gli aggiornamenti.

    2. Il campo Stato documento viene visualizzato correttamente tra le interfacce.

    3. Le icone dei file vengono visualizzate come Argomento.

    4. Gli argomenti vengono visualizzati in blu quando vengono aggiunti alle mappe.

    5. Tutti i predefiniti di output sono disponibili per le nuove mappe.

    6. I riferimenti (utilizzati in, collegamenti in uscita) vengono aggiornati con precisione.

      È possibile fare riferimento a Rapporti in AEM Guides nella documentazione di AEM Guides per sviluppare un elenco di controllo di convalida, verificare gli stati del contenuto, i riferimenti e le proprietà relative all'output tra le risorse e le mappe.

Dopo aver cancellato i percorsi ignorati e rieseguito i flussi di lavoro delle risorse, le risorse e i metadati mancanti in precedenza verranno nuovamente visualizzati e visualizzati correttamente in AEM Guides. I titoli, gli stati dei documenti, i collegamenti e i predefiniti di output verranno aggiornati come previsto, a conferma che l’elaborazione sia ripresa normalmente.

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