Passo a passo
Como conectar uma planilha Excel ou CSV ao HubCount BI Studio
Crie um cubo a partir de um arquivo Excel (.xlsx) ou CSV no HubCount BI Studio, confira os campos e prepare os dados para medidas e gráficos.
Crie um cubo a partir de uma planilha Excel (.xlsx) ou de um arquivo CSV no HubCount BI Studio, pronto para criar medidas e gráficos.
Quando usar
- Os dados saem de um sistema como planilha exportada, ou já são mantidos em Excel.
- Você quer testar o HubCount BI Studio rápido, antes de ligar um banco de dados ou uma API.
Se a planilha está no Google Drive, use Google Sheets: o cubo lê a versão mais recente sem você enviar arquivo.
Antes de começar, abra o projeto onde os dados vão ficar. Se ainda não tem um, crie em Projetos. Para ver como a conexão se encaixa nos outros tipos, leia Fontes de dados do HubCount BI Studio.
Criar o cubo a partir do arquivo
-
No menu lateral do projeto, abra Cubos e clique no botão +.
-
Clique em Criar Manualmente, escolha o tipo CSV/Excel e clique em Próximo.
-
Clique em Criar Nova Conexão e preencha Nome da conexão com um nome que a equipe reconheça, como “Vendas 2026”.
-
Em Caminho do Arquivo, clique no ícone de pasta e escolha o arquivo. O Tipo do Arquivo é preenchido sozinho a partir da extensão:
csvouxlsx. -
Em arquivos CSV, aparece o campo Delimitador. Informe o caractere que separa as colunas: ponto e vírgula (
;) é o mais comum em planilhas brasileiras, vírgula (,) em arquivos de sistemas em inglês. -
Clique em Salvar e depois em Próximo.
-
Dê um nome ao cubo em Nome do Cubo e clique em Finalizar.
O HubCount BI Studio lê o arquivo e abre o cubo na aba Editor de Consulta, com uma tabela dos dados.
Campos da conexão
| Campo | O que faz |
|---|---|
| Nome da conexão | Apelido da conexão. Obrigatório. |
| Armazenamento | Onde a conexão fica salva: Local (só neste computador) ou Nuvem (na nuvem HubCount, com acesso para quem você escolher). Veja onde a conexão fica salva. |
| Caminho do Arquivo | O arquivo escolhido. Obrigatório. Só aceita .csv e .xlsx: outras extensões são ignoradas ao escolher. |
| Tipo do Arquivo | Preenchido sozinho pela extensão. Não dá para editar. |
| Delimitador | Só em CSV. O separador das colunas, como ; ou ,. Em branco, vale a vírgula. |
No navegador, a janela avisa que o arquivo é enviado como uma cópia: se a planilha original mudar, envie de novo.
Barra do visualizador
No canto direito do visualizador de arquivo ficam quatro botões:
| Botão | O que faz |
|---|---|
| Alterar posição do mapeamento | Diz onde a tabela começa e se os campos estão nas colunas ou nas linhas (veja abaixo). |
| Abrir no explorador de arquivos | Abre a pasta do arquivo no seu computador. |
| Reprocessar campos mapeados | Lê os cabeçalhos do arquivo de novo. Os campos mapeados são refeitos. Os campos calculados ficam, mas você precisa marcar os campos de novo no mapeamento. |
| Atualizar arquivo | Escolhe o arquivo de novo (a versão nova ou outro arquivo .csv ou .xlsx) e recarrega os dados do cubo, mantendo a conexão. |
Tabela que não começa em A1
Se a planilha tem um título ou linhas em branco antes da tabela, clique em Alterar posição do mapeamento.
- Em Orientação dos dados, escolha Horizontal (campos nas colunas), o caso comum, ou Vertical (campos nas linhas), quando cada linha é um campo e os registros vão para a direita.
- Em Célula inicial, informe a célula do primeiro cabeçalho, como
B3. A prévia ajuda a achar a célula. - Clique em Confirmar mudanças do mapeamento.
Conferir os campos
Cada coluna da planilha vira um campo do cubo. Antes de criar medidas, abra a aba Mapeamento de Campos, confira o tipo de cada campo (datas como data, valores como número, nomes como texto) e clique em Salvar. Veja Campos do cubo.
Planilha com dados de várias empresas
No HubCount, o projeto pode ter empresas vinculadas. Se uma mesma planilha traz linhas de mais de uma empresa, marque a coluna que identifica a empresa com o tipo Id da Empresa na aba Mapeamento de Campos. Assim cada registro fica ligado à empresa certa. A lista de tipos de campo só oferece essa opção na HubCount. Veja Empresas do escritório no projeto e Campos do cubo.
Exemplo: a planilha de vendas da Aurora
A Contabilidade Exemplo monta o projeto “Resultado Comercial 2026” para o cliente Aurora Comércio Ltda. A planilha Vendas 2026 tem uma linha por mês e unidade:
| data | unidade | receita | custo | meta |
|---|---|---|---|---|
| 2026-01-01 | Indústria | 1527132 | 1027681 | 1620320 |
| 2026-01-01 | Varejo | 1196351 | 682333 | 1236560 |
| 2026-01-01 | Serviços | 795606 | 409670 | 835744 |
No mapeamento, data fica como data, unidade como texto e receita, custo e meta como número. Com o campo calculado lucro_bruto = receita - custo, o cubo está pronto para as medidas Receita, Custo, Meta e Lucro bruto. Veja Medidas.
Atualizar os dados quando o arquivo muda
| Onde você usa o HubCount BI Studio | Como atualizar |
|---|---|
| HubCount BI Studio instalado | O cubo lê o arquivo direto do seu computador. Salve a planilha e processe o cubo de novo. |
| Navegador | O arquivo foi enviado como uma cópia. Sempre que mudar a planilha original, envie de novo com Atualizar arquivo. |
Para o cubo atualizar sozinho, abra a aba Sincronização do cubo e escolha a frequência. Veja Atualização automática.
Um arquivo que só existe no seu computador atualiza pelo agendamento em Neste computador: o HubCount BI Studio instalado, ou o HubCount Sync Agent, precisa estar aberto no horário. Entenda a diferença entre as duas opções em Neste computador ou Nuvem HubCount e em Sync Agent.
Cuidados com a planilha
- Deixe os nomes das colunas na primeira linha da tabela, sem linhas em branco acima, ou use Alterar posição do mapeamento.
- Use uma aba por tipo de informação. Tabelas lado a lado na mesma aba atrapalham a leitura.
- Evite células mescladas e totais no meio dos dados. O HubCount BI Studio calcula os totais para você.
- Colunas com nomes repetidos atrapalham o mapeamento. Dê um nome único a cada coluna.