Como escolher e configurar os campos de um cubo no HubCount BI Studio

Escolha quais colunas da fonte entram no cubo, dê a cada uma um nome claro e diga o que ela é: uma data, um valor ou uma categoria. As medidas e os gráficos dependem dessa configuração.

Quando usar

• Logo depois de conectar uma fonte de dados e abrir o cubo pela primeira vez.
• Quando um gráfico trata um número como texto, ou uma data como categoria.
• Quando você quer trocar nomes técnicos (dt_emissao) por nomes que a equipe entende (“Data de emissão”).

Antes de começar, crie o cubo a partir de uma fonte, como uma planilha Excel ou CSV. A aba Mapeamento de Campos só abre depois que o cubo leu os dados pelo menos uma vez, ou quando ele já tem campos salvos.

Escolher os campos

Quando o cubo lê a fonte, cada coluna vira um campo, mas nenhum vem marcado. Só os campos marcados entram no cubo.

Cada campo marcado vira uma linha na tabela abaixo da lista e um “chip” dentro dela. Para tirar um campo do cubo, clique no x do chip ou desmarque o campo na lista.

Em fontes com dados aninhados, como uma API REST, os campos filhos aparecem sob o campo pai, com uma seta para abrir e fechar. O nome amigável deles mostra o caminho completo, como cliente > nome.

Configurar cada campo

A tabela mostra uma linha por campo marcado. Ela tem uma busca no topo e mostra 10 linhas por página.

Coluna	O que é	Editável
Campo	O nome técnico da coluna na fonte, em minúsculas e sem acento (receita, lucro_bruto). É ele que as fórmulas usam.	Não
Nome Amigável	O nome que aparece nas medidas, nos gráficos e nos filtros. Começa igual ao nome da coluna na fonte.	Sim
Descrição	Uma frase curta para quem for usar o cubo depois. Começa vazia.	Sim
Tipo de Campo	O papel do campo na análise. Veja a tabela abaixo.	Sim
Tipo do Valor	O formato do dado. As opções mudam conforme o tipo de campo.	Sim
Ações	Ordem, esconder, chave primária, e editar ou excluir (campo calculado).	Sim

O nome amigável e a descrição são gravados quando você sai do campo (clique fora ou aperte Tab).

Tipos de campo

O HubCount BI Studio escolhe um tipo para cada coluna olhando as primeiras linhas de dados. Datas viram Data, números e moedas viram Valor, e textos e verdadeiro/falso viram Categoria. Confira e corrija quando precisar.

Tipo	Para quê	Formatos do valor
Id	O identificador único de cada registro. Só um campo do cubo pode ser Id.	Texto ou Número
Id da Empresa	O identificador da empresa a que o registro pertence. Serve para separar os dados por empresa quando o projeto tem empresas vinculadas. Veja Id da Empresa.	Texto ou Número
Data	Datas e horários, como emissão, vencimento ou criação. As medidas usam uma data para distribuir o valor no tempo.	Data
Valor	Números que você soma, tira média ou compara, como receita ou quantidade.	Texto, Moeda, Número, Decimal ou Hora
Categoria	Textos com opções que se repetem, como unidade, status ou vendedor. Servem para agrupar e filtrar.	Texto, Número, Escolha Única ou Booleano
Itens	Listas de valores dentro de um registro, como as etiquetas de um pedido.	Lista, Escolha Única, Escolha Múltipla ou Moeda
Objeto	Objetos complexos, como um JSON com vários níveis. Em geral é o campo pai dos campos filhos.	Escolha Única
Relacionamentos	Campos que vêm de outro cubo por um relacionamento. Você não cria esse tipo à mão.	Texto

Ao trocar o tipo de campo, o formato do valor muda para o primeiro formato permitido, a não ser que o atual também seja permitido. Ao trocar um campo para Valor, se o nome dele começa com hora, duração, tempo ou minuto, o formato escolhido é Hora.

Id da Empresa

O tipo Id da Empresa é só da HubCount, porque o projeto pode ter empresas vinculadas. Ele marca a coluna que diz a que empresa cada registro pertence. Use quando os dados de várias empresas do escritório chegam no mesmo cubo, como um ERP que atende a carteira inteira ou um webhook que manda pedidos de empresas diferentes.

• Diferente do Id, o cubo pode ter mais de um campo marcado como Id da Empresa. A trava de “um campo só” vale apenas para o Id.
• Os formatos do valor são Texto ou Número, os mesmos do Id.
• Nos cubos do tipo Webhook, quando nenhum campo tem esse tipo, o editor mostra um aviso que você pode fechar: Adicione um campo do tipo Id da Empresa para separar os dados por empresa.
• Abaixo da tabela, uma legenda explica cada tipo de campo. A explicação de Id da Empresa só aparece na HubCount.

Para vincular as empresas ao projeto, veja Empresas do escritório no projeto. Para o passo a passo do webhook, veja Webhook.

Ações de cada linha

Os botões da coluna Ações mudam conforme o campo.

Botão	O que faz
Seta para cima e para baixo	Muda a posição do campo. A ordem vale para a tabela, os chips e as listas de campos do cubo. A seta fica desabilitada no primeiro e no último campo.
Esconder Campo / Mostrar Campo	Esconde o campo do diagrama do projeto e das colunas da tabela de dados, sem tirá-lo do cubo. Só existe em campos mapeados.
Definir como Chave Primária / Remover Chave Primária	Marca o campo como chave primária. Só existe em campos mapeados.
Editar Campo Calculado	Abre o campo calculado. Só existe em campos calculados.
Excluir Campo Calculado	Exclui o campo calculado. Só existe em campos calculados.

Chave primária

A chave primária é o campo que identifica cada registro. Ao marcar um campo como chave primária, o tipo dele vira Id e ele deixa de ficar escondido. Ao remover, o tipo volta para Valor.

• Só um campo pode ser a chave primária. Se já existe outra, o HubCount BI Studio abre a janela Alterar Chave Primária e pede confirmação.
• O tipo e a visibilidade da chave primária ficam travados. Para mudar, remova a chave primária antes.

Quando o cubo não tem data

Se nenhum campo for do tipo data, o HubCount BI Studio mostra um aviso no alto da aba com o botão Adicionar campo de data. Ele cria um campo calculado chamado “Data”, com a fórmula NOW(), que traz a data e hora do momento em que o cubo é processado. Use quando os dados não trazem uma data própria, porque as medidas precisam de um campo de data. Para dispensar o aviso, clique no x.

Exemplo: o cubo Vendas da Aurora

O cubo Vendas veio de um CSV com as colunas data, unidade, receita, custo e meta. Depois de ler o arquivo, o mapeamento fica assim:

Campo	Nome amigável	Tipo de campo	Tipo do valor
data	Data	Data	Data
unidade	Unidade	Categoria	Texto
receita	Receita	Valor	Número
custo	Custo	Valor	Número
meta	Meta	Valor	Número

Marque os cinco campos, troque o formato de receita, custo e meta para Moeda se quiser ver valores em reais, e salve. O próximo passo é criar o campo calculado lucro_bruto com campos calculados.

Mensagens e limites

Mensagem	Causa e solução
O tipo selecionado não é compatível com os dados do campo.	O HubCount BI Studio olhou os dados lidos e eles não cabem no tipo. Valor exige números, Data exige datas e Itens exige listas. Escolha outro tipo ou corrija a coluna na fonte.
Apenas um campo pode ter o tipo ‘Id’.	Já existe um campo Id. Troque o tipo do outro campo antes.
O tipo da chave primária não pode ser alterado.	Remova a chave primária para mudar o tipo.
O campo chave primária não pode ser ocultado.	Remova a chave primária para esconder o campo.
O cubo tem mais de um campo com o mesmo nome	Duas colunas viraram o mesmo nome técnico. Renomeie uma delas na fonte. Em bancos de dados, use apelidos (AS) na consulta SQL.
Cubo não salvo. Por favor, salve o cubo primeiro para criar uma medida.	Salve o cubo antes de abrir a aba de medidas.

• A aba Mapeamento de Campos fica desabilitada enquanto o cubo não leu a fonte e não tem campos salvos.
• Se você relê a fonte e uma coluna some, o campo dela sai do cubo. Campos calculados e de relacionamento ficam.
• Se uma coluna do arquivo muda de nome, o HubCount BI Studio a trata como um campo novo. Marque o novo e refaça as medidas que usavam o antigo.

Próximos passos

• Crie colunas novas a partir das existentes com campos calculados.
• Ligue este cubo a outro com relacionamentos.
• Calcule os números do dashboard com medidas.