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 IACaminho 2: manual
O que você fazEscolhe a planilha. A IA cria campos, medidas, gráficos e o dashboard.Cria cada peça: cubo, medida, gráfico e dashboard.
ResultadoUm 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

ColunaO que temExemplo
dataO mês da venda, no primeiro dia2026-01-01
unidadeA unidade de negócio: Indústria, Varejo ou ServiçosVarejo
receitaA receita do mês, em reais1196351
custoO custo do mês682333
metaA meta de receita do mês1236560

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

  1. Abra Projetos e clique em Adicionar Projeto.

  2. Escolha Criar com IA, a opção marcada como Recomendado.

  3. 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

  1. Escolha o tipo CSV/Excel e clique em Próximo.

  2. 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.

  3. 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

  1. Abra Projetos, clique em Adicionar Projeto e escolha Projeto em branco.

  2. 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.

  1. No menu lateral do projeto, abra Cubos e clique no botão +.

  2. Clique em Criar Manualmente, escolha CSV/Excel e clique em Próximo.

  3. 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.

  4. 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.

  1. Abra a aba Mapeamento de Campos.

  2. 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.

  3. 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.

  1. Abra a aba Configurações de Medidas e clique em Adicionar Medida de Integração. A janela Criar Medida de Integração abre.

  2. Preencha Nome com “Receita” e Descrição com “Soma da receita por mês e unidade”.

  3. Escolha o Tipo de Agregação Soma, o Campo de Data Base data, o Campo de Valor receita e o Campo de Agrupamento unidade.

  4. 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

  1. No menu lateral do projeto, abra Gráficos, clique no botão + e escolha Gráfico. O editor abre numa aba nova.

  2. Escreva “Receita por mês” em Título do Gráfico.

  3. Clique em Adicionar nova Série. A janela Editar Série abre. Dê o nome “Receita” em Nome.

  4. Clique na área da fórmula e abra a aba Medidas.

  5. 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.

  6. Feche a lista de medidas clicando no nome da série e confira a prévia da fórmula: o resultado deve ser 6184875.

  7. Clique em Salvar. Em Design, escolha o tipo Gráfico de Colunas. A prévia mostra uma coluna para cada mês.

  8. 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.

  1. No menu lateral, abra Dashboards e clique no botão +. Dê o nome “Visão de vendas” e clique em Criar Dashboard.

  2. Clique em Nova Aba, escreva “Resumo” e aperte Enter. O Hubviz Studio já cria uma visão chamada Geral dentro da aba.

  3. Passe o mouse no botão redondo + do canto da tela e escolha Adicionar Gráfico.

  4. Na janela Selecionar Gráfico para Adicionar, abra o grupo Gráficos e clique em “Receita por mês”.

  5. 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:

  1. Com o projeto aberto, salve o que estiver com asterisco (*) no nome da aba.

  2. Clique no ícone Publicar na Web (seta para cima), na barra superior.

  3. 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.

  4. 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.com com 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 aconteceuCausaO que fazer
O botão Adicionar Medida de Integração está desabilitadoNenhum campo marcado, ou o cubo não foi salvoAbra Mapeamento de Campos, marque os campos e salve com Ctrl + S.
A lista de medidas do gráfico não abreFalta escolher o tipo de cálculoEscolha Saldo Atual antes da medida.
O gráfico mostra “Nenhum dado encontrado”O Hubviz Studio ainda processa os cubosEspere o aviso de processamento sumir da barra de baixo.
O dashboard novo está vazio e sem botõesFalta a abaClique em Nova Aba e nomeie a aba.
O dashboard não aparece no Hubviz WebAinda não publicou, ou o dashboard não foi compartilhado com um usuário visualizadorPublique 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 planilhaO período do calendário não cobre os 12 mesesAjuste o período no Hubviz Web. Veja Período e comparação.

Próximos passos