Usar parâmetros de campo para permitir que os leitores do relatório alterem os visuais

Os parâmetros de campo em Power BI permitem que os leitores de relatório alterem dinamicamente as medidas ou dimensões que estão analisando em um relatório. Os leitores podem explorar e personalizar a análise selecionando diferentes medidas ou dimensões de uma segmentação de dados.

No vídeo a seguir, saiba como criar parâmetros de campo no Power BI Desktop e como os leitores de relatório interagem com eles.

No exemplo a seguir, o leitor de relatório pode atualizar dinamicamente o gráfico de barras e a tabela selecionando um campo nas segmentações horizontais acima dos visuais. Atualmente, o gráfico de barras e a tabela medem o custo das mercadorias vendidas (COGS) e fazem a análise por produto, com base na seleção do usuário nas segmentações.

Captura de tela de um relatório do Power BI com segmentações de parâmetros de campo mostrando o custo das mercadorias vendidas por produto em um gráfico de barras e uma tabela.

Criar um parâmetro de campo

  1. Para criar um novo parâmetro de campo, vá para a guia Modelagem e selecione Novos Campos de parâmetro>.

    Captura de tela da guia Modelagem no Power BI Desktop mostrando a lista suspensa Novo parâmetro com a opção Campos.

  2. Para criar o parâmetro, forneça um nome para o parâmetro e selecione os campos que você deseja usar. Neste exemplo, consulte as dimensões selecionadas Cliente, Cor, Categoria e Produto.

    Captura de tela da caixa de diálogo de configuração do parâmetro de campo mostrando seleções de campo Cliente, Cor, Categoria e Produto.

    Nesta caixa de diálogo, você pode arrastar para alterar a ordem dos campos ou clicar duas vezes em qualquer um dos campos selecionados para alterar o nome de exibição.

    Você também pode combinar medidas e dimensões dentro do mesmo parâmetro. Por exemplo, crie uma tabela dinâmica em que as colunas possam ser medidas ou dimensões.

Usar um parâmetro de campo em visuais

Depois de criar um parâmetro de campo, use o parâmetro para controlar os valores e o eixo usados em um visual.

Captura de tela do visual de exemplo, mostrando as opções de parâmetro.

Use um parâmetro de campo baseado em colunas nos compartimentos de campo do eixo de um visual e use um parâmetro de campo baseado em medidas nos compartimentos de campo dos valores. Se o visual der suporte a várias medidas, a seleção de várias medidas no parâmetro de campo as mostrará lado a lado no visual.

Usar um parâmetro de campo em uma segmentação de dados

Ao usar um parâmetro de campo em uma segmentação de dados, você pode exibi-lo de duas maneiras: como uma lista dos campos no parâmetro ou como os valores dentro de cada campo.

Por padrão, quando você adiciona um parâmetro de campo a uma segmentação pela primeira vez, a segmentação mostra os nomes dos campos. Os visualizadores de relatório selecionam um nome de campo para controlar os campos usados em outros visuais associados ao parâmetro.

Em vez disso, para mostrar os valores em cada campo:

  1. No painel Compilar , clique com o botão direito do mouse no parâmetro de campo.
  2. Selecione Mostrar valores do campo selecionado.

Captura de tela do menu de contexto acessado com o botão direito do mouse em um parâmetro de campo no painel Construir, com a opção Mostrar valores do campo selecionado destacada.

O segmentador se torna um segmentador hierárquico que exibe os valores de cada campo como um nível na hierarquia. Esse comportamento se aplica aos visuais de segmentação de dados e de segmentação de dados de lista. A segmentação de botão não dá suporte a hierarquias, portanto, ela mostra apenas os valores do primeiro campo no parâmetro.

Para retornar à lista de nomes de campo, clique com o botão direito do mouse no parâmetro de campo no painel Compilar e selecione Mostrar campo selecionado.

Captura de tela de uma segmentação de dados exibindo um parâmetro de campo na forma de uma lista de nomes de campo selecionáveis.

Mostrar valores é útil em dois cenários:

  • Exija uma seleção antes que os outros segmentadores exibam valores. Com uma única seleção ativada para a segmentação de dados, os visualizadores de relatório devem escolher um valor do parâmetro de campo antes que outra segmentação associada ao parâmetro possa mostrar seus valores.
  • Apresente uma hierarquia natural em um único segmentador. Quando os campos formam uma hierarquia natural, como Ano, Mês e Dia da semana, os leitores de relatórios podem filtrar pela hierarquia ou por um único nível dela sem que você precise oferecer várias segmentações. Por exemplo, os espectadores podem filtrar para domingo ao longo de todos os anos e meses, ou para domingo dentro de um ano e mês específicos.

Captura de tela de uma segmentação hierárquica mostrando os valores de cada campo em um parâmetro de campo como níveis que podem ser expandidos.

Observação

Essa opção está disponível apenas para parâmetros de campo que contêm colunas. Ele não está disponível para parâmetros de campo que contêm medidas.

Editar um parâmetro de campo

Para editar um parâmetro de campo existente, modifique as Expressões de Análise de Dados (DAX) diretamente.

Por exemplo, se você quiser adicionar um novo campo a um parâmetro existente, selecione Shift + Enter para iniciar uma nova entrada. Adicione uma vírgula entre entradas e corresponda ao formato mostrado neste exemplo. O número após a vírgula indica a ordem dos campos:

Parameter = {
    ("Customer", NAMEOF('Customer'[Customer]), 0),
    ("Category", NAMEOF('Product'[Category]), 1),
    ("Color", NAMEOF('Product'[Color]), 2),
    ("Product", NAMEOF('Product'[Product]), 3)
}

Captura de tela do editor DAX mostrando uma definição de parâmetro de campo com os campos Cliente, Categoria, Cor e Produto.

Observação

O DAX define quatro campos no parâmetro e, para cada campo, três colunas são fornecidas: um nome, uma referência de coluna e o número da ordem. Embora você possa definir colunas extras no DAX, esse recurso não tem suporte e pode levar a resultados inesperados. Defina três colunas para cada campo e use valores exclusivos para todas as colunas.

Configurar a persistência no nível da hierarquia para parâmetros de campo

Por padrão, Power BI mantém o nível de hierarquia exibido em uma matriz à medida que as seleções de parâmetro de campo são alteradas. Você pode desativar esse comportamento usando a configuração de nível de hierarquia Persist nas configurações do relatório. Para encontrar essa opção:

  • No Power BI Desktop, vá para Opções e configurações>Opções>Arquivo atual>Configurações do relatório>Parâmetros de campo>Persistir nível da hierarquia.
  • Em Microsoft Fabric, vá para as configurações do relatório e localize o nível da hierarquia Persist em opções de parâmetro Field.

Para ilustrar a diferença, considere uma matriz mostrando um parâmetro de campo chamado Grupo de Produtos e uma coluna chamada Ano nas linhas, exibindo Total de vendas. O parâmetro de campo permite a seleção de Categoria, Classe, Cor ou qualquer combinação. Neste exemplo, Categoria é selecionada e as Categorias são expandidas, para que você possa ver valores divididos por ano:

Captura de tela de uma matriz mostrando um parâmetro de campo grupo de produtos e ano em linhas.

Agora, quando você altera o parâmetro de campo de Categoria para Classe, o que acontece depende da configuração de nível de hierarquia Persist. Se estiver ativado, a matriz permanecerá expandida, mantendo a coluna Ano visível; se estiver desativado, a matriz será recolhida e exibirá apenas valores de Classe. A comparação a seguir mostra os dois comportamentos, dependendo de o controle estar ativado ou desativado.

Manter a configuração de nível de hierarquia em Manter a configuração do nível de hierarquia desativada
Captura de tela de uma matriz com níveis de hierarquia expandidos depois de alterar o parâmetro de campo. Captura de tela de uma matriz com níveis de hierarquia recolhidos depois de alterar o parâmetro de campo.

Limitações conhecidas dos parâmetros de campo

  • Se você usar uma coluna de data em um parâmetro de campo com data/hora automática, a Hierarquia de Datas não estará mais associada à coluna de data no parâmetro de campo. O comportamento é o mesmo que colocar a coluna de data diretamente em um eixo visual sem a hierarquia. Para obter o comportamento da Hierarquia de Datas, crie um parâmetro de campo usando os níveis de hierarquia (Ano, Trimestre, Mês, Dia) explicitamente.
  • Os visuais de IA e o Q&A não são compatíveis com parâmetros de campo.
  • Não há como os usuários do relatório selecionarem a opção "nenhum" ou nenhum campo. Selecionar nenhum campo na segmentação de dados ou cartão de filtro é o mesmo que selecionar todos os campos.
  • Você não pode criar parâmetros em fontes de dados de conexão dinâmica sem um modelo local. No entanto, se você usar o DirectQuery para modelos semânticos do Power BI e o Analysis Services, poderá adicionar um modelo local para criar parâmetros de campo. Para obter mais informações sobre como usar o DirectQuery para conexões ao vivo, consulte Modelos Compostos em Modelos Semânticos do Power BI e Analysis Services.
  • Você não pode usar medidas implícitas, portanto, se precisar de uma coluna agregada como um de seus campos, será necessário criar uma medida DAX explícita para ela. Para obter mais informações, consulte medidas implícitas versus explícitas.
  • Você não pode usar parâmetros de campo como os campos vinculados de uma página de detalhamento ou dica de ferramenta. A solução alternativa é usar os campos individuais referenciados dentro do parâmetro de campo. Por exemplo, se o parâmetro de campo incluir campos Cliente e Produto , você poderá vincular esses dois campos à página de detalhamento ou dica de ferramenta para que os visuais com o parâmetro de campo possam iniciar sua página de detalhamento ou dica de ferramenta.

Considerações sobre como usar parâmetros de campo

  • Quando você usa parâmetros de campo com o Copilot, o Copilot responde com base no estado atual dos visuais no relatório.
  • A ordem na qual os campos de um parâmetro de campo aparecem em um visual depende da ordem de seleção. Se você usar uma segmentação de hierarquia, a segmentação de hierarquia determinará a ordem do campo.

Conteúdo relacionado

Para obter mais informações, consulte os seguintes artigos:

  • Last updated on