Passo a passo
Como criar medidas e variáveis de integração na Customização
Crie uma medida sobre os dados de uma integração: escolha o cubo, a agregação, os campos e os filtros, duplique medidas de fábrica e use na fórmula.
No fim desta página você terá uma variável de integração (chamada de medida no editor), calculada sobre os dados de uma integração da empresa, pronta para entrar na fórmula de um gráfico. Você também aprende a duplicar uma medida de fábrica e a descobrir onde cada medida é usada.
O que é uma variável de integração
Uma integração (por exemplo, a de um ERP ou de uma planilha ligada pelo HubCount BI Studio) traz os dados em cubos: tabelas como pedidos, clientes ou contratos. A medida transforma um cubo em um número por período: contar pedidos, somar valores, tirar a média. Esse número entra nas fórmulas dos gráficos pelo tipo Medida de Integração.
Não confunda com as variáveis do Data Lake, que são lançadas à mão ou por planilha. Essas estão em Variáveis.
Antes de começar
- Para criar ou editar os campos de uma medida, o usuário precisa da autorização Editar Medida de Integração. Sem ela, os campos ficam bloqueados e o botão Salvar fica desativado.
- Medidas de fábrica (as que já vêm com a integração) não são editáveis nem removíveis. Para mudar uma delas, duplique.
- No consolidado de uma organização empresarial, as medidas aparecem agrupadas por integração e por empresa.
Veja as medidas
A seção Variáveis de integração da barra lateral agrupa as medidas pelo nome da integração. Cada grupo mostra quantas medidas tem. Clique em uma medida para abrir o editor dela.
O menu do item (três pontos) tem Duplicar e, nas medidas que você criou, Remover. A opção Editar Nome do menu não renomeia medidas: para trocar o nome, abra a medida e edite o campo Nome da variável.
Crie uma medida
- Na seção Variáveis de integração, clique em Nova Variável de Integração.
- Se a empresa tem mais de uma integração, escolha em Conectores a integração da medida.
- Em Nome da variável, digite o nome. O nome precisa ser único dentro da integração.
- Em Descrição da Medida, escreva uma descrição curta.
- Em Fonte de Dados da Medida, escolha o cubo.
- Em Tipo de Agregação de Dados, escolha como os registros viram número. A tabela abaixo explica cada tipo.
- Em Campo de Data Base, escolha o campo de data que define em que período cada registro cai.
- Em Campo de Valor, escolha o campo numérico que será somado, medido ou contado. A Contagem simples não pede campo de valor.
- Se quiser separar o resultado por categoria, escolha o campo em Campo de Agrupamento de Dados. O campo é opcional.
- Se precisar restringir os registros, monte os filtros em Filtros de Dados.
- Clique em Salvar. A tela mostra Salvo com sucesso! e recarrega a lista.
O botão Salvar só fica ativo com nome, cubo, tipo de agregação, descrição e campo de data base preenchidos. O campo de valor também é obrigatório, exceto na Contagem simples. Se algum filtro está incompleto, o botão continua desativado.
Campos da medida
| Campo | O que faz |
|---|---|
| Nome da variável | Nome que aparece na lista de medidas e na fórmula. Dica da tela: Coloque o nome da medida que será utilizada no relatório. |
| Descrição da Medida | Descrição curta. Dica da tela: Dê uma breve descrição para a medida. |
| Fonte de Dados da Medida | Cubo de onde vêm os registros. Ao trocar o cubo, os campos e os filtros são limpos. |
| Tipo de Agregação de Dados | Como os registros do período viram um número. |
| Campo de Data Base | Campo de data que define o período do registro. Só lista campos do tipo data. |
| Campo de Valor | Campo que será agregado. Nos tipos de contagem lista campos numéricos, de texto e de escolha. Nos demais, só campos numéricos e de moeda. |
| Campo de Agrupamento de Dados | Campo para separar o resultado em categorias. Opcional. Ao trocar o campo de valor, o agrupamento é limpo. |
| Filtros de Dados | Condições para entrar no cálculo. |
Tipos de agregação
| Tipo | O que faz |
|---|---|
| Soma | Soma todos os valores encontrados. |
| Média | Calcula a média de todos os valores encontrados. |
| Contagem | Retorna a quantidade de registros encontrados. |
| Máximo | Retorna o maior valor encontrado. |
| Mínimo | Retorna o menor valor encontrado. |
| Contagem (Média) | Calcula a média dos valores agrupados por período. |
| Contagem (Último Registro) | Retorna a contagem de registros do último dia do período. |
| Soma (Último Registro) | Soma todos os valores do registro mais recente em cada período. |
| Contagem (Primeiro Registro) | Retorna o valor do registro mais antigo em cada período. |
| Valor do último registro | Retorna o valor do registro mais recente em cada período. A descrição que a tela mostra ao passar o mouse diz “mais antigo”, mas o cálculo usa o mais recente. |
Passe o mouse sobre uma opção da lista para ler a descrição que a tela mostra. Nos tipos de contagem, o campo de valor pode ser de texto, por exemplo um código de cliente.
Filtre os registros
Os filtros limitam quais registros entram no cálculo. Eles se organizam em blocos.
- Dentro de um bloco, as condições valem juntas. Entre uma condição e a seguinte aparece E.
- Entre um bloco e o seguinte aparece OU. Basta um bloco ser verdadeiro para o registro entrar.
- Em Filtros de Dados, clique em Adicionar Filtro. O bloco nasce como Filtro 1. Clique no nome do bloco para renomear.
- Em Campo para Filtrar, escolha o campo.
- Em Comparativo, escolha a comparação.
- Em Valor, digite o valor. Para campos de data, o editor de data aparece no lugar.
- Para mais uma condição no mesmo bloco, clique em Adiciona mais um item de filtro.
- Para um novo bloco alternativo, clique em Adicionar Bloco de Condições.
Cada bloco precisa de nome, e cada condição precisa de campo, comparação e valor. Se faltar algo, a tela avisa: Necessário preencher o campo de valor para os Filtros de Dados
Comparações
| Comparação | Para que serve |
|---|---|
| Igual | O campo é igual ao valor. |
| Diferente | O campo é diferente do valor. |
| Maior, Maior ou Igual, Menor, Menor ou Igual | Comparam números e datas. Ficam desativadas para campos de texto. |
| Contém, Não Contém | O texto do campo contém ou não o valor. |
| Inicia com, Termina com | O texto começa ou termina com o valor. |
| Entre, Não está entre | O campo está dentro ou fora de um intervalo. |
| Diferente (Meses) | Compara dois campos de data e considera o mês de cada um. Pede um segundo campo de data. |
Em campos de data, só ficam disponíveis Igual, Maior, Maior ou Igual, Menor, Menor ou Igual, Diferente, Diferente (Meses), Entre e Não está entre. O editor de data oferece quatro formas, em Tipo de data:
| Forma | Como funciona |
|---|---|
| Data exata | Uma data fixa. |
| Data relativa | Uma quantidade de dias, semanas, meses ou anos, antes ou depois de hoje. Muda sozinha com o tempo. |
| Período | Um período pronto, como hoje, esta semana, este mês ou o ano passado. A caixa Pesquise um período busca entre os 19 períodos. |
| Intervalo | Um início e um fim. Com Entre, inclui as datas dos limites. Com Não está entre, exclui. |
O campo Período resolvido mostra as datas a que o filtro se refere hoje. Se o filtro está incompleto, a tela mostra Complete o filtro com datas válidas
Use a medida na fórmula
- Abra a fórmula de uma série. Veja Fórmulas.
- Em Adicionar Variável*, escolha Medida de Integração.
- Em Tipo de cálculo, escolha Valor Atual, Movimentação ou Valor Anterior.
- Em Selecione a Variável, escolha a medida. A lista agrupa por integração.
Duplique uma medida de fábrica
Duplicar cria uma medida sua, com os mesmos campos, que você pode editar.
- Na barra lateral, abra o menu da medida de fábrica e clique em Duplicar.
- O editor abre com o nome terminado em - Cópia e os campos já preenchidos. Ajuste o que precisar.
- Se você quer que os gráficos e as demonstrações que usam a medida original passem a usar a cópia, ligue a chave Aplicar em todos os gráficos/demonstrações que utilizam a medida (o número da medida original aparece no fim).
- Clique em Salvar.
Veja onde a medida é usada
Quando a medida está em algum gráfico, o editor mostra um botão com a contagem, como Gráficos relacionados a essa medida seguido de Clique aqui para ver os gráficos relacionados. A janela lista os gráficos e as séries que usam a medida, com um botão Editar Gráfico em cada um. Em uma cópia, a janela também tem Voltar gráficos para a variável original, que troca os gráficos de volta para a medida original.
Remova uma medida
- Abra o menu da medida (três pontos) e clique em Remover.
- Leia a confirmação. Se a medida estiver em gráficos, a tela lista os nomes dos gráficos, começando pelo texto VariableUsedInCharts, que ainda não tem tradução. A pergunta é Tem certeza que deseja remover seguida do nome da medida.
- Confirme. A tela mostra Deletado com sucesso.
Referência rápida
| Onde | O que faz |
|---|---|
| Barra lateral | Lista as medidas por integração, cria, duplica e remove. |
| Editor | Dados básicos, agregação, campos e filtros. |
| Botão de gráficos vinculados | Mostra onde a medida é usada. |
| Chave Aplicar em todos os gráficos/demonstrações que utilizam a medida | Troca a medida original pela cópia nos gráficos. |
Exemplo: pedidos faturados da Aurora
A Aurora Comércio Ltda usa uma integração com o sistema de vendas, e a Contabilidade Exemplo quer contar os pedidos faturados no mês. Os nomes de cubo e de campo abaixo são de exemplo.
| Campo | O que a Contabilidade Exemplo preenche |
|---|---|
| Nome da variável | Pedidos faturados |
| Descrição da Medida | Quantidade de pedidos com situação faturado |
| Fonte de Dados da Medida | Pedidos |
| Tipo de Agregação de Dados | Contagem |
| Campo de Data Base | Data do pedido |
| Filtros de Dados | Um bloco com a condição Situação Igual a Faturado |
Depois de salvar, ela cria um gráfico com a série Pedidos faturados e, em outra série, divide a receita bruta de 09/2026 (R$ 54.350,00) pela medida para obter o ticket médio. Veja Fórmulas.
Problemas comuns
Ops! Algo deu errado! Entre em contato com nosso suporte.
É a mensagem genérica de falha ao salvar. A causa mais provável é um nome que já existe na mesma integração: o servidor recusa com o aviso interno “Uma variável com o mesmo nome já existe”, mas a tela só mostra a mensagem genérica. Troque o nome e salve de novo. Se não for isso, fale com o suporte.
Necessário preencher o campo de valor para os Filtros de Dados
Alguma condição de filtro está sem campo, comparação ou valor. Complete ou apague a condição.
O botão Salvar está desativado
Confira nome, descrição, cubo, tipo de agregação e campo de data base. Fora a contagem simples, confira também o campo de valor. Confira se nenhum filtro ficou incompleto e se o usuário tem a autorização Editar Medida de Integração.
Nenhuma variável disponível
A integração da empresa ainda não tem medidas. Crie a primeira com Nova Variável de Integração.
O campo de valor não lista o campo que eu quero
Nos tipos de agregação que não são de contagem, o campo de valor lista só campos numéricos e de moeda. Para campos de texto, use um tipo de contagem.
Não encontro a seção Variáveis de integração
A empresa não tem integração instalada, ou o escritório tem o Pacote Contábil ou o Pacote Automação. Veja Conectar dados no HubCount BI Studio.