KPIs/metas, grupos de cálculo, what-if, formato dinâmico

Selo de estado: Preview (teto atual do produto) · Curso ACD-320 — Fórmulas pt-BR: de SOMA a CALCULAR · Aula 12 de 13 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai criar KPI com meta e grupo "Atual/YTD/AA".

Vídeo#

Identificador no manifesto: acd-320-12-kpis-metas-calc-groups-parametros · duração-alvo 8 min · tela do produto: /dashboards.

Roteiro:

Conteúdo#

As quatro últimas peças do motor de fórmulas antes de encarar a conversão de DAX (aula 13): KPI com meta, grupo de cálculo, parâmetro what-if e formato dinâmico. Nenhuma delas é uma função nova — são formas de aplicar fórmulas que você já sabe escrever para não repetir trabalho.

KPI com meta

Um KPI do modelo tem uma fórmula de valor realizado e, opcionalmente, uma fórmula (ou número) de meta. Sem meta, só existe valor — com meta, o KPI ganha direção ("maior é melhor"/"menor é melhor") e as frações que definem bom/atenção.

SOMA(valor)

Essa é a fórmula de valor; a meta pode ser um número fixo (1000000) ou outra fórmula do motor — a mesma linguagem das medidas, sem sintaxe nova. O acompanhamento acontece dentro do painel: o alvo mora no KPI do modelo e o visual (bullet, gauge, progress, thermometer) desenha realizado contra alvo — não existe tela separada de metas com prazo e responsável, e o KPI, por si, não dispara alerta (alerta é por visual). Quem precisa de alvo por filial ou por mês usa uma medida sobre a própria tabela de metas no modelo, em vez de um número fixo — ver KPI com alvo no modelo (ACD-340, aula 6).

Grupo de cálculo: um seletor para "Atual / YTD / Ano anterior"

Um grupo de cálculo (ex.: "Tempo", com os itens Realizado / YTD / Ano anterior) se aplica a qualquer medida sem reescrever a fórmula em cada widget. Cada item usa o marcador MEDIDA() vazio — diferente de MEDIDA('Nome') (que cita outra medida da biblioteca pelo nome), MEDIDA() sem nome significa "a medida que o visual está mostrando agora":

• item "Realizado": MEDIDA()
• item "YTD": ACUM_ANO(MEDIDA(); data)
• item "Ano anterior": MESMO_PERIODO_ANO_ANTERIOR(MEDIDA(); data)

Quando dois grupos se aplicam à mesma medida (por exemplo "Tempo" × "Moeda"), a ordem segue precedência determinística: maior precedência vira a função mais externa. Precedências empatadas são recusadas, nunca escolhidas em silêncio — o mesmo cuidado de "branco honesto" da aula 1, agora aplicado a ambiguidade de composição.

Parâmetro what-if: simular um cenário

Um parâmetro what-if é um número nomeado ("e se o desconto fosse X%") que o leitor do painel ajusta com um slider, sem editar fórmula nenhuma. A seleção viaja na URL/bookmark — não fica gravada no modelo, então trocar o parâmetro de nome não quebra um link salvo. A fórmula que consome o what-if é uma medida comum, multiplicando a medida base pelo fator:

MEDIDA('Receita') * (1 - 0,1)

No modelo, o 0,1 fixo dá lugar ao valor que o parâmetro what-if está devolvendo no momento — a mecânica de leitura do parâmetro é da camada de widget, não uma função nova da linguagem de fórmulas.

Diferente de um slicer comum: um parâmetro what-if não recorta linhas — ele troca um número usado dentro da fórmula. Recorte de linha continua sendo trabalho de filtro/slicer.

Formato dinâmico: o mesmo campo, formato que muda por condição

Formato dinâmico é uma chave do formato do campo, não uma função de fórmula — por isso não existe um FORMATO(...) que devolva texto já formatado (isso quebraria ordenação, eixo de gráfico e exportação). Cada regra tem uma condição, escrita na mesma linguagem do motor, e um formato que se aplica quando ela é verdadeira. A condição mais comum usa TEM_UM_VALOR (aula 11 citou o parente VALOR_SELECIONADO):

TEM_UM_VALOR(uf)

Um KPI pode usar essa condição para mostrar moeda quando uma UF só está selecionada, e percentual quando o eixo é participação entre várias — a primeira regra verdadeira vence; nenhuma verdadeira cai no formato base.

Os quatro recursos, lado a lado

Nenhum dos quatro introduz sintaxe nova na linguagem — todos reaproveitam fórmulas que você já escreveu nas aulas 1 a 11, só mudando onde e quando elas se aplicam.

Erros comuns

• Escrever MEDIDA('Nome') num item de grupo de cálculo esperando que ele funcione como o marcador vazio — grupo de cálculo usa MEDIDA() sem nome; MEDIDA('Nome') é para citar outra medida da biblioteca.
• Esperar que um parâmetro what-if recorte linhas como um slicer — ele só troca um número usado na fórmula.
• Tentar usar uma função de fórmula para formatar o campo (TEXTO muda o texto, não o formato do campo) quando o que se quer é formato dinâmico condicional.

Estado da capacidade

KPI, grupo de cálculo, parâmetros e formato dinâmico (C06.5) estão em Preview. Grupo de cálculo é só montagem de texto — nada é avaliado na edição, e o conjunto de testes de referência garante a mesma composição sempre.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /dashboards no console):

1. No modelo, crie um KPI Receita com valor SOMA(valor) e meta 1000000.
2. Crie um grupo de cálculo Tempo com os itens Realizado (MEDIDA()), YTD (ACUM_ANO(MEDIDA(); data)) e Ano anterior (MESMO_PERIODO_ANO_ANTERIOR(MEDIDA(); data)).
3. Aplique o grupo "Tempo" à medida Receita num seletor único e confirme que os três itens respondem com o número certo.
4. Numa regra de formato dinâmico do KPI, use TEM_UM_VALOR(uf) para mostrar moeda só-UF e percentual quando o eixo é participação.

Você terminou quando o KPI Receita tiver meta cadastrada e o seletor "Tempo" trocar entre Realizado/YTD/Ano anterior sem precisar de três medidas separadas.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

• bi/medidas-formulas-kpis — seção "KPIs no modelo" (alvo no KPI e a nota de remoção da tela de Metas)
• formulas/tem_um_valor

Capacidades ensinadas#

C06.5 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".