Documentação

Assets ignorado no pós-processamento DXML devido ao armazenamento em cache no AEM Guides

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

O pós-processamento DXML no AEM Guides desempenha um papel essencial para garantir que os metadados de ativos — como títulos, estados de documentos e referências de vinculação — sejam sincronizados e renderizados corretamente na interface do usuário. Isso permite uma exibição precisa e uma navegação confiável no conteúdo criado. Se os ativos no AEM Guides não estiverem sendo processados corretamente (como metadados ausentes, links de tópicos quebrados ou predefinições de saída incompletas), o problema poderá surgir de caminhos em cache no pós-processador DXML. Este artigo explica como identificar caminhos ignorados no repositório e removê-los para restaurar o processamento adequado de ativos e a sincronização de metadados.

Descrição description

Ambiente

  • Produto: Adobe Experience Manager (AEM) Managed Services
  • Versão: AEM 6.5, Guides 4.0+

Problemas/Sintomas

  • O campo Título nos arquivos DITA não retém atualizações e reverte para seu estado anterior após a atualização.
  • O campo Estado do Documento está ausente no console Propriedades, mas é visível no painel Propriedades do Arquivo.
  • Os arquivos aparecem como Arquivo em vez do tipo esperado Tópico nos Guias.
  • Os tópicos adicionados aos mapas são exibidos em vermelho, indicando links quebrados ou indisponíveis, em vez de azul.
  • As predefinições de saída podem estar ausentes para mapas recém-criados se os ativos residirem em caminhos que estão listados no nó /var/dxml/postprocess/ignoredPaths no CRX/DE. Esses caminhos são tratados como excluídos do pós-processamento DXML e o problema pode ocorrer em qualquer local definido nesse nó.
  • As referências Usado em e Links de Saída em Propriedades do arquivo não são atualizadas corretamente.

Resolução resolution

A causa raiz desse problema é que os fluxos de trabalho de pós-processamento ignoram caminhos específicos devido a caminhos de ativos em cache. O AEM Guides fornece uma configuração OSGi que permite aos administradores especificar quais pastas devem ser excluídas do pós-processamento — consulte Desabilitar pós-processamento para uma pasta na Documentação do AEM Guides. Além dessa configuração, o repositório contém um nó em /var/dxml/postprocess/ignoredPaths que atua como um cache de caminhos a serem ignorados. Se um ativo residir em um desses caminhos, ele será ignorado durante o pós-processamento de DXML e mensagens de log no nível INFO, como as seguintes, poderão ser exibidas:

[PÓS-PROCESSAMENTO] Caminho ignorado devido à configuração do cache
[ POSTPROCESSING] Ignorando pós-processamento para carga: /content/dam/< path-to-asset>

Etapas a serem Resolvidas

  1. Verifique se os caminhos afetados estão listados em /var/dxml/postprocess/ignoredPaths no CRX/DE. Navegue até esse nó e verifique as propriedades correspondentes aos caminhos ignorados. Para ver as etapas, consulte Introdução ao CRXDE Lite no Guia do Usuário do AEM as a Cloud Service.

  2. Remover entradas desnecessárias do nó ignoredPaths: Reter somente /content/dam/projects/translation_output, que é um valor padrão. Para obter etapas, consulte Como excluir propriedades e nós com cURL no Guia do Usuário do AEM 6.5. Se você POST uma propriedade com um valor vazio para um nó, o AEM excluirá essa propriedade. Para remover uma propriedade de um determinado nó, use o seguinte formato:

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

    propertyName deve ser substituído pelo nome da propriedade que você deseja remover.

    path/to/node deve ser o caminho do repositório onde a propriedade existe. Deixar o valor após o sinal de igual (=) em branco instrui o AEM a excluir a propriedade especificada.

    Observação: será necessário repetir o comando para cada propriedade que você deseja remover do nó.

  3. Exclua todas as outras entradas relacionadas aos caminhos afetados. Ou exclua somente os caminhos que fazem com que os ativos afetados sejam ignorados. Para ver as etapas, consulte Conteúdo do Sling no Guia do Usuário do AEM 6.5.

  4. Execute novamente o fluxo de trabalho Atualizar ativo do DAM em todos os ativos nos caminhos afetados. Isso garante a geração de metadados e o processamento adequado de ativos. Para ver as etapas, consulte Execução do fluxo de trabalho do ativo de atualização do DAM no tutorial do AEM Assets.

  5. Validar que:

    1. Os títulos persistem após as atualizações.

    2. O campo Estado do Documento aparece corretamente nas interfaces.

    3. Os ícones de arquivo são exibidos como Tópico.

    4. Os tópicos aparecem em azul quando adicionados aos mapas.

    5. Todas as predefinições de saída estão disponíveis para novos mapas.

    6. As Referências (Usadas Em, Links de Saída) são atualizadas com precisão.

      Você pode consultar Relatórios no AEM Guides na Documentação da AEM Guides para desenvolver uma lista de verificação de validação, verificar estados de conteúdo, referências e propriedades relacionadas à saída em ativos e mapas.

Depois de limpar os caminhos ignorados e executar novamente os fluxos de trabalho de ativos, os ativos e metadados ausentes anteriormente reaparecerão e serão exibidos corretamente no AEM Guides. Títulos, estados dos documentos, links e predefinições de saída serão atualizados conforme esperado, confirmando que o processamento foi retomado normalmente.

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