Administración de actualizaciones de temas DITA compartidos y republicación de mapas afectada en Adobe Experience Manager Guides
En este artículo se explican los enfoques disponibles para identificar y administrar los mapas DITA afectados por la actualización de un tema compartido en las guías de Adobe Experience Manager (AEM), incluidas las opciones de automatización manuales y personalizadas.
Descripción description
Entorno
- Guías de Adobe Experience Manager (AEM)
Problema/Síntomas
- Cuando se reutiliza un tema DITA compartido en varias asignaciones DITA de AEM Guides, al actualizar el tema no se identifican automáticamente todas las asignaciones afectadas.
- La actualización del tema no almacena automáticamente en déclencheur la regeneración y republicación de los mapas afectados.
- El panel Referencias (Referencias
>utilizadas en) se puede usar para ver las relaciones de referencia entre temas y mapas. Sin embargo, no hay ninguna API o flujo de trabajo integrado para identificar, regenerar y volver a publicar automáticamente todos los mapas afectados después de una actualización de tema. - Se requiere desarrollo personalizado para lograr la automatización completa en este escenario.
Resolución resolution
Para identificar y volver a publicar las asignaciones DITA afectadas después de una actualización de tema compartido, siga estos pasos:
-
Utilice el panel Referencias (References) de AEM Guides para identificar manualmente todas las asignaciones DITA que hacen referencia a un tema modificado.
-
Para determinar el estado de publicación de los mapas afectados, revise los registros de publicación de cada mapa o utilice las API disponibles para comprobar el estado de publicación.
-
Para lograr una mayor automatización, implemente un flujo de trabajo o controlador de eventos personalizado en AEM:
a. Configure un oyente back-end (como un OSGi
ResourceChangeListener, una observación JCR o un lanzador de flujo de trabajo) para detectar eventos guardados en temas DITA.b. Cuando se actualice un tema, consulte el repositorio para buscar todos los mapas de referencia utilizando los datos de referencia.
c. Para cada mapa afectado, déclencheur la generación y publicación de resultados mediante las API de publicación o los flujos de trabajo disponibles.
d. Implemente una lógica para evitar trabajos de publicación duplicados o superpuestos, por ejemplo, comprobando las colas de trabajos o utilizando identificadores de trabajo únicos.
-
Una vez implementada la automatización, compruebe que la actualización de un tema compartido tenga el déclencheur de volver a generar y publicar todos los mapas afectados según lo esperado.