Tutorial
Como criar seu primeiro dashboard no Hubviz
Tutorial do zero ao dashboard publicado: crie um projeto, conecte uma planilha e deixe a IA montar o dashboard, ou monte cada peça você mesmo.
No fim deste tutorial você terá um projeto com os dados de uma planilha de vendas e um dashboard publicado no Hubviz Web, pronto para a equipe abrir. Leva cerca de 15 minutos no caminho manual e menos no caminho com IA.
Há dois caminhos para chegar lá. Escolha um, ou faça os dois em projetos diferentes para comparar.
| Caminho 1: com IA | Caminho 2: manual | |
|---|---|---|
| O que você faz | Escolhe a planilha. A IA cria campos, medidas, gráficos e o dashboard. | Cria cada peça: cubo, medida, gráfico e dashboard. |
| Resultado | Um dashboard completo, que muda a cada execução. | Um gráfico, igual ao descrito aqui, para você ampliar. |
| Para quem é | Quem quer uma primeira versão rápida. | Quem quer entender como as peças se encaixam. |
Antes de começar
- Abra o Hubviz Studio e entre. Veja Abrir o Hubviz Studio.
- Baixe a planilha de exemplo: vendas-aurora-2026.csv. Ela é da empresa fictícia Aurora e tem 36 linhas, uma por mês e unidade de negócio.
| Coluna | O que tem | Exemplo |
|---|---|---|
| data | O mês da venda, no primeiro dia | 2026-01-01 |
| unidade | A unidade de negócio: Indústria, Varejo ou Serviços | Varejo |
| receita | A receita do mês, em reais | 1196351 |
| custo | O custo do mês | 682333 |
| meta | A meta de receita do mês | 1236560 |
Para conferir os números no fim, use estes totais da planilha: a receita de janeiro de 2026, somando as três unidades, é R$ 3.519.089. A de dezembro é R$ 6.184.875 (Indústria 2.754.258, Varejo 2.086.229 e Serviços 1.344.388).
Caminho 1: com IA
1. Crie o projeto
-
Abra Projetos e clique em Adicionar Projeto.
-
Escolha Criar com IA, a opção marcada como Recomendado.
-
Preencha o Nome como “Vendas 2026” e a Descrição como “Receita, custo e meta por unidade de negócio”. Clique em Próximo.
2. Conecte a planilha
-
Escolha o tipo CSV/Excel e clique em Próximo.
-
Clique em Criar Nova Conexão. Preencha Nome da conexão com “Planilha de vendas”, escolha o arquivo baixado em Caminho do Arquivo (clique no ícone de pasta) e clique em Salvar.
-
Clique em Próximo. Dê o nome “Vendas” ao cubo em Nome do Cubo e clique em Finalizar.
3. Acompanhe a IA trabalhar
A janela Criando com IA mostra cada etapa: configurar o cubo, mapear os campos, criar as medidas, gerar os gráficos, montar o dashboard e os ajustes finais. Espere até ela fechar.
Quando acabar, o projeto abre no dashboard criado. Ele tem um cubo com os campos da planilha, medidas, gráficos e um dashboard em Dashboards.
Quer mudar algo? Peça ao assistente, por exemplo: “troque a rosca por colunas” ou “crie um cartão com a meta do mês”. Veja o assistente de IA. Você também pode editar cada gráfico à mão.
Siga para Publique o dashboard.
Caminho 2: manual
1. Crie o projeto
-
Abra Projetos, clique em Adicionar Projeto e escolha Projeto em branco.
-
Preencha o Nome como “Vendas 2026” e clique em Criar. O projeto abre na aba de configurações, com o menu lateral de cubos, gráficos e dashboards.
2. Crie o cubo a partir da planilha
O cubo lê a planilha e organiza as colunas em campos.
-
No menu lateral do projeto, abra Cubos e clique no botão +.
-
Clique em Criar Manualmente, escolha CSV/Excel e clique em Próximo.
-
Clique em Criar Nova Conexão, preencha Nome da conexão com “Planilha de vendas” e escolha o arquivo em Caminho do Arquivo. O Tipo do Arquivo aparece sozinho, e o Delimitador pode ficar em branco, porque o arquivo usa vírgula.
-
Clique em Salvar e em Próximo. Dê o nome “Vendas” ao cubo em Nome do Cubo e clique em Finalizar.
O cubo abre no editor de consulta, com a tabela de dados da planilha. Confira se as cinco colunas e as linhas estão lá.
3. Confira os campos
Cada coluna virou um campo. Só os campos marcados entram nas medidas.
-
Abra a aba Mapeamento de Campos.
-
Clique na lista Selecione os campos. Os cinco campos já vêm marcados, e Selecionar todos os campos aparece marcado. Se algum campo estiver sem marca, marque.
-
Feche a lista. O campo
dataé do tipo data,unidadeé categoria e os outros três são valores. Veja Campos do cubo se precisar corrigir um tipo.
4. Crie a medida
A medida é o número que o gráfico mostra. Aqui, a soma da receita.
-
Abra a aba Configurações de Medidas e clique em Adicionar Medida de Integração. A janela Criar Medida de Integração abre.
-
Preencha Nome com “Receita” e Descrição com “Soma da receita por mês e unidade”.
-
Escolha o Tipo de Agregação Soma, o Campo de Data Base
data, o Campo de Valorreceitae o Campo de Agrupamentounidade. -
Confira a prévia à direita: a última coluna deve marcar 6.184.875, o total de dezembro. Clique em Salvar.
O agrupamento por unidade é opcional, mas é ele que permite abrir o gráfico por unidade depois (o drilldown). Veja Medidas para as outras opções.
5. Crie o gráfico
-
No menu lateral do projeto, abra Gráficos, clique no botão + e escolha Gráfico. O editor abre numa aba nova.
-
Escreva “Receita por mês” em Título do Gráfico.
-
Clique em Adicionar nova Série. A janela Editar Série abre. Dê o nome “Receita” em Nome.
-
Clique na área da fórmula e abra a aba Medidas.
-
Escolha o Tipo de Cálculo para a Fórmula Saldo Atual, que traz o valor do próprio mês. Depois escolha, em Medida, a medida
Vendas - Receita(cubo e medida, nessa ordem). A lista só libera a medida depois que você escolhe o tipo de cálculo. -
Feche a lista de medidas clicando no nome da série e confira a prévia da fórmula: o resultado deve ser 6184875.
-
Clique em Salvar. Em Design, escolha o tipo Gráfico de Colunas. A prévia mostra uma coluna para cada mês.
-
Salve a aba com Ctrl + S.
6. Monte o dashboard
Um dashboard novo começa vazio. Antes de colocar um gráfico, crie uma aba.
-
No menu lateral, abra Dashboards e clique no botão +. Dê o nome “Visão de vendas” e clique em Criar Dashboard.
-
Clique em Nova Aba, escreva “Resumo” e aperte Enter. O Hubviz Studio já cria uma visão chamada Geral dentro da aba.
-
Passe o mouse no botão redondo + do canto da tela e escolha Adicionar Gráfico.
-
Na janela Selecionar Gráfico para Adicionar, abra o grupo Gráficos e clique em “Receita por mês”.
-
O gráfico entra no dashboard. Arraste para mudar a posição e o canto inferior direito para mudar o tamanho. Salve com Ctrl + S.
Para ver como o leitor vai ver, troque Editar para Ver no topo do dashboard. Veja mais em Como montar um dashboard.
Publique o dashboard
Até aqui, os dados estão só no seu Hubviz Studio. Para a equipe ver:
-
Com o projeto aberto, salve o que estiver com asterisco (*) no nome da aba.
-
Clique no ícone Publicar na Web (seta para cima), na barra superior.
-
Espere o envio terminar. O ícone mostra um círculo girando enquanto o Hubviz Studio processa e envia os dados. Quando aparecer Publicação concluída, clique em Abrir dashboard agora.
-
No Hubviz Web, abra o projeto e o dashboard. Você também chega lá pelo ícone Abrir dashboard web da barra superior, ou entrando em
web.hubviz.comcom o mesmo Google.
No Hubviz Web, o dashboard aparece com os mesmos gráficos, e quem lê muda o período e filtra.
Veja os limites de armazenamento e o que fazer quando o envio falha em Como publicar no Hubviz Web.
Conferir
- O cubo abre com as cinco colunas da planilha.
- A medida Receita mostra 6.184.875 no último mês.
- O gráfico tem uma coluna por mês, de janeiro a dezembro de 2026.
- No Hubviz Web, o dashboard abre com o mesmo gráfico.
Problemas comuns
| O que aconteceu | Causa | O que fazer |
|---|---|---|
| O botão Adicionar Medida de Integração está desabilitado | Nenhum campo marcado, ou o cubo não foi salvo | Abra Mapeamento de Campos, marque os campos e salve com Ctrl + S. |
| A lista de medidas do gráfico não abre | Falta escolher o tipo de cálculo | Escolha Saldo Atual antes da medida. |
| O gráfico mostra “Nenhum dado encontrado” | O Hubviz Studio ainda processa os cubos | Espere o aviso de processamento sumir da barra de baixo. |
| O dashboard novo está vazio e sem botões | Falta a aba | Clique em Nova Aba e nomeie a aba. |
| O dashboard não aparece no Hubviz Web | Ainda não publicou, ou o dashboard não foi compartilhado com um usuário visualizador | Publique de novo. Se a pessoa é visualizadora, quem administra o workspace precisa compartilhar o dashboard com ela. |
| Os números do Hubviz Web não batem com a planilha | O período do calendário não cobre os 12 meses | Ajuste o período no Hubviz Web. Veja Período e comparação. |
Próximos passos
- Chame a equipe: Convidar a equipe.
- Entenda as peças com calma em Conceitos.
- Atualize os dados sozinho: Atualização automática.