Passo a passo

Como criar variáveis e lançar valores no HubCount BI

Crie variáveis da empresa e variáveis globais, lance valores pela tela ou por planilha Excel e use as variáveis nas fórmulas dos gráficos.

Variáveis são números que não vêm do balancete, como quantidade de clientes, metas ou indicadores operacionais. Você cria a variável, lança os valores mês a mês e usa o resultado em fórmulas, gráficos e indicadores. Esta página mostra como criar, lançar valores, importar por planilha e usar nas fórmulas.

Antes de começar

O cartão Variáveis do Data Lake só aparece para quem tem a autorização Variáveis.
Para criar variáveis, é preciso a autorização Adicionar variável.
Para editar dados e valores, ou excluir, a autorização Editar variável.
Para subir valores por planilha, a autorização Upload de variável.
Em um grupo de empresas, a tela é só de consulta: os botões de criação, upload e exclusão não aparecem.

Variáveis da empresa e variáveis globais

	Variáveis	Variáveis Globais
Estrutura	Pertence a uma empresa.	Compartilhada entre todas as empresas do escritório.
Valores	Da empresa.	Individuais por empresa: cada empresa lança os seus.
Departamento	Pode ser vinculada a um.	Não tem vínculo com departamento.
Quando usar	Dado que só existe nessa empresa.	Um modelo de indicadores que se repete em várias empresas.

A variável tem hierarquia. A primeira é a variável raiz. Dentro dela você cria variáveis filhas, e dentro das filhas, outras. O valor de uma variável pai é a soma das filhas, por isso você só digita valores nas variáveis que não têm filhas. O código da variável é montado sozinho a partir da posição na hierarquia.

Abrir as variáveis

No Data Lake da empresa, clique em Configurar no cartão Variáveis. O caminho até o Data Lake está em Data Lake.
A janela abre com duas abas: Variáveis e Variáveis Globais. Escolha a que você vai usar.
A tabela mostra #, Ações, Código, Nome, Tipo, Comportamento ao Somar e uma coluna para cada mês com valor. Use a seta ao lado de uma variável para abrir as filhas.

Botões do topo

Botão	O que faz
Adicionar Variáveis por Excel	Cria várias variáveis de uma vez por planilha.
Adicionar Variável Raiz	Cria uma variável raiz.
Upload de Valores das Variáveis (ou Upload de Valores das Variáveis Globais na aba global)	Sobe valores de várias variáveis e meses por planilha.
Deletar em Lote	Exclui as variáveis marcadas.

Em cada linha, as ações são: Adicionar Variável Filha, Editar valores da variável, Editar dados da variável e Deletar Variável.

Criar uma variável

Clique em Adicionar Variável Raiz, ou no botão Adicionar Variável Filha da linha de uma variável existente.
Em Nome da variável, digite o nome. É obrigatório e não pode se repetir entre variáveis do mesmo nível.
Em Tipo da Variável, escolha Unidade (quantidades) ou Moeda (valores em reais).
Em Comportamento de agregação de dados, escolha como o HubCount junta os meses quando o BI usa um período maior que o mês.
Na aba de variáveis da empresa, você pode escolher Vincular departamento (ou Vincular centro de custo) para ligar a variável a um departamento. Na aba global, o campo não existe.
Clique em Salvar. A tela mostra Variável criada com sucesso!.

Comportamento de agregação

Esse campo vale quando você muda a periodicidade do BI, por exemplo para bimestral ou semestral.

Opção	O que o HubCount faz com os meses do período
Soma	Soma os valores. Use em faturamento, quantidade de vendas, horas.
Média	Divide a soma pelo número de meses do período. Use em preços e taxas médias.
Último valor	Usa o valor do último mês do período. Use em posição de estoque, número de clientes, saldos.

Ao criar uma variável filha, ela herda o tipo e o comportamento de agregação do pai, e esses dois campos ficam travados.

Regras

Ao criar, o nome não pode se repetir entre variáveis do mesmo pai. A tela mostra Já existe uma variável com o nome X cadastrada!
Ao editar uma filha, os campos de tipo e de comportamento ficam livres, e o HubCount não replica a mudança nas outras variáveis da árvore. Mantenha os dois iguais aos do pai.
Na lista, a variável pai mostra a soma das filhas. A edição do valor do pai fica desativada, com a dica Os valores das variáveis pais são a soma das variáveis filhas, por isso não é possível editar o valor.

Lançar valores pela tela

Na linha da variável (sem filhas), clique em Editar valores da variável.
Escolha a periodicidade: Mensal para mensal ou Diário para diário.
Escolha o ano (mensal) ou o mês (diário) no seletor de período. A janela mostra um campo para cada mês ou cada dia.
Digite os valores.
Clique em Salvar. Se algum mês já tinha valor, o HubCount pergunta Para o(s) mês(es) informados, já existem valores cadastrados. Ao continuar, os dados existentes do(s) mês(es) serão substituídos. Deseja prosseguir? Confirme para substituir.
A tela mostra Salvo com sucesso!.

Trocar entre mensal e diário zera os campos que você já digitou na janela.

Subir valores por planilha

Use a planilha para lançar muitas variáveis e muitos meses de uma vez.

Clique em Upload de Valores das Variáveis (ou Upload de Valores das Variáveis Globais). Se você marcou variáveis na tabela antes, a janela já abre com elas selecionadas.
No passo Selecione o Período, escolha Diário ou Mensal e marque no calendário o primeiro e o último período. O calendário começa em 2009.
No passo Selecionar variáveis, escolha as variáveis. A lista traz só as que não têm filhas.
No passo Exportar modelo, clique em Baixar modelo. O modelo vem com uma linha por variável e uma coluna por período.
Preencha os valores no modelo, sem mudar os códigos nem os cabeçalhos.
No passo Selecione o(s) arquivo(s), envie o arquivo .xlsx. A janela vai para o passo Pronto.
Clique em Salvar. Se algum período já tinha valor, o HubCount avisa com Para o(s) mês(es) informados, já existem valores cadastrados. Ao continuar, os dados existentes do(s) mês(es) serão substituídos. Deseja prosseguir? e só substitui se você confirmar.
Aguarde a mensagem Dados salvos com sucesso!.

Janela Upload de Valores das Variáveis no passo Selecionar variáveis, com três variáveis marcadas em chips e o botão Próximo passo

Mensagens do envio de valores

O servidor junta os problemas da planilha em uma mensagem única que começa com Não foi possível importar a planilha, verifique os erros:. Os itens possíveis são:

Item	O que fazer
Data menor que o limite disponível (2009). Por favor, verifique sua planilha.	Corrija a data do cabeçalho. O limite é 01/2009.
Layout parece não estar correto. Verifique sua planilha (linha N).	A linha N não segue o modelo. Baixe o modelo de novo e copie os valores.
Variável na linha N com código X não encontrada. Verifique sua planilha.	O código da variável mudou ou foi apagado. Baixe o modelo atualizado.
Linha N, coluna M: seguido do valor	O valor da célula não é um número. Use o formato numérico em português, com vírgula nos decimais.

Criar variáveis por planilha

Use quando a estrutura tem muitas variáveis e níveis.

Clique em Adicionar Variáveis por Excel. A janela abre com o título Upload de Variáveis.
No passo Exportar modelo, clique em Baixar modelo e baixe o modelo.
Preencha uma variável por linha, a partir da linha 15. As colunas são, na ordem: nome, tipo, comportamento de agregação, departamento e nível.
No passo Selecione o(s) arquivo(s), envie o arquivo. A janela vai para Pronto.
Clique em Salvar. A tela mostra Dados salvos com sucesso!.

Como preencher as colunas

Coluna	O que escrever
Nome	O nome da variável. Linhas sem nome são ignoradas.
Tipo	`Moeda` ou `Unidade`.
Comportamento de agregação	`Soma`, `Média` ou `Último valor`. Acentos e maiúsculas não importam.
Departamento	O nome exato de um departamento da empresa. Opcional. Ignorado na aba de variáveis globais.
Nível	`1` para variável raiz, `2` para filha da última variável de nível 1, e assim por diante.

O nível de uma variável só vale se o nível acima dela apareceu antes na planilha. Uma filha precisa ter o mesmo tipo e o mesmo comportamento de agregação do pai.

Erros da planilha de variáveis

O HubCount aponta cada problema de leitura da planilha com a linha. Se a janela fechar e nenhuma variável aparecer, confira a lista abaixo e envie o arquivo corrigido.

Erro	Causa
Erro na linha N: Nível inválido.	A coluna de nível não é um número.
Erro na linha N: O nível X não pode ser adicionado sem que o nível Y esteja preenchido.	A planilha pulou um nível. Coloque a variável pai antes.
Erro na linha N: Tipo de variável ‘X’ não reconhecido.	Use `Moeda` ou `Unidade`.
Erro na linha N: Tipo de agregação ‘X’ não reconhecido.	Use `Soma`, `Média` ou `Último valor`.
Erro na linha N: Departamento ‘X’ não encontrado.	O nome do departamento não existe na empresa. Veja Centros de custo e departamentos.
Erro na linha N: O tipo da variável não corresponde ao tipo da variável pai.	A filha tem de ter o mesmo tipo do pai.
Erro na linha N: O tipo de agregação não corresponde ao tipo de agregação do pai.	A filha tem de ter o mesmo comportamento do pai.
Não foi possível importar o arquivo, por favor verifique o Layout ou contate nosso SUPORTE	O arquivo não é uma planilha Excel, ou está vazio antes da linha 15.

Editar, excluir e variáveis órfãs

Editar dados. Em Editar dados da variável, mude o nome, o tipo ou a agregação de uma variável. A tela mostra Variável atualizada com sucesso!.
Excluir uma variável. Em Deletar Variável, a confirmação mostra o nome e avisa quando há variáveis filhas. A tela mostra Variável deletada com sucesso!.
Excluir em lote. Marque as variáveis e clique em Deletar em Lote. Marcar um pai marca as filhas dele. A confirmação é Tem certeza de que deseja remover as variáveis selecionadas? Se houver variáveis filhas associadas, todas elas serão removidas automaticamente. Se a seleção deixar filhas de fora, o servidor recusa com Existem variáveis filhas que não foram selecionadas para exclusão. Operação abortada.
Variáveis órfãs. Filhas cuja raiz foi removida geram o aviso do dashboard descrito em Validações de dados. A mesma janela de exclusão abre sozinha ao entrar nas variáveis.

Usar as variáveis nas fórmulas

Variáveis aparecem no editor de fórmulas dos gráficos e dos indicadores.

No editor de fórmulas, escolha o tipo Variável Customizada. A dica explica: Adiciona um valor de uma variável personalizada na fórmula.
Em Tipo de cálculo, escolha Saldo Atual ou Movimentação. São os dois tipos que o editor libera para variáveis.
Em Selecione a Variável, procure a variável pelo código e pelo nome. A lista separa Variável da Empresa e Variáveis Globais.
Combine com contas contábeis, folha ou outras variáveis, como em qualquer fórmula.

O passo a passo do editor está em Fórmulas. Variáveis também podem receber orçamento. Veja Orçamento e cenários.

Exemplo: indicadores da Aurora

A Contabilidade Exemplo quer mostrar o ticket médio da Aurora Comércio Ltda no dashboard.

Etapa	O que a Contabilidade Exemplo faz
Estrutura	Cria a variável raiz Atendimentos, tipo Unidade, agregação Soma, com duas filhas: Loja Centro e Online.
Valores	Lança os atendimentos de 01/2026 a 09/2026 por planilha, só nas filhas. A raiz mostra a soma.
Fórmula	Em um gráfico, divide a receita contábil por Atendimentos, escolhendo o tipo Variável Customizada.
Para outras empresas	Cria a mesma estrutura como variável global, e cada empresa lança os seus valores.

Problemas comuns

O nome da variável é obrigatório

O campo de nome está vazio. Preencha e salve.

O tipo da variável é obrigatório

Escolha Unidade ou Moeda.

O comportamento de agregação é obrigatório

Escolha Soma, Média ou Último valor.

Erro ao criar variável

A criação falhou. Confira se o nome já existe no mesmo nível e tente de novo.

Erro ao editar variável

A edição falhou. Recarregue a página e tente de novo.

Erro ao deletar variável

A exclusão falhou. Tente de novo. Se continuar, fale com o suporte.

Selecione ao menos um arquivo!

Você clicou em Salvar sem enviar a planilha. Volte ao passo Selecione o(s) arquivo(s).

Preencha as informações

O envio de valores precisa de ao menos uma variável escolhida no passo Selecionar variáveis.

Não consigo editar o valor de uma variável pai

É esperado. O pai mostra a soma das filhas. Lance os valores nas filhas.