Como usar parâmetros de campo no Power BI: passo a passo

Um visual só, e o usuário escolhe o que ver#

Todo relatório chega numa hora em que a área de negócio pede a mesma coisa: "queria poder ver isso por vendedor, por região e por produto, sem abrir três gráficos". A resposta antiga era duplicar visuais, empilhar botões e criar uma teia de bookmarks que ninguém mais conseguia manter. Os parâmetros de campo Power BI resolvem exatamente esse problema: eles deixam o próprio usuário trocar a métrica e o eixo de um visual em tempo real, com um clique numa segmentação, sem que você precise criar dez versões da mesma página.

Este é um tutorial direto. Vou mostrar quando usar, o passo a passo real dentro do Power BI Desktop, os erros que mais aparecem em projeto e as boas práticas que separam um relatório limpo de uma bagunça difícil de sustentar. Se você já trabalha com Power BI no dia a dia, vai sair daqui pronto para aplicar ainda hoje.

Parâmetros de campo servem para escolher o que o visual mostra#

Antes de qualquer coisa, é preciso desfazer uma confusão comum. Existem dois recursos com nomes parecidos no Power BI, e eles não fazem a mesma coisa.

Os parâmetros de campo (em inglês, field parameters) permitem que o usuário troque quais campos, colunas ou medidas aparecem em um visual. É uma lista de campos que você monta, e o usuário escolhe qual está ativo. Já os parâmetros numéricos (numeric range parameters) geram uma faixa de números para simulação, tipo "e se a meta fosse 10% maior". São coisas diferentes, e este artigo trata do primeiro.

Na prática, os parâmetros de campo geram uma tabela nova no seu modelo. Cada linha dessa tabela representa um campo que o usuário pode selecionar. Quando ele clica numa segmentação ligada a essa tabela, o Power BI troca dinamicamente o campo dentro do gráfico. Nada de bookmarks, nada de páginas duplicadas.

Quando usar (e quando não usar)#

O recurso é ótimo, mas não é para tudo. Vale a pena parar dois minutos nessa decisão antes de sair montando.

Situação	Parâmetro de campo resolve bem?
Usuário quer trocar a dimensão do eixo (região, produto, vendedor)	Sim, é o caso ideal
Usuário quer alternar entre métricas (faturamento, margem, ticket médio)	Sim, funciona muito bem
Reduzir 5 gráficos quase iguais a 1 só	Sim, é o principal ganho
Aplicar segurança por campo, escondendo colunas de certos usuários	Não, use governança e segurança de dados
Filtrar valores dentro de um campo (só a região Sul)	Não, isso é segmentação comum
Mudar a formatação condicional por regra	Não, isso é outro recurso

A regra mental é simples: se a pergunta do usuário for "quero ver por qual coisa" ou "quero ver qual número", parâmetro de campo é a ferramenta certa. Se for "quero ver só uma parte dos dados", é segmentação normal.

O passo a passo para criar um parâmetro de campo#

Vou dividir em duas frentes, porque na prática são dois usos distintos: trocar a dimensão (o eixo) e trocar a medida (o valor). O caminho de criação é o mesmo, muda o que você coloca dentro.

Passo 1: habilitar e abrir o recurso#

Nas versões recentes do Power BI Desktop o recurso já vem ativo. Se não aparecer, vá em Arquivo, Opções e configurações, Opções, Recursos de visualização e confirme que field parameters está marcado. Reinicie o Desktop se precisar.

Com isso pronto, vá na faixa superior em Modelagem e clique em Novo parâmetro, Campos. Uma janela vai abrir para você montar a lista.

Passo 2: montar a lista de campos#

Na janela, dê um nome claro ao parâmetro. Nada de "Parâmetro 1". Use algo como "Dimensão de Análise" ou "Métrica Selecionada", porque esse nome vira o título da coluna que o usuário vê.

Depois, marque os campos que quer disponibilizar. Se for um parâmetro de dimensão, escolha colunas como Produto, Região e Vendedor. Se for de métrica, escolha suas medidas como Faturamento, Margem e Quantidade. Deixe marcada a opção Adicionar segmentação a esta página, que já cria o slicer para você.

Ao confirmar, o Power BI cria uma tabela calculada. O código gerado é parecido com isto:

Dimensão de Análise = { ("Produto", NAMEOF('Vendas'[Produto]), 0), ("Região", NAMEOF('Vendas'[Região]), 1) }

Cada linha tem três partes: o rótulo que aparece na tela, a referência real ao campo e um número de ordem. Esse número controla a sequência em que os itens aparecem na segmentação, e você pode editá-lo à mão.

Passo 3: ligar o parâmetro ao visual#

Agora crie um gráfico normal, um de colunas, por exemplo. No eixo, em vez de arrastar a coluna Produto, arraste o campo do parâmetro (a coluna com o nome que você deu). No valor, coloque sua medida.

Publique mentalmente o teste: clique nos itens da segmentação. O eixo do gráfico deve trocar sozinho entre Produto, Região e Vendedor. Se trocou, está funcionando.

Para um parâmetro de métrica é a mesma lógica, só que você arrasta o campo do parâmetro para o campo de valores do visual, e mantém uma dimensão fixa no eixo.

Passo 4: usar dimensão e métrica juntas#

O ganho de verdade aparece quando você combina os dois. Crie um parâmetro de dimensão e outro de métrica, ligue os dois ao mesmo gráfico e coloque duas segmentações na página. O usuário passa a escolher, ao mesmo tempo, o que ver e por qual recorte. Um único visual cobre dezenas de combinações que antes exigiriam páginas separadas.

Uso	O que colocar no parâmetro	Onde ligar no visual
Trocar o eixo	Colunas de dimensão (Produto, Região)	Eixo do gráfico
Trocar a métrica	Medidas (Faturamento, Margem)	Valores do gráfico
Trocar eixo e métrica	Dois parâmetros separados	Eixo e Valores

Os erros mais comuns com parâmetros de campo#

Depois de ver isso em muitos projetos, os tropeços se repetem. Vale conhecer antes de cair neles.

Misturar tipos incompatíveis no mesmo parâmetro. Se você joga uma coluna de texto e uma medida numérica na mesma lista de dimensão, o visual vai se comportar de forma estranha. Separe: dimensões num parâmetro, métricas em outro. É a causa número um de "está bugado".

Nomes técnicos vazando para o usuário. Por padrão o rótulo vem com o nome da coluna do modelo, às vezes feio, tipo cod_prod_desc. Edite o primeiro texto de cada linha da tabela para algo legível. O usuário final não deveria ver nome de coluna de banco.

Esquecer de ordenar. Se você não cuidar da coluna de ordem, os itens aparecem numa sequência que não faz sentido para o negócio. Ajuste os números para que a segmentação siga uma lógica, do mais usado ao menos usado, por exemplo.

Formatação que quebra ao trocar a métrica. Quando o usuário alterna entre faturamento (R$) e quantidade (unidades), o eixo pode manter o formato errado. Isso acontece porque o visual não sabe qual formato aplicar. Em cenários mais exigentes, o caminho é usar medidas bem construídas ou grupos de cálculo, assunto que tratamos no guia de modelagem e boas práticas de DAX.

Achar que resolve segurança. Parâmetro de campo só troca o que é exibido, não impede ninguém de ver nada. Se a intenção é esconder colunas sensíveis de certos perfis, isso é segurança de objeto e entra no território de governança de dados, não de field parameters.

Boas práticas que mantêm o relatório sustentável#

Fazer funcionar é fácil. Fazer de um jeito que não vire dor de cabeça daqui a seis meses é o que diferencia trabalho de consultor.

Nomeie pensando em quem lê, não em quem constrói#

Cada rótulo da segmentação é comunicação com o usuário. "Faturamento Líquido" é melhor que "med_fat_liq". Gaste esse minuto. Quem vai usar o relatório todo dia agradece, e você reduz as perguntas que chegam depois.

Documente o que cada parâmetro faz#

Numa tabela de field parameter, os três campos gerados (rótulo, referência e ordem) contam a história. Ainda assim, quando o modelo cresce, vale registrar em algum lugar quais parâmetros existem e para que servem. Isso importa muito em ambientes com sustentação de BI, onde outra pessoa vai mexer no que você criou.

Não empilhe parâmetros demais na mesma página#

Dá para criar três, quatro parâmetros de campo numa página só. Só porque dá, não quer dizer que deva. Duas segmentações de troca já são o limite do que a maioria dos usuários processa sem se perder. Passou disso, a interface confunde mais do que ajuda.

Cuide da performance com muitas medidas#

Quando o parâmetro de métrica aponta para medidas pesadas, trocar entre elas recalcula tudo. Se cada medida já é lenta sozinha, o efeito soma. Meça o tempo de resposta e, se ficar ruim, revise as medidas antes de culpar o recurso.

Boa prática	Por que importa
Rótulos legíveis	Usuário entende sem treinamento
Separar dimensão e métrica	Evita comportamento errático do visual
Controlar a ordem dos itens	Segmentação segue a lógica do negócio
Limitar a quantidade de parâmetros por página	Interface continua clara
Medir performance com métricas pesadas	Evita relatório lento na troca

Comparação rápida: parâmetro de campo x alternativas#

Antes de decidir, ajuda ver o recurso ao lado das opções que ele substitui.

Abordagem	Esforço de manutenção	Flexibilidade para o usuário	Quando faz sentido
Parâmetro de campo	Baixo	Alta	Trocar eixo ou métrica em um visual
Bookmarks com botões	Alto	Média	Cenários e navegação entre estados
Páginas duplicadas	Muito alto	Baixa	Layouts realmente diferentes
Grupos de cálculo	Médio	Alta	Muitas métricas com mesma lógica de tempo

Na maioria dos casos de "trocar o que o gráfico mostra", parâmetro de campo ganha por manutenção baixa. Bookmarks e páginas duplicadas continuam válidos, mas para outros propósitos, não para simplesmente alternar campos.

Perguntas frequentes#

Qual a diferença entre parâmetro de campo e parâmetro numérico no Power BI?

O parâmetro de campo deixa o usuário trocar quais colunas ou medidas aparecem no visual. O parâmetro numérico gera uma faixa de valores para simulação, do tipo "e se". São recursos distintos que compartilham o menu de criação, mas resolvem problemas diferentes. Este artigo trata só do parâmetro de campo.

Posso usar parâmetros de campo com medidas e não só com colunas?

Sim, e é um dos usos mais valiosos. Você monta um parâmetro com suas medidas (faturamento, margem, quantidade) e liga ele no campo de valores do visual. O usuário passa a escolher qual número ver sem trocar de gráfico. Só não misture colunas e medidas no mesmo parâmetro.

Parâmetro de campo funciona no Power BI Service e no celular?

Funciona. Como é um recurso nativo do modelo, ele é publicado junto com o relatório e roda no Power BI Service normalmente. No mobile também funciona, mas vale testar o layout mobile porque segmentações de troca ocupam espaço e podem ficar apertadas na tela pequena.

Dá para renomear os itens que aparecem na segmentação?

Sim. Cada linha da tabela gerada tem um texto de rótulo que você pode editar livremente. É exatamente o que você deve fazer para evitar que nomes técnicos de coluna apareçam para o usuário final. Edite a fórmula da tabela ou os valores diretamente.

Field parameters servem para controlar quem vê quais dados?

Não. O recurso apenas troca o que é exibido, sem restringir acesso. Qualquer usuário pode selecionar qualquer campo da lista. Para esconder colunas ou tabelas de perfis específicos, você precisa de segurança de objeto e um bom desenho de governança de dados, que é outra camada.

Por que o formato do meu eixo fica errado ao trocar de métrica?

Porque o visual não sabe qual formato aplicar quando alterna entre uma medida em reais e outra em unidades. A saída é padronizar a formatação nas próprias medidas ou usar grupos de cálculo em cenários mais avançados. É um ajuste de modelagem, não uma limitação do parâmetro em si.

Fechamento#

Parâmetros de campo são daqueles recursos que parecem pequenos e mudam a experiência de quem usa o relatório. Com um visual e duas segmentações, você entrega o que antes exigiria dezenas de páginas, e ainda reduz o trabalho de manutenção. O segredo está nos detalhes: separar dimensão de métrica, nomear com clareza e não exagerar na quantidade. Feito com cuidado, o relatório fica mais leve para você manter e mais poderoso para o negócio explorar.

Se a sua área quer relatórios interativos que as pessoas realmente usam, e não só painéis bonitos que ninguém abre, esse é o tipo de detalhe que fazemos direito. Fale com a gente e vamos conversar sobre o seu ambiente.