Preparar os dados
Um bom painel começa no formulário. Os nomes das perguntas, o tipo de cada resposta e os campos calculados definem o que o painel consegue mostrar e com que precisão. Um formulário bem preparado gera indicadores corretos desde a primeira coleta, permite juntar vários formulários num mesmo painel e evita retrabalho quando o painel cresce. Um formulário montado às pressas costuma gerar gráficos com nomes confusos, números somados como texto e campos que mudam de nome no meio do caminho.
Esta página reúne tudo o que deve ser feito antes de criar o primeiro gráfico: ativar a integração, nomear as questões, conferir o tipo de cada resposta e deixar no formulário os cálculos que o painel vai usar.
Ativar a integração do formulário
Só os formulários marcados para integração aparecem nas Análises Avançadas.
- No menu principal do Hashdata, clique no ícone de Integrações.
- Selecione o formulário e marque a integração Hashdata Advanced Reports. O mesmo formulário pode ter também a integração via API REST.
- Clique em Configurações.
- Para cada pergunta, defina o nome da questão. O botão Preencher automaticamente sugere nomes a partir dos enunciados. Revise as sugestões com o padrão da seção Nome da questão.
- Confira se cada pergunta que o painel vai usar está marcada para exportação ao BI. Uma pergunta que não é exportada não aparece nas análises.
- Confira o Nome do índice no Hashdata Advanced Reports. Veja Nome do índice.
- Salve.
A partir daí, cada resposta enviada é copiada automaticamente para o índice do formulário.
Um formulário em rascunho pode ser integrado, mas a estrutura dele pode mudar a qualquer momento. Perguntas renomeadas, removidas ou com o tipo alterado mudam os campos que chegam ao painel. Para painéis em produção, prefira integrar formulários publicados.
A tela de integração também é usada pela API REST. Veja a página Integrações para os detalhes dessa configuração.
Nome do índice
O índice é a base de coletas do formulário nas Análises Avançadas. O nome dele tem duas partes:
- Prefixo numérico — gerado pelo sistema. Não altere.
- Descrição — só letras, números, sublinhado (
_) e hífen (-).
Exemplo: 21261-formulario-dados-pessoais.
Escolha uma descrição curta e que identifique o formulário sem ambiguidade. Quando vários formulários vão compor o mesmo painel, use descrições com uma parte em comum (por exemplo, boas-praticas-unidade-a e boas-praticas-unidade-b). Isso permite juntar todos eles numa fonte de dados com curinga.
Nome da questão
O nome da questão é o nome curto que identifica a pergunta no sistema. É o mesmo Nome do campo de Atributos do elemento, no editor do formulário. Nas Análises Avançadas, ele é o nome do campo: aparece na lista de campos, nos filtros, nas fórmulas e nos títulos automáticos dos gráficos.
| Regra | Recomendado | Evitar |
|---|---|---|
| Letras minúsculas | unidade, turno | Unidade, TURNO |
| Sem acento e sem cedilha | avaliacao, regiao | avaliação, região |
| Hífen no lugar de espaço | responsavel-area | responsavel area |
| Prefixos que agrupam campos do mesmo tipo | perc-limpeza, perc-organizacao, pont-limpeza | limpeza-pct, pontos2 |
| Número fixo de dígitos em listas de itens | item-01 … item-25 | item1 … item25 |
| Mesmo nome para a mesma pergunta em formulários diferentes | unidade em todos | unidade num, negocio em outro |
| Nome que descreve o conteúdo | temperatura-camara | q17, campo-novo |
Grupo e grupo são campos diferentes nas análises. Se um nome foi criado com inicial maiúscula, ele precisa ser escrito exatamente assim nos filtros e nas fórmulas. Padronizar tudo em minúsculas evita esse tipo de confusão.
As coletas já enviadas guardam os nomes que as questões tinham na hora do envio. Se uma questão for renomeada depois, as coletas antigas continuam com o nome antigo, e a mesma pergunta passa a aparecer como dois campos no painel. Defina os nomes antes de colocar o formulário em uso. Se for preciso renomear um formulário que já tem coletas, fale com o suporte do Hashdata sobre o reprocessamento do histórico.
Confira se os nomes estão alinhados com as perguntas
Em formulários longos, com seções repetidas (por exemplo, uma seção por senso numa auditoria 5S), é comum um nome ficar deslocado: o resultado da seção "Limpeza" acaba com o nome perc-organizacao, e todos os seguintes se deslocam junto. O painel mostra números, mas sob o nome errado.
Antes de integrar, percorra o formulário na ordem e confira, pergunta a pergunta, se o nome descreve aquela pergunta. Para formulários com muitas seções, monte uma tabela simples com três colunas: seção, pergunta e nome.
Como cada tipo de pergunta chega às análises
O tipo da pergunta define o que dá para calcular com ela. Um número permite somar e tirar média; um texto permite agrupar, contar e filtrar.
| Tipo de pergunta | Como costuma chegar | Uso típico no painel |
|---|---|---|
| Número e campo calculado | Número | Soma, média, mediana, mínimo, máximo, último valor, faixas (intervalos). |
| Seleção única | Texto, com a opção escolhida | Agrupar (por exemplo, por unidade), contar, filtrar, separar barras por categoria. |
| Seleção com valor atribuído | Pode chegar como o número atribuído à opção. Confira no Discover | Somar ocorrências (por exemplo, opção "Sim" = 1) ou calcular médias de pontuação. |
| Seleção múltipla | Lista com todas as opções marcadas | Contar quantas vezes cada opção foi marcada. Veja Seleção múltipla. |
| Texto livre | Texto | Busca por palavra, nuvem de palavras, coluna de observações em tabelas. |
| Data e hora | Data | Filtrar por período ou usar como campo de tempo de uma fonte de dados. |
No Discover, a lista de campos mostra um ícone ao lado de cada nome: # para número, t ou k para texto, um calendário para data. Um campo de nota, pontuação ou percentual que aparece como texto não permite calcular média nem soma. Nesse caso, revise o tipo da pergunta no formulário. Veja Explorar os dados.
Seleção múltipla
Numa pergunta de seleção múltipla, uma mesma coleta pode ter várias opções marcadas. Ao agrupar por esse campo, cada coleta é contada uma vez em cada opção marcada. Por isso:
- A soma das barras pode ser maior que o total de coletas.
- Percentuais por opção podem somar mais de 100%.
Isso está correto: o gráfico mostra quantas coletas marcaram cada opção. Deixe isso claro no título, por exemplo: "Fatores de risco informados (pergunta de múltipla escolha)".
Opções com grafia exata
Os filtros e as fórmulas comparam o texto exato da opção. "Positivo" e "positivo" são valores diferentes, assim como "Não" e "Nao". Antes de escrever filtros, confira no Discover como cada opção foi gravada.
Campos calculados e tags
Regras com várias condições ficam mais simples e mais confiáveis quando são calculadas no formulário, com um campo calculado. O resultado chega pronto ao índice, e o gráfico só precisa somar, contar ou tirar a média.
| Necessidade | No formulário (campo calculado) | No painel |
|---|---|---|
| Percentual de conformidade de uma auditoria | avgByTag('r')*100 ou a soma por tag dividida pelo máximo possível | Média do campo, por mês ou por unidade. |
| Pontuação de cada seção | Soma por tag de cada seção (por exemplo, sumByTag('limpeza')) | Uma série por seção, no mesmo gráfico. |
| Classificação com várias condições (por exemplo, "positivo" quando um teste é positivo ou pelo menos dois sintomas estão presentes) | Campo calculado que devolve "Sim" ou "Não" | Contagem ou percentual dos "Sim". |
| Faixa etária, faixa de temperatura, faixa de peso | Campo calculado com a faixa (opcional) | Agrupamento direto pela faixa, ou Intervals sobre o número. |
Fórmulas que usam tags (como sumByTag('r') e avgByTag('r')) não dependem dos nomes das questões. Por isso, padronizar os nomes não quebra esses cálculos. Fórmulas que citam o nome de uma questão precisam ser revisadas quando o nome muda.
Um campo calculado como avgByTag('r')*100 grava, por exemplo, 85 para 85%. No gráfico, mostre esse valor com o formato Number e o sufixo %. O formato Percent multiplica o valor por 100 e mostraria 8.500%. Veja Formato dos números.
Juntar vários formulários num painel
Quando cada unidade, diretoria ou região tem o próprio formulário, cada um gera um índice separado. Para mostrar todos num mesmo gráfico, os índices são reunidos numa única fonte de dados. Para isso funcionar:
- Use nomes de questões idênticos em todos os formulários. Se um formulário usa
unidadee outro usanegocio, o painel trata os dois como campos diferentes, e o gráfico não junta os dados. - Use os mesmos tipos de pergunta. Um campo que é número num formulário e texto em outro não pode ser somado no conjunto.
- Use as mesmas opções de resposta, com a mesma grafia.
- Identifique a origem. Inclua em cada formulário uma pergunta com valor fixo (por exemplo,
diretoria, com o valor "Diretoria A"). Assim, o painel mostra nomes legíveis. Sem essa pergunta, a origem pode ser identificada pelo campo_index, que traz o nome técnico do índice. Veja O campo_index. - Dê aos índices descrições com uma parte em comum, para usar um curinga na fonte de dados.
Índice transposto
Alguns formulários registram a mesma medida em várias perguntas, uma por posição, item ou tipo. Por exemplo, um controle de defeitos com uma pergunta para cada tipo: defeito-01, defeito-02 … defeito-24. Para analisar "quantos defeitos de cada tipo", o mais prático é transformar essas colunas em linhas. É o que faz o índice transposto, configurado na integração.
No índice transposto, cada pergunta mapeada vira um registro com dois campos:
- um campo de rótulo, com o nome do item (por exemplo,
tipo-defeito); - um campo de valor, com a resposta daquele item (por exemplo,
valor-defeito).
| Coleta | tipo-defeito (rótulo) | valor-defeito (valor) |
|---|---|---|
| Coleta 1 | Mancha | 2 |
| Coleta 1 | Fissura | 0 |
| Coleta 1 | Corpo estranho | 1 |
| Coleta 2 | Mancha | 0 |
| Coleta 2 | Fissura | 3 |
| Coleta 2 | Corpo estranho | 0 |
Para o gráfico de defeitos por tipo:
- Eixo horizontal: o campo de rótulo, com Top values.
- Eixo vertical: Sum do campo de valor.
Cada coleta vira um registro por item mapeado. Numa transposição de 24 itens, uma coleta gera 24 registros. Por isso, Count of records com o rótulo no eixo mostra o mesmo número para todos os tipos: ele conta as linhas, não as ocorrências. Use sempre Sum do campo de valor. Para contar coletas, use o índice original do formulário.
Validar antes de montar o painel
- Integração ativa, com as perguntas necessárias marcadas para exportação.
- Nomes das questões revisados, na ordem do formulário, no padrão definido.
- Campos calculados apontando para os nomes e tags corretos.
- Coleta de teste completa, enviada e sincronizada.
- Discover: a coleta de teste aparece no índice, com todos os campos preenchidos e com o tipo certo. Veja Explorar os dados.
- Opções de resposta anotadas com a grafia exata, para os filtros.