Métricas

Introdução

As métricas são usadas para definir um cálculo uma vez e reutilizá-lo em todo o aplicativo. Por exemplo, você pode criar uma métrica para calcular o número de faturas ou uma métrica para calcular o valor médio. Essas métricas podem ser reutilizadas em diferentes locais, como em gráficos ou em expressões agregadas.

Métricas x expressões

Expressões e métricas têm uma finalidade específica e funcionam de maneira diferente. As expressões criam um valor por registro. As métricas não têm um valor próprio. Uma métrica deve ser usada em um local onde os registros sejam acessíveis, por exemplo expressões agregadas, gráficos e painéis HTML.

A mesma métrica pode ser usada em muitos lugares enquanto as expressões são adaptadas para uma finalidade específica.

As métricas também podem ser usadas nos cálculos de outras métricas.

Observação: para usar uma métrica em uma expressão, ela deve ser precedida pela função metric. O uso desta função é necessário para avaliar a métrica.

Criação de uma métrica

Siga estas etapas para criar uma métrica.

Etapa	Ação
1	Abra o aplicativo em seu ambiente de desenvolvimento e vá para a guia Dados.
2	Na lista de itens da tabela, clique com o botão direito do mouse na tabela para a qual você deseja criar uma métrica e selecione Nova métrica....
3	Insira a expressão para definir a métrica no editor de expressão .
4	Valide o resultado no painel de resultados à direita.
5	Clique em OK.

A nova métrica é criada na lista de itens da tabela e identificada pelo ícone.

Como usar métricas em um gráfico

Siga estas etapas para usar a métrica em um gráfico.

Etapa	Ação
1	Vá para a guia Painéis e crie um novo painel com base na tabela na qual o controle de métricas está presente.
2	Vá para a guia Gráfico .
3	Selecione o atributo que deseja exibir no gráfico na lista suspensa Linhas .
4	Selecione a métrica na lista suspensa Métrica .

Veja a ilustração abaixo para um exemplo.

No exemplo, o atributo Tipo de fatura é usado para o gráfico e a métrica Valor médio da métrica que calcula a receita total que uma fatura gera em média. O tamanho da barra é igual ao número de valor médio por categoria.

Como usar uma métrica em um gráfico legado

Siga estas etapas para usar a métrica em um gráfico herdado.

Etapa	Ação
1	Vá para a guia Painéis e crie um novo painel com base na tabela na qual o controle de métricas está presente.
2	Vá para a guia Gráfico .
3	Arraste o atributo que deseja exibir no gráfico para o nível Linhas .
4	Altere o Tamanho para Expressão.
5	Clique em expression e digite uma expressão para usar a métrica que você criou. Por exemplo metric(Metric_Average_Amount).
6	Clique em OK.

Informações relacionadas

Consulte Seletores de métrica.