Vision DocumentaçãoWidgets
DocumentaçãoWidgets
Widgets

Widget KPI

Última alteração a 14/10/2024

O widget KPI foi concebido para apresentar um ou mais resultados numéricos relevantes. Para tal, possui algumas funcionalidades específicas que um utilizador editor que pretenda tirar partido das mesmas deve conhecer.

KPI simples

No seu modo normal, o widget KPI requer que a consulta devolva apenas uma única linha (1 registo) e que tenha apenas medidas, não dimensões. Assim, quando a consulta é válida, o KPI apresenta números, que podem ser estilizados de uma determinada forma, através dos níveis de comparação:

  • Cada medida ou componente suporta os seus próprios níveis de comparação.
    • Cada nível de comparação define uma condição estática no valor do componente, que, se for verdadeira, aplica o estilo indicado.
  • O estilo é composto por:
    • Adicionar um ícone à direita do valor, que pode assumir uma cor pretendida.
    • Atribuir uma cor pretendida ao próprio valor numérico

Exemplo de como condicionar o estilo de um KPI

KPI comparador

O KPI no modo "comparador" tem um comportamento mais complexo, mas muito útil.

  • A sua utilização correta é combinada com um filtro de uma data, uma função de uma data (ano, mês, dia) ou um campo de texto, que devolva um único valor (seleção simples). Caso contrário, o modo de comparador não tem qualquer efeito sobre o KPI.
  • A consulta do KPI deve devolver a dimensão pela qual se pretende efetuar a comparação (caso contrário, o comparador não tem qualquer efeito), bem como todas as demais medidas pretendidas.
  • Nestas condições, o KPI obtém valores numéricos únicos relativamente ao filtro aplicado, mas também valores "anteriores" de acordo com a indicação do utilizador:
    • Indica-se como obter o valor anterior ou de referência na personalização do widget, quando é ativado o modo comparador.
    • O Vision, a partir da consulta indicada pelo utilizador, também obtém automaticamente o valor anterior. Isto é, discrimina como aplicar o filtro de seleção única condicionado pela configuração do comparador para obter 2 valores por medida e não apenas 1 (o utilizador não tem de se preocupar em fazer nada de extraordinário com a consulta).
  • Faz-se uma dupla comparação com o valor principal e o valor de referência, em valor absoluto e relativo (à referência).
  • No widget, é possível visualizar o par de valores, principal e de referência, e adicionar as diferenças, absoluta e relativa, conforme desejado.
  • Além disso, também é possível utilizar os níveis de comparação para estilizar o KPI: o valor utilizado para determinar se um nível devolve um resultado verdadeiro ou falso é a diferença relativa (independentemente de ser ou não apresentada no widget).

Exemplo de como utilizar um KPI no modo comparador

Adicionar aos favoritos ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.

login para deixar a sua opinião.

Obrigado pelo seu feedback. Iremos analisá-lo para continuarmos a melhorar!
Artigos Relacionados
Widget KPI