Pular para o conteúdo principal

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.

  1. No menu principal do Hashdata, clique no ícone de Integrações.
  2. 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.
  3. Clique em Configurações.
  4. 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.
  5. 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.
  6. Confira o Nome do índice no Hashdata Advanced Reports. Veja Nome do índice.
  7. Salve.

A partir daí, cada resposta enviada é copiada automaticamente para o índice do formulário.

Rascunhos também podem ser integrados

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.

Detalhes da tela de integração

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.

RegraRecomendadoEvitar
Letras minúsculasunidade, turnoUnidade, TURNO
Sem acento e sem cedilhaavaliacao, regiaoavaliação, região
Hífen no lugar de espaçoresponsavel-arearesponsavel area
Prefixos que agrupam campos do mesmo tipoperc-limpeza, perc-organizacao, pont-limpezalimpeza-pct, pontos2
Número fixo de dígitos em listas de itensitem-01 … item-25item1 … item25
Mesmo nome para a mesma pergunta em formulários diferentesunidade em todosunidade num, negocio em outro
Nome que descreve o conteúdotemperatura-camaraq17, campo-novo
Maiúsculas e minúsculas contam

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.

Renomeie antes de começar a coletar

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 perguntaComo costuma chegarUso típico no painel
Número e campo calculadoNúmeroSoma, média, mediana, mínimo, máximo, último valor, faixas (intervalos).
Seleção únicaTexto, com a opção escolhidaAgrupar (por exemplo, por unidade), contar, filtrar, separar barras por categoria.
Seleção com valor atribuídoPode chegar como o número atribuído à opção. Confira no DiscoverSomar ocorrências (por exemplo, opção "Sim" = 1) ou calcular médias de pontuação.
Seleção múltiplaLista com todas as opções marcadasContar quantas vezes cada opção foi marcada. Veja Seleção múltipla.
Texto livreTextoBusca por palavra, nuvem de palavras, coluna de observações em tabelas.
Data e horaDataFiltrar por período ou usar como campo de tempo de uma fonte de dados.
Confira o tipo antes de montar o painel

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.

NecessidadeNo formulário (campo calculado)No painel
Percentual de conformidade de uma auditoriaavgByTag('r')*100 ou a soma por tag dividida pelo máximo possívelMédia do campo, por mês ou por unidade.
Pontuação de cada seçãoSoma 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 pesoCampo calculado com a faixa (opcional)Agrupamento direto pela faixa, ou Intervals sobre o número.
Tags e nomes são independentes

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.

Escala do percentual: 0–100 ou 0–1

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:

  1. Use nomes de questões idênticos em todos os formulários. Se um formulário usa unidade e outro usa negocio, o painel trata os dois como campos diferentes, e o gráfico não junta os dados.
  2. 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.
  3. Use as mesmas opções de resposta, com a mesma grafia.
  4. 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.
  5. 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).
Coletatipo-defeito (rótulo)valor-defeito (valor)
Coleta 1Mancha2
Coleta 1Fissura0
Coleta 1Corpo estranho1
Coleta 2Mancha0
Coleta 2Fissura3
Coleta 2Corpo estranho0

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.
No índice transposto, a contagem de registros não é a contagem de coletas

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​

  1. Integração ativa, com as perguntas necessárias marcadas para exportação.
  2. Nomes das questões revisados, na ordem do formulário, no padrão definido.
  3. Campos calculados apontando para os nomes e tags corretos.
  4. Coleta de teste completa, enviada e sincronizada.
  5. Discover: a coleta de teste aparece no índice, com todos os campos preenchidos e com o tipo certo. Veja Explorar os dados.
  6. Opções de resposta anotadas com a grafia exata, para os filtros.