Solução de problemas de erros de publicação
Publicar um mapa geralmente é simples. Abra o mapa, selecione uma Predefinição de saída e gere a saída! No entanto, se um mapa ou seus tópicos apresentarem erros, a geração de saída poderá falhar. Quando isso ocorrer, é importante saber como solucionar os problemas.
Preparação para o exercício
Você pode baixar arquivos de amostra para o exercício aqui.
Causas comuns de erros de publicação
Erros podem ser introduzidos no conteúdo de origem. Por exemplo:
-
Referência de caminho de arquivo com nome incorreto
-
Pasta nomeada incorretamente
-
Gráfico ou arquivo ausente
-
Referência de conteúdo configurada incorretamente
-
Referência cruzada corrompida
-
Erros nos valores de um atributo (por exemplo, uma string em vez de um número)
-
Configuração incorreta de componentes usados por AEM Guides
Impacto dos erros
Um erro pode ser pequeno e resultar em uma observação simples para informar que um arquivo não foi empacotado com êxito ou grave o suficiente para resultar em uma falha completa na geração de saída. A guia Saídas exibe ícones codificados por cor para mostrar sucesso, erros ou falhas relacionados à geração de saída.
Abrir e revisar logs de erros
O arquivo de log gerado pode ser aberto para revisão.
-
Na guia Saídas, clique em data/hora em Gerado às.
-
Percorra o log de erros.
Mostrando e ocultando tipos de erro
O registro de erros exibe cada tipo de erro em uma cor exclusiva.
-
Selecione ou desmarque qualquer tipo de erro para mostrar ou ocultar o realce.
-
Navegar pelos erros usando os botões próximo ou anterior (setas).
Resolução de erros
Dependendo do tipo de erro, a resolução pode ser simples ou complexa. Ela pode ser concluída por um autor no Editor XML ou pode exigir que um administrador trabalhe com AEM Guides. Correções específicas dependem do erro, do impacto e dos workflows organizacionais.
-
Referência de caminho de arquivo com nome incorreto
code language-none Os autores podem atualizar a referência de caminho no documento de origem. -
Pasta nomeada incorretamente
code language-none Os autores podem atualizar o nome da pasta ou mover arquivos conforme necessário. -
Gráfico ou arquivo ausente
code language-none Os autores podem carregar um gráfico/arquivo ausente, renomear um gráfico/arquivo ou mover um gráfico/arquivo -
Referência de conteúdo configurada incorretamente
code language-none Os autores podem corrigir o local do conteúdo referenciado ou alterar o caminho para a referência de conteúdo. -
Referência cruzada corrompida
code language-none Os autores podem corrigir o local para o qual a referência cruzada aponta ou alterar o nome ou as propriedades do arquivo de destino -
Erros nos valores de um atributo (por exemplo, uma string em vez de um número)
code language-none Os autores podem atualizar o atributo para um valor correto ou os administradores podem atualizar o sistema para dar suporte a novos valores. -
Configuração incorreta de componentes usados por AEM Guides
code language-none Os administradores podem atualizar a instalação do sistema, seus componentes ou permissões.