Fontes de dados
A fonte de dados é a ponte entre os gráficos e as coletas. Ela diz de quais formulários vêm os dados, qual data controla o período analisado e quais campos estão disponíveis para os gráficos. Com uma fonte de dados bem configurada, quem monta o painel encontra os campos com nomes claros, os números já formatados e o período funcionando como esperado. Também é a fonte de dados que permite juntar vários formulários, por exemplo um por unidade ou por diretoria, para compará-los num mesmo gráfico.
Na tela, a fonte de dados se chama Data view.
Quando criar uma fonte de dados
Em geral, cada formulário integrado já tem uma fonte de dados disponível. Crie uma nova quando for preciso:
- Juntar vários formulários num mesmo painel. Veja Juntar índices.
- Usar outra data para o período, como a data de um campo do formulário em vez da data da coleta. Veja Campo de tempo.
- Separar visões de um mesmo índice, por exemplo, uma fonte de dados com rótulos e formatos próprios para um painel da diretoria.
No editor de gráficos e no Discover, o seletor no canto superior esquerdo lista todas as fontes de dados disponíveis. Confira se já existe uma para o formulário antes de criar outra, para evitar fontes duplicadas com nomes parecidos.
Criar uma fonte de dados
- Abra ☰ → Stack Management → Data Views.
- Clique em Create data view.
- Preencha os campos:
| Campo | O que preencher |
|---|---|
| Name | O nome que aparece no seletor de fontes de dados. Use um nome legível, por exemplo, "Auditoria 5S" ou "Boas Práticas – Todas as Diretorias". |
| Index pattern | O nome do índice, ou um padrão que pegue vários índices. Veja Padrão de índices. À direita, a tela lista os índices que correspondem ao padrão digitado. |
| Timestamp field | O campo de data que controla o período. Na maioria dos casos, date, a data da coleta. Veja Campo de tempo. |
- Confira, na lista à direita, se aparecem todos os índices esperados, e somente eles.
- Clique em Save data view.
Padrão de índices
O campo Index pattern aceita o nome exato de um índice, um curinga (*) ou uma lista separada por vírgula:
| Padrão | O que pega | Quando usar |
|---|---|---|
21261-formulario-dados-pessoais | Só esse índice | Um formulário. |
*boas-praticas* | Todos os índices que têm "boas-praticas" no nome | Vários formulários com uma parte do nome em comum. |
21540-auditoria-unidade-a,21541-auditoria-unidade-b | Exatamente os índices da lista | Poucos formulários com nomes sem uma parte em comum. |
Um curinga como *auditoria* pode pegar índices que não deveriam estar no painel, como um formulário de teste ou uma auditoria de outro tipo. Confira sempre a lista de índices à direita antes de salvar. Se aparecer um índice a mais, troque o curinga por uma lista separada por vírgula.
Juntar índices
Uma fonte de dados com vários índices trata todas as coletas como uma só base. Os campos com o mesmo nome em todos os formulários viram um campo único, e os gráficos podem somar, comparar e agrupar tudo junto.
Para isso funcionar, os formulários precisam estar padronizados: mesmos nomes de questões, mesmos tipos de pergunta e mesmas opções de resposta. Veja Juntar vários formulários num painel.
O campo _index
Toda fonte de dados tem o campo _index, com o nome do índice de onde veio cada registro. Ele é útil para:
- Conferir se todos os formulários estão na fonte de dados. No Discover, clique no campo
_indexna lista de campos: aparecem os nomes dos índices e quantos registros cada um tem. - Separar os formulários num gráfico, quando não existe uma pergunta de identificação. Use o agrupamento Filters, com um filtro por índice:
| Filtro (barra de busca) | Rótulo |
|---|---|
_index : *unidade-a* | Unidade A |
_index : *unidade-b* | Unidade B |
_index : *unidade-c* | Unidade C |
Veja Agrupamento Filters.
O campo _index mostra o nome técnico do índice, como 21540-bp-diretoria-a. Uma pergunta com valor fixo em cada formulário (por exemplo, diretoria) mostra nomes legíveis nos gráficos e nos filtros, sem precisar montar um filtro por índice.
Campo de tempo
O campo de tempo define a data usada pelo seletor de período e pelos agrupamentos por data (mês a mês, semana a semana).
| Campo de tempo | O que significa | Quando usar |
|---|---|---|
date | A data da coleta | Padrão para quase todos os painéis. |
| Uma pergunta de data do formulário | A data informada por quem preencheu (por exemplo, a data do atendimento ou da ocorrência) | Quando a coleta pode ser feita depois do fato, e o painel deve mostrar a data do fato. |
| Nenhum | A fonte de dados não tem período | Raramente. Sem campo de tempo, o seletor de período não se aplica aos gráficos. |
O campo de tempo pode ser alterado na edição da fonte de dados, mas a troca muda o período de todos os gráficos que usam essa fonte. Se só um painel precisa de outra data, crie uma nova fonte de dados com o campo de tempo desejado.
Tipos de campo
A lista de campos mostra um ícone para cada tipo:
| Ícone | Tipo | O que dá para fazer |
|---|---|---|
| # | Número | Somar, tirar média, mediana, mínimo, máximo, percentil, agrupar em faixas. |
| k | Texto exato (palavra-chave) | Agrupar, contar valores, filtrar pelo valor exato, contagem de valores únicos. |
| t | Texto livre | Buscar por palavras. Não serve para agrupar: use a versão .keyword. |
| Calendário | Data | Período, agrupamento por data, filtros de data. |
| Globo | Localização | Mapas, quando a coleta tem localização. |
Campos .keyword
Campos de texto podem aparecer em duplicidade, por exemplo regional e regional.keyword. A versão .keyword guarda o texto exato e é a que serve para agrupar (principais valores, separadores) e para controles do painel. A versão sem sufixo serve para buscar palavras dentro do texto.
O editor de gráficos costuma escolher a versão certa sozinho. Quando for escolher à mão, prefira .keyword para agrupar.
_asTextAlguns campos aparecem também numa versão com o sufixo _asText, que traz o conteúdo do mesmo campo em forma de texto. Para agrupar, filtrar e calcular, use o campo principal. Se os dois mostrarem valores diferentes, compare-os no Discover antes de escolher.
Rótulos e formatos dos campos
Na fonte de dados, cada campo pode ganhar um rótulo e um formato. Eles passam a valer em todos os gráficos, tabelas e no Discover, sem precisar ajustar gráfico por gráfico.
- Abra ☰ → Stack Management → Data Views e clique na fonte de dados.
- Na lista de campos, clique no lápis do campo.
- Ajuste as opções:
| Opção | O que faz | Exemplo |
|---|---|---|
| Set custom label | Mostra um nome legível no lugar do nome técnico | perc-total-5s → "5S Total (%)" |
| Set format | Define como o valor é exibido: número com casas decimais, percentual, duração, data, entre outros | Tempo em segundos exibido como "5 min 12 s" |
| Set popularity | Coloca o campo mais acima nas listas | Campos mais usados no topo |
- Clique em Save.
Use o rótulo da fonte de dados para os nomes que se repetem em todo lugar (os nomes das perguntas). Use o nome da métrica no gráfico para o que é específico daquele gráfico ("Média do mês", "Total acumulado"). Veja Formatação e estilo.
Campos novos que não aparecem
Um campo só aparece na fonte de dados depois que pelo menos uma coleta o contém. Depois de incluir uma pergunta no formulário:
- Confira se a pergunta tem nome e está marcada para exportação na integraç ão.
- Envie uma coleta de teste respondendo a pergunta.
- Recarregue a página do Discover ou do editor de gráficos.
Se o campo ainda não aparecer, confira se a coleta de teste chegou ao índice (veja Explorar os dados) e se o período selecionado inclui a data da coleta.
Editar e excluir
- Renomear uma fonte de dados não afeta os gráficos.
- Alterar o padrão de índices muda os dados de todos os gráficos que usam essa fonte de dados.
- Excluir uma fonte de dados quebra os gráficos e painéis que dependem dela. Antes de excluir, confira se ela não está em uso.