Se você costuma compartilhar links dos diferentes tipos de documentação que temos no Centro de Aprendizagem, essa dica é para você!
Ao tentar acessar uma dica, o Centro de Aprendizagem já te retornou essa mensagem:
Entendendo o problema:
A plataforma do Ajuda, tentou encontrar a dica/página, porém sem sucesso.
Sabe aquele momento em que após criarmos e validarmos uma dica ou página no ajuda, queremos compartilhar o link em algum material, com suporte ou até mesmo com o DSN para que eles façam o link em alguma tela do sistema?
Nessa hora qual link você compartilha?
Veja um exemplo na Base de Conhecimento do Shop, na área SPED:
(Link anterior: https://ajuda.alterdata.com.br/shopbase/geracao-sped/bloco-k-como-gerar-pelo-exportacao-sped-icms-ipi)
(Link atual: https://ajuda.alterdata.com.br/shopbase/bloco-k-como-gerar-pelo-exportacao-sped-icms-ipi-37260521.html)
Perceba na estrutura do Link anterior que tempos shopbase (que é a chave do espaço dessa Base de Conhecimento) /geracao-sped (que era a descrição da página pai).
Sim, era "Geração SPED", mas atualmente a descrição da página pai é apenas "SPED":
Se você ir à área anônima e copiar a estrutura de link que o próprio navegador apresenta ao acessar uma dica, então você se arrisca ter problemas no link.
Quais as razões para o problema ocorrer?
Podemos alistar pelo menos duas razões:
Sabe quando alguém cria em uma Base de Conhecimento uma dica na área de "Ordem de Serviço" quando, na verdade, devia estar na área "Orçamento"? 
Geralmente reposicionamos a dica para o local correto.
Esse reposicionamento altera essa estrutura de link que a área anônima apresenta, particularmente vou chamar essa estrutura de link de "Endereço atual" da dica 
.
Outro motivo é quando alteramos a descrição da dica ou da página pai onde a dica se encontra.
No link que estamos analisando foi isso que aconteceu, era "Geração SPED", mas atualmente apenas "SPED".
Quando reposicionamos de uma página pai para outra ou alteramos a descrição da dica, ou de uma página pai, nós estamos como que mudando a dica de "endereço".
Como evitar que esse problema ocorra?
Sim, podemos evitar que quebras de link ocorram, se compartilharmos o link correto.
Compartilhando o link permanente, ou link curto.
Eu vou chamar ele de "Identidade da dica" .
Para pegar esse link, siga os passos:
- Logue no Centro de Aprendizagem.
- Acesse a dica cujo link você precisa.
- No canto superior direito, clique em Partilhar e copie e link.
Com esse link mesmo que você reordene a dica de local dentro do espaço, não haverá quebra de link.
O link permanente, ou seja, a "Identidade" da dica que utilizamos como base, por exemplo, é: https://ajuda.alterdata.com.br/x/6Iw4Ag esse é o link correto que deve ser compartilhado.
Mas e nos espaços dos manuais dos sistemas?
Bom, como nos espaços de manuais trabalhamos como um controle de versionamento, o link a ser compartilhado é o Permalink da página. E esse link que o Desenvolvimento precisa vincular nos botões de ajuda dos sistemas e não pegar o link via navegador em visualização anônima da página.
Quando o link é compartilhado dessa forma errada, ocorre o suporte ou o próprio cliente conhece bem: quebra de link. Isso é muito ruim, pois desestimula o usuário de buscar informações no Centro de Aprendizagem.
Para localizar ou manipular esse link, siga os passos:
- Logue no Centro de Aprendizagem.
O Permalink dever ser pego sempre em modo de edição.
- Acesse a página cujo link você precisa.
- Edite a página.
- Logo abaixo do título da página, copie o Permalink.
Geralmente esse link estará habilitado nos espaços dos manuais dos sistemas, aqueles onde estão documentadas cada funcionalidade dos sistemas (botões: Novo, Editar, Opções...).
Você pode alterar esse Permalink?
Sim, principalmente quando há caracteres especiais no título do texto, o que dificulta a identificação da página que corresponde ao link.
Exemplo: Digamos que o nome da página seja "Funções Administrativas", o Confluence pode sugerir como Permalink: https://ajuda.alterdata.com.br/display/SLD/Fun%C3%A7%C3%B5es+Administrativas.
Para deixar o link mais intuitivo, basta clicar sobre ele e remover os caracteres especiais, ou acentuações, ou seja, informe: "Funcoes Administrativas" e link fica algo como: https://ajuda.alterdata.com.br/display/SLD/Funcoes+Administrativas.
Mas atenção: Se o link anterior já estiver linkado no sistema ou algum outro material, esse link precisa ser atualizado no sistema ou material. Por isso, o recomentado é: se no espaço onde você estiver criando uma página estiver com o Permalink habilitado, defina já no momento da criação da página como o Permalink da página será. - Compartilhe esse link com seu público alvo (DSN, Suporte, Cliente...).