Métricas

Introdução

As métricas são usadas para definir um cálculo uma vez e reutilizá-lo em todo o app. 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. Você ainda pode reutilizar essas métricas em diferentes gráficos.

Observação:

Você não pode visualizar ou publicar o app ao adicionar ou editar métricas.

Editing metrics

Siga estas etapas para editar uma métrica.

1. No painel Data Manager , localize a métrica que você deseja editar e selecione o ícone Editar.

   A janela Editar KPI será exibida.

2. Edite o nome de exibição da métrica no campo Nome da métrica e/ou configure as regras para a métrica.

3. Se aplicável, adicione ou altere as métricas de contexto.

4. Selecione Salvar.

Adição de métricas

Se a métrica que você deseja usar não estiver disponível por padrão, você pode criar novas métricas que podem ser usadas em seus painéis.

Siga estas etapas para adicionar uma nova métrica.

1. No painel Data Manager , selecione +Nova métrica.

   A caixa de diálogo Criar KPI é exibida.

2. Insira um nome descritivo para a nova métrica no campo Nome da métrica .

   Dica:

   É uma boa prática consultar o tipo de função que você usa para calcular a métrica.

3. Configure as regras que definem a métrica.

   Dica:

   Uma visualização do cálculo da métrica é exibida no painel Criar KPI.

4. Se aplicável, selecione uma ou mais métricas de contexto.

5. Selecione Salvar.

A métrica é adicionada à lista de métricas no Data Manager.

Métricas de contexto

Você pode adicionar métricas de contexto para fornecer uma melhor compreensão da principal métrica exibida no gráfico. As métricas de contexto são exibidas como dicas de ferramentas nos gráficos.

A ilustração a seguir mostra um gráfico com a métrica principal Quantidade média e Número de casos como uma métrica de contexto.

Dependendo do cálculo da métrica principal, diferentes contextos podem ser úteis para explicar a métrica principal. Por exemplo, se a métrica principal estiver definida como Average amount, o contexto útil é Number of cases , para o qual o valor médio é calculado. Isso também se aplica quando sua métrica principal é definida como Total amount. Nesse caso, também Number of cases , para o qual a soma é calculada, é um contexto útil.

Quando sua métrica principal é definida como uma porcentagem, por exemplo Cases with tag (%), contextos úteis podem ser Number of cases with tag e Total number of cases.

A tabela a seguir mostra alguns exemplos das métricas principais com métricas de contexto relevantes.

	Principal métrica	Métrica do contexto 1	Métrica do contexto 2
Contagem	Número de casos 112	-	-
Média	Quantidade média € 61,43	Casos 112	-
Soma	Montante total € 123.555,00	Casos 112	-
Porcentagem	Casos com tag %​ 60%	Casos com tag 600	Total de casos 1000

Regras

Elementos de uma regra

Abaixo encontra-se uma descrição dos elementos de uma regra.

Element	Description
Tipo de agregação	O tipo da função que é usada para calcular a métrica. Por exemplo, SUM é usado para calcular um valor Total , AVERAGE é usado para calcular um valor Médio .
Campo usado para agregação	O campo usado para calcular a métrica.

Tipo de agregação

Abaixo encontra-se uma visão geral dos tipos de agregação disponíveis para configurar uma regra.

Tipo de agregação	Retorna	Tipos de campo permitidos
Group	N/A	tudo
Input value	uma constante	número, moeda, porcentagem
Distinct count	o número de valores exclusivos para o campo selecionado	tudo
Count	o número de valores para o campo selecionado	tudo
Case average	a soma de todos os valores para o campo selecionado dividido pelo número de casos	número, duração , moeda
Average	a soma de todos os valores para o campo selecionado dividido pelo número de registros na tabela do campo selecionado	número, duração
Min	o menor valor para o campo selecionado	número, duração , moeda
Max	o maior valor para o campo selecionado	número, duração , moeda
Percentage	a porcentagem de valores TRUE para o campo selecionado	Booleano
Sum	a soma de todos os valores para o campo selecionado	número, duração , moeda
Percentile	o percentil k-th dos valores para o campo fornecido	número, duração , moeda
Median	a mediana dos valores para o campo fornecido.	número, duração , moeda

Uso de valores estáticos

Em vez de um tipo de agregação, você pode optar por usar um valor constante para calcular a métrica. Se você selecionar a opção Valor de entrada da lista de agregações, você pode inserir um valor e selecionar o tipo de campo.

Configuração de regras

Siga estas etapas para configurar uma regra.

1. Selecione a função que você deseja usar para calcular a métrica na lista Tipos de agregação.

   Dica:

   Comece a digitar o tipo de agregação e selecione Inserir.

   
2. Selecione o campo que você deseja usar para calcular a métrica da lista suspensa Campo usado para agregação .
   Observação:

   A lista suspensa Campo usado para agregação contém apenas campos que são aplicáveis para o tipo de agregação selecionado.

3. Se desejar, aplique filtros aos valores que devem ser considerados para a avaliação da agregação usada para a métrica.

4. Selecione Salvar no painel Criar KPI.

Repita estas etapas se você quiser adicionar outra agregação para a regra.

Observação:

Você pode adicionar até duas agregações para definir a regra. Se você definir duas agregações para a regra, elas serão avaliadas como uma divisão. Nesse caso, você pode selecionar para exibir os resultados como um valor percentual.

Uso de várias agregações em uma regra

Você pode adicionar até duas agregações para definir a regra. Se você definir duas agregações para a regra, poderá selecionar o operador a ser usado para avaliar a regra. Abaixo encontra-se uma visão geral dos operadores disponíveis.

Operador	Description
+	adição
-	Subtração
X	Multiplicação
/	Divisão*

*) No caso de uma divisão, é possível selecionar para exibir os resultados como um valor percentual.

O tipo de resultado da regra depende do tipo das agregações de entrada. Abaixo está uma visão geral dos formatos de entrada suportados para os operadores.

Operador	Regra	Tipo de resultado
adição	numeric + numeric	numeric
	duration + duration	duration
	currency + currency	currency
	percentage + percentage	percentage
	timestamp + duration	timestamp
Subtração	numeric - numeric	numeric
	duration - duration	duration
	currency - currency	currency
	percentage - percentage	percentage
	timestamp - duration	timestamp
	timestamp - timestamp	duration
Multiplicação	numeric x numeric	numeric
	duration x numeric	duration
	currency x numeric	currency
	percentage x numeric	percentage
	percentage x percentage	percentage
	numeric x percentage	numeric
	duration x percentage	duration
	currency x percentage	currency
Divisão	numeric / numeric	numeric
	duration / duration	numeric
	currency / currency	numeric
	percentage / numeric	percentage
	duration / numeric	duration
	currency / numeric	currency
Porcentagem	numeric / numeric	percentage
	duration / duration	percentage
	currency / currency	percentage

Agrupando agregações

Em vez de um único tipo de agregação, você pode optar por usar uma agregação de Grupo para calcular a métrica. Isso permite que você defina a sequência de operações. Selecione a opção Grupo na lista de agregações para criar um grupo composto por duas agregações.

Dica:

Como uma agregação de grupo pode conter duas agregações, e você pode adicionar até duas agregações, é possível criar uma regra que incorpore um total de quatro agregações.

Manuseio nulo

X / 0 retornará null

null / X retornará null

X / null retornará null

Aplicação de filtros a uma agregação

Siga estas etapas para aplicar filtros a uma agregação.

1. Selecione a agregação para a qual você deseja aplicar filtros.

2. Selecione Adicionar filtro no painel Criar KPI .

3. Defina os filtros como desejar.

O ícone é exibido ao lado da agregação, indicando que filtros foram aplicados à agregação.

Dica:

Você pode selecionar o ícone para ver uma visualização dos filtros aplicados.

Remoção de uma agregação

Siga esta etapa para remover uma agregação de uma regra.

1. Localize a agregação que você deseja remover e selecione o ícone .

Observação:

A agregação será removida sem qualquer notificação.

Deleting metrics

Para manter seu aplicativo de processo limpo, você pode excluir as métricas que não são mais usadas. Siga estas etapas para excluir uma métrica.

1. No painel Data Manager , localize a métrica que deseja excluir.

2. Passe o mouse sobre o nome da métrica e selecione a Exclua o ícone de métrica .

   Uma mensagem de confirmação é exibida.

3. Selecione Excluir.

   Veja o exemplo abaixo.

   
   

   

   
   
   Observação: você só pode excluir métricas criadas pelo usuário. As métricas usadas em gráficos não podem ser excluídas.

Visualização de referências de métricas

Se quiser excluir uma métrica que é usada em gráficos, você deve primeiro excluir as referências de métricas. Ao passar o mouse sobre o ícone Excluir métrica , um pop-up é exibido indicando em quais painéis e gráficos a métrica é usada.