Quebra de referências de tópico ou mapa DITA devido à propriedade fmPostProcessedAt obsoleta
Ao trabalhar no Adobe Experience Manager as a Cloud Service (AEMaaCS) ou AEM 6.5 com AEM Guides, as referências de Mapa DITA ou Tópico podem parecer corrompidas e as predefinições de saída podem estar ausentes na interface do usuário. Isso geralmente ocorre quando os ativos estão fora de sincronia devido a uma propriedade fmPostProcessedAt obsoleta, geralmente após a implantação ou migração manual. Para resolver o problema, reprocesse os ativos afetados usando o fluxo de trabalho Atualizar ativo do DAM.
Descrição description
Ambiente
- Produto: Adobe Experience Manager (AEM) - Sites
- Versões: AEM 6.5, AEM as a Cloud Service (AEMaaCS)
Problema/Sintomas
-
As referências de tópico do Mapa DITA aparecem quebradas (vermelhas) na interface do usuário do autor após a implantação, mesmo que os tópicos existam no repositório.
-
A geração de PDF ou outra saída falha devido a referências de tópico não resolvidas ou corrompidas.
-
As predefinições de saída recém-criadas desaparecem da interface do usuário do AEM Guides após uma atualização de página ou geração de documentação, mas estão visíveis no CRXDE.
-
O ponto de extremidade
/bin/guides/presetsretorna um erro 500 server para os mapas afetados. -
Os logs de aviso/erro incluem mensagens como:
- Encontrado nó para ref GUID-xxxx.ditamap… mas retornando nulo devido à falta de sincronização
- com.adobe.fmdita.rest.presets.PresetsAPI Erro: {"errorCode":"DXML_MESSAGE_0004"}
- java.lang.NullPointerException…
-
A implantação ou migração manual do pacote de conteúdo DITA entre ambientes faz com que os ativos DITA fiquem fora de sincronia.
Causa
O problema ocorre quando os ativos DITA ficam fora de sincronia, normalmente devido a uma incompatibilidade entre as propriedades jcr:created e fmPostProcessedAt. Essa incompatibilidade impede que a interface do usuário e as APIs do Guides resolvam corretamente as referências de tópico e as predefinições de saída.
Causas comuns desse estado fora de sincronia:
- Migração de conteúdo DITA por meio de pacote ou pipeline sem acionar o pós-processamento.
- Importação ou edição manual de ativos DITA no AEM.
- Fluxo de trabalho de ativos incompleto ou com falha após a implantação.
Resolução resolution
Para resolver o problema, siga estas etapas:
-
Identifique os ativos marcados como fora de sincronização verificando os logs de erros para valores
jcr:createdefmPostProcessedAtincompatíveis. -
Reprocesse os ativos afetados usando o fluxo de trabalho padrão Atualizar ativo do DAM no AEM, que inclui a etapa Iniciador de pós-processamento DXML (
com.adobe.fmdita.postprocess.PostProcessJobInitiator) que garante que o valorfmPostProcessedAtseja atualizado corretamente. -
Crie um workflow personalizado se necessário:
- Configure um novo modelo de fluxo de trabalho no AEM contendo apenas a etapa Iniciador de pós-processamento DXML.
- Execute este workflow no mapa ou tópico afetado para atualizar seu status de sincronização.
-
Verifique se as referências de tópico corrompidas foram resolvidas, se a geração de saída foi concluída com êxito, se as predefinições aparecem corretamente na interface do usuário do AEM Guides e se
/bin/guides/presetsretorna os resultados esperados.
Leitura relacionada
- Use o DITA-OT personalizado e a especialização do DITA no guia do usuário do AEM.
- Reusabilidade do conteúdo DITA no guia do usuário do AEM.