Gerenciamento de atualizações de tópico DITA compartilhadas e republicação de mapa afetada no Adobe Experience Manager Guides
Este artigo explica as abordagens disponíveis para identificar e gerenciar mapas DITA afetados quando um tópico compartilhado é atualizado nos Guias do Adobe Experience Manager (AEM), incluindo opções de automação manuais e personalizadas.
Descrição description
Ambiente
- Guias do Adobe Experience Manager (AEM)
Problema/Sintomas
- Quando um tópico DITA compartilhado é reutilizado em vários mapas DITA no AEM Guides, a atualização do tópico não identifica automaticamente todos os mapas afetados.
- A atualização do tópico não aciona automaticamente a regeneração e a republicação dos mapas afetados.
- O painel Referências (Referências
>Usadas em) pode ser usado para exibir relações de referência entre tópicos e mapas. Porém, não há API ou fluxo de trabalho integrado para identificar, regenerar e republicar automaticamente todos os mapas afetados após uma atualização de tópico. - É necessário um desenvolvimento personalizado para obter a automação completa desse cenário.
Resolução resolution
Para identificar e republicar mapas DITA afetados após uma atualização de tópico compartilhado, siga estas etapas:
-
Use o painel Referências no AEM Guides para identificar manualmente todos os mapas DITA que fazem referência a um tópico modificado.
-
Para determinar o status de publicação dos mapas afetados, revise os logs de publicação de cada mapa ou use as APIs disponíveis para verificar o status de publicação.
-
Para automação, implemente um fluxo de trabalho ou manipulador de eventos personalizado no AEM:
a) Configure um ouvinte de back-end (como um OSGi
ResourceChangeListener, uma observação JCR ou um iniciador de fluxo de trabalho) para detectar eventos salvos em tópicos DITA.b) Quando um tópico for atualizado, consulte o repositório para localizar todos os mapas de referência usando os dados de referência.
c) Para cada mapa afetado, acione a geração e a publicação de saída usando as APIs de publicação ou os workflows disponíveis.
d) Implemente a lógica para evitar trabalhos de publicação duplicados ou sobrepostos, por exemplo, verificando filas de trabalhos ou usando identificadores de trabalhos exclusivos.
-
Depois que a automação for implementada, verifique se a atualização de um tópico compartilhado aciona a regeneração e a republicação de todos os mapas afetados, conforme esperado.