Planos compatíveis com este recurso: Business Enterprise
O status dos links é um subrecurso na seção de Análise do Document360. Esse recurso é um verificador de links quebrados que ajuda a validar e monitorar todos os links internos, externos e de arquivos de mídia na base de conhecimento. Ele permite corrigir links ruins/quebrados para melhorar a Otimização para Mecanismos de Busca (SEO) e aprimorar a experiência do leitor.
Com as validações a seguir, você pode executar a validação do link em nível de workspace e linguagem.
Validação programada
Validação manual
Validação em nível de artigo
NOTA
Para validação manual e agendada, todos os links no nível do projeto são analisados para verificar se há links quebrados, desconhecidos ou funcionando.
Acessando a página de análise de status do Links
Para visualizar a análise de status do Link no portal da Base de Conhecimento,
Navegue até Analytics () na barra de navegação da esquerda no portal da Base de Conhecimento.
No painel de navegação esquerdo, clique em status do link.
Página de visão geral do status dos links
Esta página contém todos os dados necessários sobre os links usados na sua base de conhecimento (espaço de trabalho e idioma selecionados). A página possui duas seções: blocos de status de Links e Lista de Links.
1. Blocos de status de links
Classificação dos links
Campo | Descrição |
|---|---|
Links totais | O número total de URLs e arquivos (internos e externos) vinculados nos diferentes artigos da sua base de conhecimento. |
Interno | O número total de URLs Internas, incluindo links de artigos e arquivos de mídia, dentro do seu projeto Document360. |
Externo | O número total de URLs externas, incluindo links de artigos e arquivos de mídia, fora do seu projeto Document360. |
Ignorado | Os links que você quer ignorar na validação atual ou na validação que está por vir. |
Estado atual
Campo | Descrição |
|---|---|
URL de redirecionamento | Quando o link foi temporária ou permanentemente roteado para uma URL diferente. |
Trabalhando | O link funciona bem e aponta para uma página ou arquivo pretendido (interno e externo). |
Quebrado | Um link quebrado ou morto é um hiperlink no artigo que não funciona mais porque está enfrentando um ou mais problemas, como alterações de URL, URL incorreta, remoção de página ou item, ou URL de artigo de base de conhecimento restrita/privada. Status quebrado se aplica a URLs e arquivos de mídia. |
Desconhecido | O link que não retorna um status. |
Link/imagem quebrada
Quando um link quebrado ou um arquivo de imagem é acessado:
Link – Quando o leitor clica em um link quebrado, um erro de 404 páginas ou uma mensagem semelhante é exibido, indicando que a página está indisponível.
Arquivos de mídia — Se uma imagem ou arquivo de vídeo for incluído no artigo, um ícone de miniatura de imagem quebrada o substituirá.
2. Lista de links
A lista de todos os links usados em todo o espaço de trabalho é exibida abaixo da seção de status Links. As informações a seguir sobre os links utilizados estão disponíveis.
Campo | Descrição |
|---|---|
Nome do artigo | O nome do artigo na base de conhecimento que contém o link. Passe o mouse sobre o título de um artigo e clique em Abrir editor na nova aba () para abrir o artigo no portal da Base de Conhecimento. |
Tipo de ligação | Links: Link interno, Link externo, Link seguro, Link não seguro |
URL | O link real da web (URL de destino) |
URL de redirecionamento | Se o caminho de origem existente foi redirecionado para um novo destino. |
Status | Indicando o status do link. Funcionando, quebrado, redirecionado ou ignorado. |
NOTA
Se você excluiu um artigo após a validação e o relatório foi gerado, o artigo fica descarregado. Um ícone de lixo aparece ao lado do nome do artigo.
Filtros para lista de Links
O botão Filtro no topo da seção de Links é útil quando você tem mais links. Você pode filtrar links com base em quatro parâmetros: Fonte, Visibilidade, Tipo de Link e Status.
Depois de selecionar o filtro, clique em Aplicar.
Você também pode aplicar filtros diretamente clicando no bloco de status do Link que prefere visualizar. Por exemplo, quando você clica no bloco de status de link Quebrado ou Externo , os links com o tipo ou status do link são exibidos na lista.
Links de exportação listam dados analíticos
Na página de status dos Links , clique em Exportar CSV para exportar e baixar a análise de Link como um arquivo CSV para o seu armazenamento local.
Ações e controles
Acima das seções de status dos Links, você pode encontrar os controles e dados relacionados à análise de links.
um. Tipo de validação
Os tipos de validação são Agendado, Manual e nível de Artigo.
b. Data do relatório
A data dos relatórios gerados será carregada aqui. Os relatórios de validação são nomeados com base na data de geração.
Ao passar o mouse sobre o ícone de informações () ao lado do menu suspenso de dados do relatório , você pode ver a próxima ou próxima data de validação do link agendada.
NOTA
A validação de link programada é executada a cada 7 dias, portanto apenas os dados semanais mais recentes são mostrados.
c. Gerenciar links
Este botão abre o painel Gerenciar links .
Este painel contém informações sobre todos os links usados e também aqueles que são Ignorados ou Incluídos nas validações sob as respectivas abas.
d. Validar links
Esse botão inicia a validação manual do link no nível do projeto.
Quando você clica em Validar links, um prompt de confirmação alerta sobre o número de validações manuais restantes para o mês.
Para prosseguir, clique em Confirmar.
e. Uso manual de validação
Esta barra de status mostra o limite de validação manual disponível do seu projeto, conforme descrito no seu plano de projeto. O limite é resetado todo mês.
O limite de validação de status de link se aplica tanto a links internos quanto externos.
Clientes de todas as faixas de preço podem optar por um aumento no limite de validação do link a qualquer momento, de acordo com suas necessidades, por uma taxa simbólica.
Para informações adicionais, entre em contato com nossa equipe de suporte.
f. Uso de análise de links
Esta barra de status mostra as estatísticas do limite de links usado dentro do limite total do seu projeto.
NOTA
O limite de validação de links para os planos que suportam análises sobre o status dos links é:
Plano de negócios - 5000 links
Plano empresarial - 10.000 links
Limite de análise de links ultrapassado
Quando a contagem de links excede o total de links permitidos para o seu projeto, o limite de análise de links excede texto aparece em vez do uso de analytics de links.
Quando o limite de análise de links é ultrapassado e a validação de links (tanto Agendada quanto Manual) ocorre, apenas os links abaixo do limite total dado são validados.
Os links extras que excedem o limite não são validados. A validação em nível de artigo também não é possível para esses links.
Por exemplo, seu limite total de links é 10.000, mas a contagem total de links no seu projeto é 10.500. Apenas os primeiros 10.000 links são validados quando você realiza a validação do link. Os 500 links adicionados recentemente não são validados.
Para validar todos os links do seu projeto, entre em contato com nossa equipe de suporte para aumentar o limite para o seu projeto.
Validação do link
Você pode realizar a validação de links em nível de espaço de trabalho e linguagem das seguintes maneiras,
Validação programada
Validação manual
Validação em nível de artigo
NOTA
Para validação manual e agendada, todos os links no nível do projeto são analisados para verificar se há links quebrados, desconhecidos ou funcionando.
1. Validação agendada
É uma validação automática de link que roda em um Cronograma baseado no seu nível de plano.
Etapas para realizar a validação de cronograma
No Knowledge base portal, clique no ícone Analítica () na barra de navegação da esquerda.
Clique em status de Links no painel de navegação esquerdo.
A página de visão geral do status dos Links aparece.
No menu suspenso do tipo de Validação no topo, selecione a Validação Agendada (que é a seleção padrão para seus projetos).
Você pode encontrar a validação de links agendada gerada recentemente.
Se quiser revisar relatórios anteriores, selecione a data do relatório no menu suspenso da data do relatório.
2. Validação manual
Etapas para realizar a validação manual
No Knowledge base portal, clique no ícone Analítica () na barra de navegação da esquerda.
Clique em status de Links no painel de navegação esquerdo.
A página de visão geral do status dos Links aparece.
No menu suspenso do tipo de validação no topo, selecione Validação manual .
A lista mais recente de relatórios de validação manual será apresentada.
Clique em Validar links no canto superior direito para realizar uma nova validação manual.
NOTA
O relatório analítico para links é gerado a cada 24 horas (UTC 00:00). Se você executar validações manuais consecutivas dentro de 24 horas, os relatórios de validação manual já executados são sobrescritos pelos dados de validação mais recentes. Uma vez gerados, os dados não podem ser recuperados.
Após a validação concluída, você receberá um e-mail no endereço de e-mail registrado, e poderá visualizar o relatório analítico na página de visão geral.
NOTA
Apenas os papéis dos membros da equipe com permissão Validar análise de links podem realizar validações de links.
3. Validação em nível de artigo
Ao escolher a validação em nível de artigo no menu suspenso do tipo de validação , você pode visualizar as validações de links do artigo/página de categoria que você já executou. Esta página de visão geral ficará vazia se você não tiver validado links no nível do artigo ou da página da categoria.
Valide links no nível do artigo/página da categoria
A validação de links em nível de página de artigo e categoria pode ser realizada a partir da seção de editor de artigos.
Navegue até a página desejada do artigo/categoria no portal da Base de Conhecimento.
Clique no ícone de Mais () no canto superior direito.
Clique em Análises nas opções listadas.
O painel de análise de artigos aparece.
Clique em Validar agora para realizar a validação.
NOTA
A validação do link do artigo/página da categoria é ilimitada.
Gerenciar links
Clique em Gerenciar links na página de visão geral de status dos Links.
A página de visão geral de Gerenciar links aparecerá em seguida.
Esta seção oferece uma visão geral de alto nível de todas as métricas-chave relacionadas a links quebrados.
Busca - Você pode buscar por uma URL específica.
Tipo de link - Refere-se a se o link é uma URL Externa ou Interna.
Dependência - O número de vezes que o link foi referenciado nos artigos da base de conhecimento.
Status - Para escolher se um link é Ignorado ou Incluído.
Adicionar links à lista Ignorar/Incluir
No painel Gerenciar links , selecione a caixa de seleção para os links que deseja ignorar ou incluir.
Na coluna de status, você pode definir o status para Ignorado ou Incluído no menu suspenso.
(ou)
Selecione a caixa de seleção do link desejado cujo status você deseja mudar.
Clique na opção Ignorar disponível acima da lista de links.
Os links definidos para o status Incluído serão exibidos na aba Incluídos , e os links definidos para o status Ignorado serão exibidos na aba Ignorado .
Exportação
Na página Gerenciar links , clique em Exportar CSV acima da lista de links. O arquivo exportado será baixado em .csv formato para o seu armazenamento local.
Solução de problemas
Os links de trabalho aparecem como quebrados no relatório de status do Link
O Document360 aplica um tempo limite de validação de 5 segundos para verificação de links. Se uma solicitação ultrapassar esse limite, o sistema pode sinalizar o link como Desconhecido ou Quebrado. Mesmo que o link esteja funcionando, ele pode estar marcado incorretamente como quebrado devido à restrição de tempo de extinção.
Passos para resolver:
Verifique manualmente a URL
Abra o link em um navegador para confirmar se ele carrega corretamente.
Se a página carregar, o link pode ter sido sinalizado incorretamente como quebrado.
Valide o link usando o Postman
Abra o Postman e crie uma nova aba de solicitação.
Digite a URL e selecione o método GET .
Clique em Enviar para verificar o status da resposta.
Interprete o status da resposta HTTP
Se a resposta for 200 OK, o link está funcional.
Se o código de resposta for diferente de 200, o link pode estar quebrado.
Alguns dos códigos de status importantes são:
Código de status | Descrição do status | Descrição |
|---|---|---|
200 OK | Sucesso | O pedido foi bem-sucedido e a resposta esperada foi retornada. |
201 Criação | Recurso criado | O pedido foi bem-sucedido e um novo recurso foi criado. |
204 Sem conteúdo | Corpo sem resposta | A solicitação foi bem-sucedida, mas não há um corpo de resposta (comum em pedidos de DELETAÇÃO). |
400 pedido ruim | Solicitação inválida | A solicitação tem sintaxe incorreta ou parâmetros ausentes. |
401 Não Autorizado | Autenticação necessária | A solicitação não possui credenciais de autenticação válidas (por exemplo, falta ou incorreta chave de API). |
403 Proibido | Access denied | A solicitação é válida, mas o usuário não tem permissão para acessar o recurso. |
404 Não encontrado | Recurso ausente | O recurso solicitado não existe, ou o endpoint está incorreto. |
Método 405 não permitido | Método inválido | O método HTTP (GET, POST, etc.) não é permitido para esse endpoint. |
500 Erro interno do servidor | Problema com o servidor | Um erro genérico indicando que algo deu errado no servidor. |
502 Gateway ruim | Resposta inválida | O servidor recebeu uma resposta inválida de um servidor a montante. |
Serviço 503 indisponível | Servidor sobrecarregado | O servidor está fora do ar ou sobrecarregado de solicitações. |
Tempo limite do Gateway 504 | Erro de tempo | O servidor não recebeu resposta de outro serviço a tempo. |
Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360
Perguntas Freqüentes
Qual é o propósito do recurso de status de Links no Document360?
O recurso de status de links é um verificador de links quebrado que ajuda a validar e monitorar todos os links internos, externos e de arquivos de mídia na base de conhecimento, melhorando assim o SEO e a experiência do leitor.
O que acontece quando um usuário ultrapassa o limite de validação manual?
Quando você ultrapassar o limite de validação especificado no seu plano, o botão Validar links ficará inativo. A validação manual é reiniciada no primeiro dia de cada mês, e o botão é ativado novamente. Você pode entrar em contato com nosso suporte ao cliente se precisar aumentar esse limite.
Como posso evitar que links de exemplo específicos sejam sinalizados como quebrados no relatório de status do link?
Se você tiver exemplos ou links provisórios em seus artigos que estejam sendo detectados como links quebrados nas análises, pode excluir esses links da validação para evitar confusão.
Navegar para Analytics () > Status do link.
Na página de status do link , clique em Gerenciar links no canto superior direito.
Na página Gerenciar links , por padrão, a aba Todos os links será selecionada.
Selecione os links que você quer ignorar da lista ou use a barra de busca para encontrá-los.
Depois de selecionar os links desejados, clique em Ignorar ().
Os links ignorados serão movidos para a aba Ignorados e não aparecerão mais nos relatórios de validação de links.
Se quiser incluir esses links de volta no processo de validação depois:
Vá para a aba Ignorado .
Selecione novamente os links que deseja incluir.
Clique em Incluir (), e esses links serão validados em futuras verificações de links.
O relatório de Validação de Links analisa a versão publicada mais recente ou a versão rascunho?
Validação Manual e Programada analisam a versão mais recente publicada do artigo, enquanto a validação em nível de artigo verifica a respectiva versão preliminar.
Como funciona o filtro de visibilidade "Oculto" na análise de links?
O filtro de visibilidade na análise de links apenas verifica se o artigo em si está marcado como oculto ou não.
Se o artigo estiver marcado como oculto, ele aparecerá no filtro Oculto .
Se o artigo não estiver marcado como oculto, ele aparecerá sob o filtro Visível , mesmo que esteja dentro de uma categoria oculta.
Portanto, a menos que o artigo esteja oculto sozinho, ele ainda será mostrado como visível nas análises de links.
Como faço para encontrar quais artigos fazem referência ou link para um artigo específico no Document360?
Atualmente, não há opção direta para visualizar uma lista de artigos que fazem referência ou linkam para um artigo específico. No entanto, você pode usar o relatório de status do Link em Analytics como uma solução alternativa para identificar esses links internos.
Por exemplo, se você pretende excluir ou reestruturar um artigo, talvez queira primeiro verificar quais outros artigos estão linkando para ele. Isso garante que você não deixe links quebrados ou referências desatualizadas.
Passos para encontrar artigos de referência:
Vá para Analytics () > status do link no seu portal de base de conhecimento.
Desça até a seção de Links .
Clique em Filtrar, expanda o tipo de link, selecione URL interna e clique em Aplicar.
Clique em Exportar CSV para baixar a lista filtrada de links internos.
Entendendo o CSV exportado:
No arquivo exportado, verifique a coluna URL Interna :
Se o valor for
true, o link é inserido como um link interno no artigo fonte.Se o valor for
false, não é considerado um link interno.
Use a coluna do título do artigo para identificar qual artigo contém o link interno.
Você pode verificar manualmente esses links e atualizá-los ou removê-los se necessário antes de esconder ou deletar o artigo alvo.