Trabalho com relatórios

A guia Relatórios no Painel do mapa permite identificar e resolver links com falha, conteúdo referenciado e reutilizado (conrefs), referências cruzadas ou outras informações ausentes.

Preparação para o exercício

Você pode baixar arquivos de amostra para o exercício aqui.

Download de exercício

Upload do Assets

  1. Na Exibição de repositório, selecione o ícone de Reticências na pasta principal para abrir o menu Opções.

    reticências-9.png

  2. Selecione Carregar Assets.

    upload-assets.png

  3. Selecione os arquivos que você deseja carregar na pasta e selecione Carregar.

Os arquivos DITA são abertos e você deve analisá-los quanto a problemas com conteúdo ausente, conrefs ou referências cruzadas.

Criação de um mapa

  1. Selecione o ícone de Reticências na pasta principal para abrir o menu Opções.

    reticências-9.png

  2. Selecione Criar > Mapear.

    create-map.png

    A caixa de diálogo Criar novo mapa é exibida.

  3. No campo Modelo, selecione Bookmap (ou Mapa com base no tipo de conteúdo que você está criando) no menu suspenso e atribua um título ao seu mapa.

  4. Selecione Criar.

Seu mapa é criado e o painel esquerdo muda automaticamente da exibição Repositório para a exibição Mapa.

Inserção de componentes do mapa

  1. Selecione o ícone de lápis no painel esquerdo.
    Este é o ícone Editar, e permite que você abra o mapa no editor.

    edit-map.png

  2. Volte para a visualização Repositório selecionando o ícone Repositório.

    repository-button.png

  3. Adicione um tópico ao mapa, arrastando-o e soltando-o do Repository (Repositório) no mapa no editor.
    O indicador de linha mostrará onde o tópico será colocado.

  4. Continue a adicionar tópicos, conforme necessário.

  5. Quando terminar, selecione Salvar como nova versão.

    salvar como nova versão.png

  6. No campo Comentários da nova Versão, insira um comentário descritivo.

  7. Selecione Salvar.

Gerar uma saída do site AEM

  1. No Repositório, selecione o ícone de Reticências no mapa para abrir o menu Opções e Abrir Painel de Mapa.

    open-map-dashboard.png

    O Painel do mapa é aberto em outra guia.

  2. Na guia Predefinições de saída, selecione Site AEM.

    aem-site-checkbox

  3. Selecione Gerar.

  4. Navegue até a página Saídas para visualizar o status das saídas geradas.
    Se houver erros, a guia Saídas pode exibir um círculo laranja na coluna Configuração de geração, em vez de verde, indicando que a geração foi concluída.

  5. Selecione o link na coluna Configuração de Geração para abrir a saída gerada.
    Revise a saída em busca de conteúdo ausente.

A guia Relatórios

A guia Relatórios exibe um resumo de tópico e uma tabela contendo informações sobre o tópico e os problemas do mapa.

Idealmente, você sempre deve verificar os Relatórios em busca de um mapa após importar o conteúdo.

reports.png

A coluna Missing Elements indica o número de imagens ausentes e conrefs quebrados. Você pode selecionar o ícone Lápis para abrir o tópico no editor.

Resolução de imagens ausentes

Se as imagens estiverem ausentes em seus arquivos, uma causa comum pode ser o conteúdo ter sido carregado, mas as imagens não. Em caso afirmativo, resolva os problemas de imagem ausente fazendo upload de imagens em uma pasta específica que corresponda ao caminho e aos nomes de arquivo esperados pelos arquivos.

  1. Em Exibição do Repositório, selecione o ícone de Reticências na pasta de imagens para abrir o menu Opções.

    reticências-imagem.png

  2. Selecione Carregar Assets e selecione as imagens ausentes.

  3. Selecione Carregar.

As imagens ausentes foram carregadas. Agora, uma saída de site AEM recém-gerada exibirá essas imagens, e a guia Relatórios não exibirá mais erros de imagem ausentes.

Resolvendo conrefs com falha

Se o conteúdo referenciado em outro lugar (um conref) for vinculado a para um arquivo em outra pasta (por exemplo, um chamado "reutilizar"). e o conteúdo não for carregado, um erro deverá ser resolvido. Por exemplo, você deve criar uma subpasta chamada "reutilizar" e fazer upload do arquivo ausente para "reutilizar".

Carregando um ativo com a interface de usuário do Assets

Além da opção Carregar Assets, você pode carregar ativos arrastando e soltando na interface do usuário do Assets.

  1. Na Exibição de repositório, selecione o ícone de Reticências na pasta reutilizar para abrir o menu Opções.

    reuse-ellipsis.png

  2. Selecione Exibir na Interface do Usuário do Assets.

    assets_ui.png

  3. Arraste e solte o arquivo na pasta.
    O arquivo é carregado e o erro conref é resolvido.

Todos os erros foram resolvidos. A página Relatórios indicará que não há mais erros e a geração de um site AEM resultará em uma saída completa sem componentes ausentes.

recommendation-more-help
5d77304e-09c3-49ad-9381-b66e7cbd5f86