Como criar medidas para os gráficos no HubCount BI Studio

A medida é o número que o gráfico mostra: receita, quantidade de pedidos, custo. Ela pega um campo do cubo, aplica um cálculo (soma, média, contagem) e distribui o resultado no tempo pelo campo de data.

Quando usar

• Antes de montar um gráfico ou uma tabela: gráficos de colunas, linhas e cartões leem medidas.
• Quando o mesmo número aparece em vários gráficos. Crie a medida uma vez e reuse.
• Quando o número precisa de um recorte fixo, como “Receita do Varejo” ou “Pedidos cancelados”.

Antes de começar:

• Escolha e salve os campos do cubo, com pelo menos um campo de data. Veja Campos do cubo.
• Se precisa de uma conta linha a linha (lucro, margem), crie antes um campo calculado.
• Salve o cubo. Sem campos escolhidos e salvos, o HubCount BI Studio mostra: Para criar medidas, primeiro selecione os campos desejados no mapeamento e depois salve o cubo..

Criar a medida

A medida aparece na lista da aba. A coluna Gráficos relacionados mostra quantos gráficos usam cada medida.

Opções do formulário

Campo	O que faz	Regras
Nome	O nome da medida nos gráficos e no editor.	Obrigatório. De 3 a 50 caracteres.
Descrição	Uma frase para quem for usar a medida.	Até 200 caracteres.
Tipo de Agregação	O cálculo que junta os valores de cada período.	Obrigatório.
Campo de Data Base	A data que coloca cada linha no seu período (dia, mês, ano).	Obrigatório. Só campos com formato data.
Campo de Valor	O campo que o cálculo soma, conta ou compara.	Obrigatório, menos nos tipos marcados como opcional abaixo. A lista agrupa os campos por formato (Número, Decimal, Moeda e outros).
Campo de Agrupamento	Quebra o resultado por categoria, como uma série para cada unidade.	Opcional.
Filtros de Dados	Limita as linhas que entram no cálculo.	Opcional. Veja abaixo.

Os campos de relacionamento e os campos calculados aparecem nas listas como qualquer outro campo, desde que estejam marcados no mapeamento.

Tipos de agregação

Passe o mouse sobre um tipo na lista para ler a descrição dele.

Tipo	O que faz	Campo de valor
Soma	Soma todos os valores do período.	Obrigatório
Média	Calcula a média dos valores do período.	Obrigatório
Contagem	Conta os valores do período ignorando duplicados.	Opcional
Máximo	Retorna o maior valor encontrado no período.	Obrigatório
Mínimo	Retorna o menor valor encontrado no período.	Obrigatório
Contagem (Média)	Calcula a média dos valores dentro de cada período exibido.	Opcional
Contagem (Último Registro)	Conta quantos registros existem no último dia do período.	Opcional
Soma (Último Registro)	Soma o último valor de cada dia dentro do período.	Obrigatório
Contagem (Primeiro Registro)	Retorna o valor do primeiro registro do período.	Opcional
Valor do último registro	Retorna o valor do último registro do período.	Opcional

Como escolher:

• Valor que se acumula no período (receita, custo, quantidade vendida): Soma.
• Valor típico (ticket médio, prazo médio): Média.
• Quantos registros existem (pedidos, clientes): Contagem. Valores repetidos contam uma vez, e o HubCount BI Studio avisa disso ao escolher o tipo.
• Maior e menor valor (maior venda, menor estoque): Máximo e Mínimo.
• Saldos e posições (estoque, base de clientes, carteira): os tipos “Último Registro”, que olham o fim do período em vez de somar tudo.

Filtrar os dados da medida

Use filtros quando a medida deve considerar só parte das linhas, como “Receita do Varejo” ou “Pedidos cancelados”.

O campo de valor muda conforme o formato do campo escolhido.

Formato do campo	Campo de valor	Observações
Texto	Caixa de texto com sugestões	As sugestões vêm dos valores lidos no cubo (até 50 por vez). Você pode digitar um valor que não está na lista.
Número, Decimal, Moeda	Número	Digite só o número, com ponto decimal.
Booleano	Verdadeiro ou Falso
Data	Editor de data (veja abaixo)	As comparações mudam para as de data.

Comparações

Para campos que não são de data, a lista vem do servidor da HubCount. Ela traz:

Igual, Maior, Maior ou Igual, Menor, Menor ou Igual, Diferente, Contém, Não Contém, Inicia com, Termina com, Diferente (Meses), Entre e Não está entre.

Para campos de data, a lista é É igual a, É diferente de, É posterior a, É igual ou posterior a, É anterior a, É igual ou anterior a, Está entre e Não está entre.

Filtro de data

Em Tipo de data, escolha como informar a data:

Tipo	Como funciona	Exemplo
Data exata	Uma data fixa do calendário.	01/01/2026
Data relativa	Uma quantidade de dias, semanas, meses ou anos antes ou depois de hoje. Muda sozinha a cada dia.	30 dias antes de hoje
Período	Um período pronto: hoje, ontem, esta semana, este mês, este trimestre, este ano e outros, incluindo “até hoje”, “passado” e “próximo”.	Este trimestre até hoje
Intervalo	Do início ao fim. Use com Está entre ou Não está entre.	De 01/01/2026 a 31/03/2026

O editor mostra o período resolvido, para você conferir as datas reais.

Medida de uma empresa só

No HubCount, o projeto pode ter empresas vinculadas, e os dados de várias empresas podem estar no mesmo cubo. Um campo marcado como Id da Empresa no mapeamento aparece na lista Campo para Filtrar como os demais campos (com o formato Texto ou Número). Use-o num filtro, por exemplo empresa_id Igual ao identificador da empresa, para criar uma medida que considera só uma empresa. Veja Campos do cubo.

Conferir a prévia

O lado direito da janela mostra o resultado da medida com os dados do cubo. Ele se atualiza sozinho, cerca de um segundo depois da última mudança.

Aba	O que mostra
Preview do Gráfico	O gráfico da medida por período. Se há campo de agrupamento, uma série por categoria.
Preview dos Dados Processados	A tabela com os valores calculados.
Preview dos Dados Brutos	As linhas do cubo que entraram no cálculo, com paginação.
Ícone de alerta	Aparece quando a prévia encontra problemas nos dados, como datas inválidas. Abra para ver os avisos agrupados e as linhas de origem.

• A prévia usa só os primeiros registros (no máximo 5.000), por isso totais de cubos grandes podem diferir do gráfico final.
• O botão com o calendário, no canto inferior esquerdo, muda o período da prévia. Ele é o mesmo período do projeto no HubCount BI Studio.
• Campos de formato Hora aparecem como duração.

Editar como texto

A aba Avançado mostra a mesma medida escrita como texto. O que você muda num lado aparece no outro.

DEFINE MEASURE "Receita do Varejo"
DESCRIPTION "Receita só da unidade Varejo"

AGGREGATE Soma ON receita
BY data
GROUP BY unidade

FILTER BY
  "Filtro 1" WHERE
    unidade Igual "Varejo"

Linha	O que define
DEFINE MEASURE e DESCRIPTION	O nome e a descrição.
AGGREGATE tipo ON campo	O tipo de agregação e o campo de valor (none quando não há).
BY campo	O campo de data base.
GROUP BY campo	O campo de agrupamento. Omita para não agrupar.
FILTER BY	Os filtros. Cada bloco tem um nome e um WHERE. Condições de um mesmo bloco ficam ligadas por AND. Blocos ficam separados por OR.

O texto usa os nomes técnicos dos campos, o nome do tipo de agregação e o nome da comparação como aparecem nas listas, e os valores entre aspas duplas. A aba mostra sugestões de palavras e de campos enquanto você digita. Se o texto estiver com erro, a aba mostra a mensagem de sintaxe e a prévia espera.

Gerenciar as medidas do cubo

A lista da aba Configurações de Medidas tem busca por nome, descrição ou ID e uma linha por medida.

Coluna ou botão	O que faz
Nome da medida	O nome e a descrição.
Agregação	O tipo de agregação escolhido.
Gráficos relacionados	Quantos gráficos usam a medida. Clique para ver quais.
Editar	Abre a medida.
Duplicar	Cria uma cópia, com um sufixo no nome. Fica desabilitado enquanto o cubo não tem campos escolhidos.
Excluir medida de integração	Exclui a medida.
Caixas de seleção	Selecione várias medidas para excluir de uma vez com Excluir selecionadas.

Ao excluir uma medida usada por gráficos, o HubCount BI Studio avisa que os gráficos poderão deixar de funcionar. Troque a medida nos gráficos antes de excluir.

Na janela da medida, a seção Medidas Recentes lista as últimas medidas do cubo. Clique em Carregar para partir de uma delas.

Exemplo: as medidas do cubo Vendas

O cubo Vendas da Aurora Comércio Ltda, no projeto “Resultado Comercial 2026” da Contabilidade Exemplo (campos data, unidade, receita, custo, meta e o calculado lucro_bruto) tem quatro medidas, todas com Soma, data base data e agrupamento por unidade:

Medida	Campo de valor
Receita	receita
Custo	custo
Meta	meta
Lucro bruto	lucro_bruto

Para um número só do Varejo, crie “Receita do Varejo”: mesma configuração de Receita, com um filtro Campo para Filtrar Unidade, Comparação Igual, valor Varejo. Para saber quantas linhas de venda existem por mês, crie “Registros de venda” com Contagem.

Mensagens e limites

Mensagem	Causa e solução
Nome da medida deve ter pelo menos 3 caracteres	Use um nome mais descritivo.
Nome da medida não pode ter mais de 50 caracteres	Encurte o nome.
Descrição não pode ter mais de 200 caracteres	Encurte a descrição.
Tipo de agregação é obrigatório	Escolha um tipo na lista.
Campo de data é obrigatório	Escolha o campo de data base.
Campo de data deve ser do tipo data	O campo escolhido não tem formato data. Ajuste o formato em Campos do cubo.
Campo de valor é obrigatório para este tipo de agregação	Escolha o campo de valor, ou troque por um tipo de contagem.
Nome do filtro é obrigatório, Campo do filtro é obrigatório, Operador de comparação é obrigatório, Valor do filtro é obrigatório	Preencha todos os campos de cada condição do filtro.
Alguns filtros contêm campos que não existem mais. Por favor, revise os filtros antes de salvar.	Um campo usado no filtro saiu do mapeamento. Escolha outro campo.
Cubo não salvo. Por favor, salve o cubo primeiro para criar uma medida.	Salve o cubo (Ctrl + S) e tente de novo.
Nenhum campo mapeado. Por favor, mapeie os campos primeiro para criar uma medida.	Escolha os campos na aba Mapeamento de Campos.

Próximos passos

• Use a medida num gráfico com Montar um dashboard e Editor de gráfico.
• Crie filtros que o leitor controla no dashboard com Filtros.