Documentación

Las referencias de tema o mapa DITA se rompen debido a la propiedad fmPostProcessedAt obsoleta

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

Al trabajar en Adobe Experience Manager as a Cloud Service (AEMaaCS) o AEM 6.5 con AEM Guides, las referencias a temas o mapas DITA pueden aparecer rotas y es posible que falten ajustes preestablecidos de salida en la interfaz de usuario. Esto suele ocurrir cuando los recursos no están sincronizados debido a una propiedad fmPostProcessedAt obsoleta, a menudo después de una implementación manual o una migración. Para resolver el problema, vuelva a procesar los recursos afectados mediante el flujo de trabajo de recursos de actualización de DAM.

Descripción description

Entorno

  • Producto: Adobe Experience Manager (AEM) - Sitios
  • Versiones: AEM 6.5, AEM as a Cloud Service (AEMaaCS)

Problema/Síntomas

  • Las referencias de temas de DITA Map aparecen rotas (rojas) en la interfaz de usuario del autor después de la implementación, aunque los temas existan en el repositorio.

  • PDF u otra generación de salida falla debido a referencias de temas no resueltas o rotas.

  • Los ajustes preestablecidos de salida recién creados desaparecen de la interfaz de usuario de AEM Guides después de una actualización de página o una generación de documentación, pero son visibles en CRXDE.

  • El extremo /bin/guides/presets devuelve un error 500 server para los mapas afectados.

  • Los registros de advertencia/error incluyen mensajes como:

    • Se encontró un nodo para el GUID-xxxx.ditamap de referencia… pero devolviendo un valor nulo debido a que no está sincronizado
    • com.adobe.fmdita.rest.presets.PresetsAPI Error: {"errorCode":"DXML_MESSAGE_0004"}
    • java.lang.NullPointerException…

  • La implementación manual del paquete de contenido DITA o la migración entre entornos hacen que los recursos DITA no estén sincronizados.

Causa

El problema se produce cuando los recursos DITA no están sincronizados, normalmente debido a una discrepancia entre las propiedades jcr:created y fmPostProcessedAt. Esta discrepancia evita que la IU y las API de las guías resuelvan correctamente las referencias de temas y los ajustes preestablecidos de salida.

Las causas comunes de este estado fuera de sincronización incluyen:

  • Migración de contenido DITA mediante paquete o canalización sin activar el posprocesamiento.
  • Importación o edición manual de recursos DITA en AEM.
  • Procesamiento de flujo de trabajo de recursos incompleto o fallido después de la implementación.

Resolución resolution

Para resolver el problema, siga estos pasos:

  1. Identifique los recursos marcados fuera de sincronización comprobando los registros de errores para los valores jcr:created y fmPostProcessedAtque no coinciden.

  2. Vuelva a procesar los recursos afectados mediante el flujo de trabajo de recursos de actualización DAM estándar en AEM, que incluye el paso del iniciador de procesamiento posterior DXML (com.adobe.fmdita.postprocess.PostProcessJobInitiator) que garantiza que el valor fmPostProcessedAt se actualice correctamente.

  3. Cree un flujo de trabajo personalizado si es necesario:

    • Configure un nuevo modelo de flujo de trabajo en AEM que contenga solamente el paso Iniciador de procesamiento posterior DXML.
    • Ejecute este flujo de trabajo en el mapa o tema afectado para actualizar su estado de sincronización.

  4. Compruebe que las referencias de temas interrumpidos se hayan resuelto, que la generación de resultados se haya completado correctamente, que los ajustes preestablecidos aparezcan correctamente en la interfaz de usuario de AEM Guides y que /bin/guides/presets devuelva los resultados esperados.

Lectura relacionada

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