Problemas de exibição de conteúdo e funcionalidade

Ícones não estão renderizando corretamente no site do usuário

Em alguns casos, ícones no site do usuário podem não ser renderizados corretamente, especialmente quando há um grande número de ícones para diferentes navegações. A principal razão para ícones quebrados é uma modificação não intencional da família FontAwesome fornecida pelo Document360. Isso ocorre quando alterações em outras classes ou tags HTML no site do usuário alteram involuntariamente as configurações da fonte dos ícones.
Para evitar esse problema,

• Certifique-se de que mudanças no estilo do site ou nas definições de classes não impactem as configurações das classes ou da família de fontes do FontAwesome.

• Ao mirar em elementos específicos, verifique novamente que os estilos relacionados a ícones permanecem intactos e não sejam sobrescritos por cima.

Passos para resolver:

1. Inspecionar o ícone quebrado:

1. Use as ferramentas de desenvolvimento do seu navegador para inspecionar o site do usuário.

2. Clique no ícone quebrado usando a ferramenta seletor para identificar o problema.

2. Confira CSS personalizado:

1. Navegue até Configurações () > site da base de conhecimento > Personalizar site > CSS e JavaScript personalizados no portal da base de conhecimento.

2. Revise quaisquer regras de fonte aplicadas a várias classes. Em alguns casos, mudanças na fonte podem se aplicar involuntariamente a classes mais amplas, afetando os ícones.

3. Garanta que as alterações na fonte sejam aplicadas apenas às classes específicas que as exigem. Isso ajudará a preservar as configurações padrão do Font Awesome e evitar qualquer impacto não intencional nos ícones.

A página não responde ao editar um artigo

Erro: A página não está funcionando. example.com te redirecionei muitas vezes. ERR_TOO_MANY_REDIRECTS.

Ao editar um artigo, a página pode ficar sem resposta ou apresentar erros relacionados ao redirecionamento. Algumas causas comuns incluem:

• Cache de navegador desatualizado interferindo no carregamento da página

• Tamanho grande do artigo com muitas imagens, tabelas ou conteúdo longo

• Tags HTML de fechamento incorretas ou faltantes (especialmente no Markdown)

• Redirecionamentos excessivos devido à configuração incorreta do artigo

• Problemas relacionados à plataforma que afetam todos os artigos, não apenas um específico

Passos para resolver:

• Limpe o cache, recarregue o navegador e verifique se o problema persiste. Um cache corrompido ou desatualizado pode interferir na funcionalidade da página.

• Use uma janela privada/incógnita. Isso ajuda a descartar problemas relacionados ao cache e cookies.

• Identifique a dimensão do problema. Verifique se o problema ocorre em todos os artigos ou apenas em um específico.

  Se todos os artigos forem afetados:

  • Gerar um arquivo HAR e entrar em contato com o Suporte do Document360 para análise.

  • Vá em Configurações () > Portal da base de conhecimento > Geral e ative o botão de acesso ao Suporte para que a equipe de suporte possa investigar.

  Se um artigo específico for afetado:

  • Artigos grandes podem causar problemas de desempenho. Considere dividir o conteúdo em artigos menores e organizá-los sob categorias apropriadas.

  • Certifique-se de que todas as tags HTML no artigo tenham tags de fechamento correspondentes (por exemplo, <table>, <div>, <p>), especialmente no formato Markdown.

• 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

• Forneça os seguintes detalhes:

  • Uma captura de tela da edição

  • O arquivo HAR para análise

  • O acesso ao suporte está habilitado no seu projeto

Carregamento de site da base de conhecimento sem estilo CSS

Esse problema normalmente ocorre quando o site é acessado a partir de uma rede onde domínios Document360 são bloqueados ou não colocados na lista branca pela sua empresa ou organização.

Passos para resolver:

1. Verifique se o site funciona corretamente quando acessado de outra rede. Se acontecer, o problema provavelmente está relacionado a restrições de rede.

2. Para resolver isso, coloque os seguintes domínios na lista branca nas configurações da rede para garantir o acesso e a funcionalidade adequados.

Fotos de perfil de usuários/leitores estão quebradas

Fotos de perfil de usuários ou leitores podem parecer quebradas no site da base de conhecimento. Esse problema ocorre quando o tipo de conteúdo da imagem é identificado incorretamente, impedindo que ele carregue corretamente.

Passos para resolver:

1. Abra qualquer artigo no site da Knowledge Base e verifique se a foto de perfil do colaborador parece quebrada.

2. Clique com o botão direito na aba do navegador, clique em Inspecionar e vá até a aba Rede no painel de ferramentas de desenvolvimento .

3. Localize a solicitação que carrega a imagem de perfil e verifique o Tipo de Conteúdo:

   • Se for "texto/simples", a imagem não carrega direito.

   • Se for "image/jpeg", "application/octet-stream" ou outro formato válido, a imagem deve carregar normalmente.

   

4. Tente recarregar a foto de perfil:

   • Navegue até seu projeto no portal da Base de Conhecimento.

   • Clique no ícone do seu perfil no canto superior direito.

   • Selecione Meu perfil no menu suspenso.

   • No painel Meu perfil , clique em Editar e depois no ícone Editar () próximo à foto de perfil.

   • Envie a imagem de perfil desejada.

   

5. Se o problema persistir, gere um arquivo HAR e entre em contato com o Suporte do Document360 para investigação adicional.

Problema no envio de feedback de artigo

Possíveis causas para esse problema são restrições de políticas de segurança de conteúdo, problemas de rede ou firewall, extensões de navegador, conflitos de cache ou problemas temporários de servidores. Esses fatores podem bloquear o envio de feedback ou impedir ações como curtir, não curtir ou comentar em um artigo.

Passos para resolver:

1. Verifique se você pode Curtir ou Não Curtir o artigo.

2. Certifique-se de que você pode inserir comentários na área de texto de feedback.

3. Tente clicar no botão Enviar para ver se o feedback foi registrado.

4. Determine se o problema ocorre para um único artigo ou para todos os artigos.
   

   Verifique por erros:

5. Abra o console de desenvolvimento do navegador (Clique com o botão direito > Inspecionar > aba Console).

6. Procure por quaisquer erros do console relacionados à Política de Segurança de Conteúdo (CSP).

7. Capture uma captura de tela da mensagem de erro.

8. Abra a aba Rede nas ferramentas de desenvolvimento do navegador.

9. Reproduza o problema e exporte o registro de rede como um arquivo HAR.

10. 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

11. Forneça os seguintes detalhes:

    • Capturas de tela de erro do console

    • arquivo HAR com logs de rede

    • Gravação de tela da edição

Adaptando código personalizado para o modelo Single Page Application (SPA) no Document360

Com a transição do site Document360 para um modelo de Aplicação de Página Única (SPA), qualquer JavaScript personalizado dependente de eventos de atualização de página pode deixar de funcionar como esperado. Isso porque os SPAs atualizam apenas o conteúdo do artigo, não toda a página.

Abaixo estão as áreas onde os usuários podem injetar JavaScript Personalizado no portal Document360:

1. JavaScript personalizado

   1. Navegue até Configurações () na barra de navegação à esquerda do portal da base de conhecimento.

   2. No painel de navegação esquerdo, navegue até Site da base de conhecimento > Personalização do site > CSS e JavaScript personalizados .

2. Integrações Personalizadas de HTML

   1. Navegue até Conexões Conexões () na barra de navegação da esquerda e selecione Integrações.

   2. Selecione HTML Personalizado no menu suspenso no canto superior esquerdo.

Solução recomendada

Para garantir compatibilidade com o modelo SPA, atualize seu JavaScript personalizado para usar o articleload evento. Esse evento é ativado quando o conteúdo do artigo é atualizado, garantindo que seus scripts funcionem perfeitamente na nova arquitetura.

1. Substitua qualquer código que dependa de eventos de atualização de página por uma assinatura do articleload evento.

2. Use o seguinte trecho de código para adaptar seus scripts personalizados:

   panel.addEventListener('articleload', function() {
     // Your custom JavaScript code here
   });

3. Teste seus scripts atualizados para confirmar que funcionam corretamente no ambiente SPA.

   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