Erros frequentes e boas práticas
A maioria dos números estranhos num painel tem uma causa simples: um nome de campo diferente, um cálculo escolhido automaticamente, um período que não é o que parece ou um filtro esquecido. Esta página reúne o que costuma aparecer na tela, o motivo e a solução, além das boas práticas que evitam esses casos desde o início.
Erros frequentes e solução
Dados e campos
| O que aparece | Causa | Solução |
|---|---|---|
| O formulário não aparece nas Análises Avançadas | O formulário não está marcado para integração. | Ativar a integração com o Hashdata Advanced Reports. Veja Ativar a integração. |
| Uma coleta não aparece no painel nem no Discover | A coleta ainda não sincronizou, ou está fora do período selecionado. | Confirmar a sincronização no aplicativo e ampliar o período. |
| Uma pergunta não aparece na lista de campos | A pergunta não tem nome, não está marcada para exportação ou ainda não foi respondida em nenhuma coleta. | Revisar a integração, enviar uma coleta de teste e recarregar a página. |
| A mesma pergunta aparece como dois campos | A questão foi renomeada depois das primeiras coletas, ou os formulários reunidos usam nomes diferentes. | Padronizar os nomes. Para reprocessar o histórico, falar com o suporte do Hashdata. |
| Os resultados de uma seção aparecem com o nome de outra | Nomes das questões deslocados em relação às perguntas. | Conferir os nomes na ordem do formulário. Veja Nome da questão. |
| Não dá para escolher Average nem Sum num campo de nota | O campo chegou como texto. | Ajustar o tipo da pergunta para número e enviar uma nova coleta. |
| Um campo de texto não pode ser usado em Top values | Foi escolhida a versão de texto livre do campo. | Usar a versão .keyword. |
| Valores negativos ou absurdos (peso -80, temperatura 400) | Erro de preenchimento na coleta. | Corrigir na origem. Para não distorcer o gráfico, filtrar a faixa válida (por exemplo, peso >= 0). |
| Todos os tipos de defeito têm a mesma contagem | Índice transposto com Count of records. | Usar Sum do campo de valor. Veja Índice transposto. |
| A soma das opções é maior que o total de coletas | Pergunta de seleção múltipla: cada coleta conta em cada opção marcada. | Comportamento esperado. Indicar no título que a pergunta é de múltipla escolha. |
| Um filtro não encontra nada | Valor com grafia diferente (maiúsculas, acentos) ou nome do campo com maiúscula. | Copiar o valor exato do resumo do campo no Discover. |
Cálculos
| O que aparece | Causa | Solução |
|---|---|---|
| O valor do painel não bate com o relatório | O editor escolheu Median, e o relatório usa a média. | Trocar a função para Average. Veja Média ou mediana. |
| Barras com 300%, 400% ou 500% | Percentuais somados em barras empilhadas. | Usar Unstacked ou Line. |
| Percentual aparece como 8.500% | Formato Percent num valor que já está em 0–100. | Usar Number com sufixo %. |
| Percentual aparece como 0,85% | Sufixo % num valor em 0–1. | Usar o formato Percent. |
| Card vazio ou com "–" | Não há coletas no período, ou a fórmula divide por zero. | Conferir o período e os filtros do card. |
| Último valor aparece vazio | A coleta mais recente não tem o campo preenchido. | Usar last_value(campo, kql='campo : *'). |
| Erro na fórmula com um campo que tem hífen | O hífen é lido como subtração. | Colocar o nome entre aspas simples: average('perc-total'). |
| Erro no filtro dentro da fórmula | Aspas trocadas. | Filtro entre aspas simples, valores entre aspas duplas: count(kql='status : "Reprovado"'). |
| Unidade com uma só coleta em primeiro lugar no ranking | Ranking sem considerar a quantidade de coletas. | Mostrar a quantidade de coletas ao lado ou ampliar o período. |
Gráficos e painéis
| O que aparece | Causa | Solução |
|---|---|---|
| Barras finas e espaçadas depois de filtrar | Intervalo de data em Auto, recalculado com menos coletas. | Fixar o Minimum interval (por exemplo, Month). |
| Gráfico com dois eixos verticais sem querer | Métricas com formatos diferentes. | Usar o mesmo Value format ou Axis side: Left em todas. |
| Título do eixo com "per month" ou outro complemento | Título automático do eixo. | Usar Axis title → Custom no botão do eixo. |
| Grupo "Other" no ranking | Opção Group remaining values as "Other" ligada. | Desligar a opção e aumentar Number of values. |
| Só aparecem 3 ou 5 categorias | Number of values com o valor padrão. | Aumentar a quantidade de valores. |
| Meses futuros vazios no gráfico | Período This year, que vai até 31 de dezembro. | Usar Year to date ou o arredondamento ao ano. |
| "Year to date" não aparece em Commonly used | O atalho não está na lista da sua conta. | Usar Last 0 years rounded to the year. Veja Período. |
| Um gráfico não muda quando o período do painel muda | Gráfico com período próprio. | Conferir em ⋯ → Settings → Apply custom time range. |
| Um gráfico não muda, ou fica vazio, ao selecionar uma opção no controle | O gráfico usa uma fonte de dados sem o campo do controle. | Padronizar o nome do campo nas fontes de dados ou separar os gráficos em outro painel. |
| Lista de um controle não mostra todas as opções | Controles encadeados: a lista respeita as seleções dos controles anteriores. | Comportamento esperado. Limpar os controles anteriores para ver todas as opções. |
| O painel abre com outro período | Painel salvo sem Store time with dashboard. | Salvar de novo com a opção marcada. |
| O painel abre com um filtro inesperado | Filtro ou seleção de controle ativo no momento do salvamento. | Limpar os filtros e salvar de novo. |
| Alterar um gráfico mudou outro painel | O gráfico está na biblioteca e é usado em vários painéis. | Usar Unlink from library no painel que deve ter uma versão própria. |
| Painel lento | Muitos gráficos, períodos longos ou muitos pontos em mapas. | Usar seções recolhíveis, períodos padrão menores e agrupamentos nos mapas. |
| A pessoa não consegue abrir o link do painel | O perfil dela não tem acesso ao painel. | Pedir a liberação ao administrador da conta. |
Boas práticas
Dados
- Prepare o formulário antes do painel — nomes das questões padronizados, tipos corretos e campos calculados prontos.
- Defina os nomes antes de coletar — renomear depois divide a mesma pergunta em dois campos.
- Calcule no formulário as regras complexas — o painel fica mais simples e os números batem com os relatórios.
- Confira no Discover — toda mudança no formulário merece uma coleta de teste e uma conferência.
Painel
- Comece pela pergunta — cada gráfico responde a uma pergunta escrita em uma frase.
- Hierarquia de cima para baixo — indicadores no topo, tendências no meio, detalhe na base.
- De 10 a 12 gráficos por tela — acima disso, use seções recolhíveis ou divida o painel.
- Um painel por público — operador, supervisor e diretoria precisam de recortes diferentes.
- Período padrão adequado — hoje, 7 dias, 30 dias ou acumulado do ano, conforme o uso, salvo com o painel.
- Filtros do geral para o específico — Diretoria → Regional → Unidade.
- Texto de apoio — um bloco de texto explicando a meta e as cores ajuda quem não é da área.
Gráficos
- Escolha a função de propósito — média, mediana, soma ou contagem, nunca a escolhida automaticamente sem conferir.
- Fixe o intervalo em gráficos de fechamento.
- Contexto em todo número — meta, cor por faixa ou comparação com o período anterior.
- Poucas séries — até 5 a 7 linhas ou cores por gráfico.
- Mesma escala para o mesmo tipo de indicador (percentuais de 0 a 100).
Nomes
- Painéis: Área – Objetivo – Público. Exemplo: "Qualidade – Não Conformidades – Gestão".
- Gráficos: o que mostram, com a unidade e, se necessário, o período. Exemplo: "Não Conformidades por Linha (ocorrências) – últimos 30 dias".
- Fontes de dados: o formulário ou o conjunto de formulários. Exemplo: "Boas Práticas – Todas as Diretorias".
Roteiro passo a passo
- Formulário — nomes das questões no padrão, tipos corretos, campos calculados, perguntas de identificação (unidade, regional) e integração ativa.
- Coleta de teste — completa, enviada e sincronizada.
- Discover — conferir campos, tipos e a grafia das opções.
- Fonte de dados — confirmar a do formulário ou criar uma nova (vários formulários, outro campo de tempo).
- Indicadores — listar as perguntas que o painel deve responder e o público.
- Cards — os indicadores principais, com formato, cor por faixa e, se for o caso, período próprio.
- Gráficos de tendência e comparação — intervalo fixo, função conferida, linha de meta.
- Detalhe — rankings, tabelas com cores e busca salva para os casos que exigem ação.
- Controles — do geral para o específico, com rótulos em português.
- Acabamento — títulos com unidade, legendas, eixos e texto de apoio.
- Salvar — com Store time with dashboard e sem filtros de teste.
- Conferência — totais do painel contra uma exportação do formulário, com e sem filtros.
- Compartilhamento — liberar para os perfis corretos e enviar o link.