Pular para o conteúdo principal

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 apareceCausaSolução
O formulário não aparece nas Análises AvançadasO 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 DiscoverA 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 camposA 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 camposA 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 outraNomes 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 notaO 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 valuesFoi 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 coletasPergunta 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 nadaValor 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 apareceCausaSolução
O valor do painel não bate com o relatórioO 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 vazioA 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ífenO hífen é lido como subtração.Colocar o nome entre aspas simples: average('perc-total').
Erro no filtro dentro da fórmulaAspas trocadas.Filtro entre aspas simples, valores entre aspas duplas: count(kql='status : "Reprovado"').
Unidade com uma só coleta em primeiro lugar no rankingRanking 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 apareceCausaSolução
Barras finas e espaçadas depois de filtrarIntervalo de data em Auto, recalculado com menos coletas.Fixar o Minimum interval (por exemplo, Month).
Gráfico com dois eixos verticais sem quererMétricas com formatos diferentes.Usar o mesmo Value format ou Axis side: Left em todas.
Título do eixo com "per month" ou outro complementoTítulo automático do eixo.Usar Axis title → Custom no botão do eixo.
Grupo "Other" no rankingOpção Group remaining values as "Other" ligada.Desligar a opção e aumentar Number of values.
Só aparecem 3 ou 5 categoriasNumber of values com o valor padrão.Aumentar a quantidade de valores.
Meses futuros vazios no gráficoPerí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 usedO 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 mudaGrá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 controleO 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çõesControles 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íodoPainel salvo sem Store time with dashboard.Salvar de novo com a opção marcada.
O painel abre com um filtro inesperadoFiltro ou seleção de controle ativo no momento do salvamento.Limpar os filtros e salvar de novo.
Alterar um gráfico mudou outro painelO 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 lentoMuitos 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 painelO 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​

  1. Formulário — nomes das questões no padrão, tipos corretos, campos calculados, perguntas de identificação (unidade, regional) e integração ativa.
  2. Coleta de teste — completa, enviada e sincronizada.
  3. Discover — conferir campos, tipos e a grafia das opções.
  4. Fonte de dados — confirmar a do formulário ou criar uma nova (vários formulários, outro campo de tempo).
  5. Indicadores — listar as perguntas que o painel deve responder e o público.
  6. Cards — os indicadores principais, com formato, cor por faixa e, se for o caso, período próprio.
  7. Gráficos de tendência e comparação — intervalo fixo, função conferida, linha de meta.
  8. Detalhe — rankings, tabelas com cores e busca salva para os casos que exigem ação.
  9. Controles — do geral para o específico, com rótulos em português.
  10. Acabamento — títulos com unidade, legendas, eixos e texto de apoio.
  11. Salvar — com Store time with dashboard e sem filtros de teste.
  12. Conferência — totais do painel contra uma exportação do formulário, com e sem filtros.
  13. Compartilhamento — liberar para os perfis corretos e enviar o link.