O valor da coluna quando o grupo tem um só; senão o padrão informado.
| Campo | Valor |
|---|---|
| Categoria | Contexto e filtro |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 1 a 2 argumentos |
| Compila para SQL (coluna calculada) | Não |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: VALOR_SELECIONADO. Aliases aceitos (maiúsc./minúsc. indiferente): selectedvalue.
Assinatura#
code
VALOR_SELECIONADO(coluna; [arg2])O 1º argumento é o nome de uma coluna (identificador nu); os demais são expressões.
Retorno#
O valor único da coluna, ou o padrão.
Tratamento de nulos#
Mais de um valor (ou nenhum) devolve o padrão informado.
Contexto de avaliação#
Agregação — percorre as linhas do grupo atual do visual.
Diferenças para DAX#
- Equivalente DAX: SELECTEDVALUE
- Compatibilidade: Compatível com DAX
- Observação: O valor da coluna quando o grupo tem um só; senão o padrão.
Exemplos#
code
VALOR_SELECIONADO(uf; "Todas")Exemplo com valores#
Entrada: grupo com um só uf (SP).
code
VALOR_SELECIONADO(uf; "Todas") → "SP"Resultado esperado: "SP"
Exemplo de negócio#
Medida comparativa — participação no total, ranking, variação contra outro período.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.