DocumentaciónAjuda

Páginas importadas

Reconheça as páginas que chegam do repositório de um produto, entenda por que elas não são editadas no Elion ITSM e confira o relatório de cada importação.

Nesta página

Alguns espaços não são escritos no Elion ITSM: o conteúdo deles chega da documentação de um produto, que fica em arquivos dentro do repositório dele. Toda vez que essa documentação muda, ela é importada para o espaço. Assim a documentação tem uma única fonte e nunca há duas versões diferentes do mesmo texto.

Como reconhecer uma página importada

Ao abrir uma página importada, você verá, acima do conteúdo, o aviso Importada de seguido do caminho do arquivo de origem. O aviso diz que a página é editada no repositório do produto e que, no Elion ITSM, ela fica somente leitura.

Em uma página importada:

  • não aparecem os botões Editar, Subpágina, Mover, Arquivar nem Excluir;

  • se você tentar abrir o editor, verá que a página é importada do arquivo de origem e que aqui ela fica somente leitura;

  • você pode, sim, lê-la, ver o Histórico, usar Copiar link e deixar Comentários se puder editar no espaço. Marcar como resolvido não aparece nessas páginas.

Por que não se edita aqui? Se alguém corrigisse a página no Elion ITSM, a próxima importação traria de novo o texto do repositório e a alteração se perderia. Para corrigir uma página importada, avise a equipe que mantém a documentação do produto. Um comentário na página é uma boa forma de deixar o aviso.

O que cada importação faz

Cada arquivo do repositório corresponde a uma página, e é sempre reconhecido pelo caminho. Em cada importação:

  • um arquivo novo cria uma página e a publica;

  • um arquivo que mudou cria uma versão nova da página e a publica, com a nota Importado no histórico;

  • um arquivo sem alterações não mexe na página;

  • um arquivo que foi apagado arquiva a página, não a exclui. Se o arquivo voltar, a página volta com o mesmo número.

Se um arquivo vier marcado como rascunho no repositório, a página fica como rascunho em vez de ser publicada.

Tudo fica no histórico de cada página, como qualquer outra publicação (veja Histórico e versões).

Ver o relatório das importações

Antes de começar

  • Você precisa de Administrar em Conhecimento (função Administrador).

Passos

  1. Entre no espaço.

  2. Pressione Importações. Abre-se Importações de e o nome do espaço.

  3. Confira a lista. Cada importação mostra:

    • a data e há quanto tempo foi feita;

    • a origem: Terminal, Zip enviado ou GitHub Action;

    • a versão do repositório que foi importada, se foi indicada;

    • o resumo, por exemplo «3 criadas · 1 atualizada · 12 sem alterações». Também informa as arquivadas. Se não houve páginas, diz Sem páginas.

  4. Se a importação teve avisos, pressione avisos (com o número) para vê-los. Cada um indica o arquivo e o que aconteceu.

  5. Pressione Fechar para sair.

Se o espaço nunca recebeu uma importação, você verá Este espaço ainda não tem importações.

O que significam os avisos

Os avisos não interrompem a importação: eles alertam sobre algo que convém corrigir no repositório do produto. Os mais comuns são:

  • um elemento do texto que a base de conhecimento não aceita e que foi omitido;

  • uma imagem que falta ou um link quebrado;

  • um arquivo que foi ignorado porque não é uma página nem uma imagem, ou porque é grande demais.

Confira o relatório depois de cada mudança grande na documentação. Corrigir os avisos no repositório deixa as páginas completas na importação seguinte.

Relacionado

Pesquisar em Elion ITSM

Digite pelo menos 2 letras para pesquisar em Elion ITSM.

↑↓ navegar · Enter abrir · Esc fechar