---
schema_version: "1"
id: 8862b9c7eb95767e621ade0ce5ed5c1457dce9683f8ceb61bc41db325a5f0d80
title: Ações de parâmetro
collection: tableau
version: next
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/next/pt-br/pro/desktop/actions_parameters.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/pt-br/actions_parameters.htm
source_site: help.tableau.com
content_type: documentation
content_hash: bc91c85210254c7632e0000daa9a7efd7d544c70cbfc19b440c0358ffcec8d4a
description: Configure parameter actions so users change parameter values by selecting marks in a viz.
---
[Pular para o conteúdo principal](#main-content)

# Ações de parâmetro

Use as ações de parâmetro para permitir que seu público altere um valor de parâmetro por interação direta com uma visualização, como clicar ou selecionar uma marca. É possível usar ações de parâmetro com linhas de referência, cálculos, filtros e consultas SQL e para personalizar como exibir dados em suas visualizações.

As ações de parâmetro abrem novas possibilidades para criar valores de resumo e estatísticas sem usar cálculos. Você pode configurar ações de parâmetro para permitir que os usuários selecionem várias marcas que são agregadas automaticamente em um único valor de parâmetro. Por exemplo, uma ação de parâmetro poderia mostrar a AVG(Vendas) ou COUNTD(Pedidos) das marcas atualmente selecionadas.

Para obter exemplos de como as ações de parâmetro podem ser usadas, consulte [Exemplos de ações de parâmetro](#Examples).

![Uma ação de parâmetro mostra a AVG(Vendas) ou COUNTD(Pedidos) das marcas atualmente selecionadas.](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter_actions_overview.gif)

Você pode criar ações de parâmetro no Tableau Desktop, no Tableau Cloud ou no Tableau Server.

Quando você define uma ação de parâmetro, ela deve incluir:

- as planilhas de origem aplicáveis.
- o comportamento do usuário que executa a ação (focalizar, selecionar, ou acessar o menu).
- o parâmetro de destino, o campo de origem e a respectiva agregação (se aplicável).

O parâmetro mencionado na ação também deve ser referenciado em alguma parte da visualização. Você pode fazer isso de diferentes maneiras, como referenciar o parâmetro em um campo calculado ou uma linha de referência usada na visualização. Além disso, é possível criar uma exibição que use um campo de origem referenciado na ação de parâmetro.

## Etapas gerais da criação de ações de parâmetros

1. Crie um ou mais parâmetros. Para obter mais informações, consulte [Criar parâmetros](https://help.tableau.com/v0.0/pro/desktop/pt-br/parameters_create.htm).
2. **Opcional**: dependendo do comportamento que deseja disponibilizar aos usuários para análise, você pode criar um campo calculado que usa o parâmetro. Para obter detalhes sobre como criar campos calculados, consulte [Criar um campo calculado](https://help.tableau.com/v0.0/pro/desktop/pt-br/calculations_calculatedfields_create.htm#Create).
3. Crie uma visualização que utilizará as ações de parâmetro.
    
    Por exemplo, se você criou um campo calculado que use o parâmetro, crie a visualização usando ele. Ou arraste um campo que você planeja vincular ao parâmetro na exibição.
4. Crie uma [ação de parâmetro](#Create) que use um parâmetro. É possível criar várias ações de parâmetro para diferentes propósitos. A ação de parâmetro deve se referir ao nome da planilha da visualização, o nome do parâmetro e o campo de origem ao qual o parâmetro será associado.
5. Teste a ação de parâmetro e ajuste suas configurações ou outros elementos relacionados em sua visualização, conforme necessário, para obter o comportamento desejado para seu público-alvo.

**Observação**: é útil entender como você pode usar parâmetros no Tableau antes de começar a usá-los em ações de parâmetro. Para obter mais informações:

- Leia o tópico de ajuda [Criar parâmetros](https://help.tableau.com/v0.0/pro/desktop/pt-br/parameters_create.htm) e tópicos de parâmetro relacionados.
- Consulte [Usar parâmetros para adicionar várias exibições à sua visualização](http://www.tableau.com/pt-br/about/blog/2015/7/lrtt-parameters-alter-your-viz-40767) no [blog](https://www.tableau.com/pt-br/about/blog) do Tableau e vários tópicos práticos sobre como usar parâmetros no site [Data School](https://www.thedataschool.co.uk/), como [Quatro etapas para criar um parâmetro](https://www.thedataschool.co.uk/tom-prowse/4-steps-to-creating-a-parameter/).
- Para obter uma apresentação detalhada, assista [Parâmetros | Ah, os lugares que você vai!](https://youtu.be/Xk9HnpmWtsU) (45 minutos).

## Criar uma ação de parâmetro

1. Em uma planilha, selecione Planilha >Ações. Em um painel, selecione Painel > Ações.
2. Na caixa de diálogo Ações, clique em Adicionar ação e selecione Alterar parâmetro.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_add.png)
3. Na caixa de diálogo Ações, especifique um nome específico para a ação.
4. Selecione uma planilha de origem ou uma fonte de dados. Por padrão, a planilha atual é selecionada. Se você selecionar uma fonte de dados ou um painel, poderá selecionar as planilhas individuais contidas nela.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter-action-update3.png)
5. Selecione como os usuários vão executar a ação.
    
    - Focalizar: é executada quando um usuário focaliza o mouse sobre uma marca na exibição. Além disso, expõe uma opção para a ação na dica de ferramenta da marca.
    - Selecionar: é executada quando um usuário clica em uma marca ou seleciona várias marcas na exibição.
    - Menu: é executada quando um usuário clica com o botão direito do mouse (macOS: clica pressionando a tecla Control) na marca selecionada na exibição e, em seguida, seleciona uma opção no menu de contexto. Além disso, expõe uma opção para a ação na dica de ferramenta da marca.
6. Em Destino, especifique o parâmetro de destino e um campo de origem. Todos os parâmetros da pasta de trabalho estão disponíveis na lista Parâmetro.
    
    Para permitir que os usuários selecionem várias marcas que são agregadas em um único valor de parâmetro, selecione um tipo de agregação.
    
    **Observação**: se você desejar que os usuários possam selecionar várias marcas, será necessário selecionar uma agregação. Se a opção Agregação estiver definida como Nenhuma e várias marcas que contenham valores diferentes para o campo de origem forem selecionadas, a ação de parâmetro não será executada.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter-action-update1.png)
    
    A agregação escolhida para a ação de parâmetro pode ser diferente da agregação usada para esse campo na exibição. Por exemplo, você poderia criar um modo de exibição que use SUM(Vendas), mas definir o campo Origem de vendas referenciado na ação de parâmetro para usar a Média para a agregação. Observe que, se você alterar a agregação do campo Vendas no modo de exibição para AVG(Vendas), será necessário atualizar a ação de parâmetro para fazer referência ao campo Vendas novamente.
7. Especifique o que acontecerá quando a seleção for desmarcada.
    
    - Manter valor atual - O valor atual do parâmetro permanecerá na exibição.
    - Definir valor como - O valor do parâmetro será revertido para o valor indicado.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter-action-update2.png)
8. Clique em OK para salvar suas alterações e retornar à exibição.
9. Para testar a ação de parâmetro, interaja com a visualização. Ajuste algumas das configurações da ação para ajustar o comportamento, conforme necessário.

## Exemplos de ações de parâmetro

Os exemplos a seguir demonstram como você pode usar as ações de parâmetro, mas eles são apenas o começo do que é possível. Além disso, ajuda estar familiarizado com a criação e o uso de parâmetros e campos calculados. Para obter informações, consulte [Criar parâmetros](https://help.tableau.com/v0.0/pro/desktop/pt-br/parameters_create.htm) e [Criar um campo calculado](https://help.tableau.com/v0.0/pro/desktop/pt-br/calculations_calculatedfields_create.htm#Create).

Para obter exemplos adicionais de como usar ações de parâmetro, consulte:

- [Como e quando usar ações de parâmetro](https://www.tableau.com/pt-br/about/blog/2019/5/parameter-actions-extend-interactivity)
- [Ações de parâmetro: navegador KPI](https://medium.com/@flymperopoulos/parameter-actions-kpi-navigator-8457b397be25)
- [Ações do parâmetro: comparação ano a ano](https://medium.com/@flymperopoulos/parameter-actions-year-over-year-comparison-320a9a896553)
- [Ações de parâmetro: análise em camadas](https://medium.com/@flymperopoulos/parameter-actions-layered-analysis-5f274728523e)
- [Ações de parâmetro: concatenação](https://medium.com/@flymperopoulos/parameter-actions-concatenation-e0c9ec82a34e)
- [3 formas criativas de usar as Ações de parâmetro do Tableau](https://playfairdata.com/3-creative-ways-to-use-tableau-parameter-actions/) a partir do Tableau Visionary Ryan Sleeper no site [PlayfairData](https://playfairdata.com/).
- [Prévia das ações de parâmetro do Tableau](https://vizpainter.com/parameter-actions-in-tableau-2019-2-sneak-peek/) a partir do Tableau Visionary Joshua Milligan no site [VizPainter](https://vizpainter.com/) .

### Transformar linhas de referência em dinâmicas

Este exemplo demonstra como você poderia usar uma ação de parâmetro para atualizar interativamente uma linha de referência, sem usar um cálculo.

As linhas de referência fornecem uma maneira conveniente de comparar valores em uma visualização. Em seguida, você pode usar as ações de parâmetro para tornar as linhas de referência dinâmicas. Associe a linha de referência a um parâmetro e, em seguida, usar uma ação de parâmetro para tornar o parâmetro interativo. À medida que os usuários interagem com a exibição, as linhas de referência são atualizadas automaticamente para fornecer mais contexto aos dados.

![Atualizando uma ação de parâmetro em uma visualização.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_reflineupdate.gif)

Os campos a seguir são usados nesta exibição.

![Um gráfico de linhas de séries temporais exibe o valor de vendas ao longo de seis meses de maçãs, frutas cítricas e peras em quatro mercados diferentes.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_fields.png)

Detalhes de exemplo de linhas de referência dinâmicas

1. Crie o parâmetro O parâmetro é denominado _Threshold_. O tipo de dados é definido como Flutuante.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_reflineparam.png)
2. Crie uma linha de referência que use o parâmetro Threshold. O rótulo está definido como Valor. A opção Preenchimento abaixo está definida como uma cor cinza clara.

![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_referenceline.png)

4. Crie uma ação de parâmetro. Essa ação faz referência ao parâmetro Threshold e ao campo Valores. A ação é executada ao Focalizar.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_reflineaction.png)
5. Teste a ação de parâmetro na planilha. Focalizar o cursor sobre uma marca atualiza a linha de referência para ver como esse valor aparece no contexto com as outras categorias de dados.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter_actions_reflinetest.gif)

### Exibir uma hierarquia seletiva

Este exemplo demonstra como você poderia usar uma ação de parâmetro referenciada por um campo calculado para permitir que seu público controle quais informações estão sendo exibidas em um modo de exibição.

![Uma ação de parâmetro mostra a AVG(Vendas) ou COUNTD(Pedidos) das marcas atualmente selecionadas.](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter_actions_overview.gif)

Um uso comum de parâmetros é usar um parâmetro para alterar o valor de entrada em um cálculo. Este exemplo usa um parâmetro _ChooseAType_ para o tipo de fruta e um campo calculado _Varieties_ que retorna as variedades do tipo de fruta. O campo calculado foi adicionado ao modo de exibição em vez do campo original _Fruit variety._ Os usuários podem selecionar um tipo de fruta utilizando um controle de parâmetro para alterar o tipo de fruta e as variedades exibidas.

![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_example_display1.png)

Usar um parâmetro com um cálculo e um controle de parâmetro para alterar interativamente um valor de parâmetro

Essa é uma maneira de permitir que os usuários explorem os dados na exibição. As ações de parâmetro tornam esse mesmo cenário possível, mas com funcionalidade e benefícios adicionais. Ao criar uma ação de parâmetro que atualiza o valor do parâmetro com base em um usuário interagindo com as marcas na exibição:

- A interação do usuário com a visualização é mais natural. Seus usuários podem permanecer no fluxo de exploração de dados. Em vez de precisar interagir com um controle de parâmetro, os usuários podem focalizar ou clicar na visualização para atualizar o valor do parâmetro.
- Se a fonte de dados for atualizada em algum momento no futuro, e os valores de tipo de fruta e de variedade de frutas forem adicionados, esses valores serão exibidos automaticamente na visualização e estarão automaticamente disponíveis para o parâmetro.

Para incorporar ações de parâmetro, este exemplo usa uma segunda planilha (_Fruit type_) que consiste nos nomes dos tipos de fruta. As duas planilhas (_Fruit type_ e _Varieties_) são combinadas em um painel (_Fruits_).

Detalhes do exemplo de hierarquia seletiva

1. A pasta de trabalho mostrada na imagem acima usa o parâmetro _ChooseAType_ e o campo calculado _Varieties_.
    
    O parâmetro _ChooseAType_ é definido para permitir _Todos os valores_.
    
    ![Caixa de diálogo Editar parâmetro com campos para nome, tipo de dados, valor atual, formato de exibição e valores permitidos.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_display5.png)
    
    O campo calculado _Varieties_ referencia o parâmetro _ChooseAType_ para mostrar os valores do campo _Fruit variety_ com base no valor atual selecionado para _Fruit type_.
    
    ![A caixa de diálogo para criar um campo calculado.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_display6.png)
2. A pasta de trabalho usa uma ação de parâmetro chamada _Select Fruit_. Para criar a ação de parâmetro, o autor clicou em uma planilha e, em seguida, selecionou Planilha > Ações > Adicionar ação > Alterar parâmetro.
    
    A ação usa a fonte de dados Fruit. Como o parâmetro e o cálculo precisam estar cientes do campo _Fruit Type_ para funcionar, tanto a planilha _Fruit_ Type quanto a _Varieties_ precisam ser selecionadas.
    
    ![Caixa de diálogo Editar ação de parâmetro com opções para nomear, escolher planilha de origem e executar ações.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_display3.png)
    
    O parâmetro _ChooseAType_ está associado ao campo _Fruit_ Type. A ação de parâmetro será executada sempre que um usuário focalizar sobre o texto do tipo de fruta no painel _Fruits_ ou na planilha _Fruit Type_.
    
    Na planilha _Varieties_, o campo _Fruit Type_ está na divisória Linhas, mas a opção Mostrar cabeçalho está desmarcada para esse campo para remover o rótulo do tipo de frutas desse modo de exibição.
    
    ![Um gráfico de linhas exibe o volume de vendas semanais de cada variedade de fruta.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameter_display4.png)
3. Teste a ação de parâmetro no painel Fruits. Focalize sobre as atualizações do tipo de fruta para mostrar as variedades dessa fruta.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/parameter_actions_display7.gif)

### Exibir dados resumidos das marcas selecionadas

Obter estatísticas de resumo para um subconjunto de dados é uma ferramenta analítica muito importante. Este exemplo mostra como você pode usar ações de parâmetro agregadas das marcas selecionadas para gerar automaticamente dados de resumo.

Esta exibição de uma planilha denominada Opções mostra variedades de frutas e seus mercados desejados.

![Um gráfico de formas ilustra o preço médio de várias frutas em diferentes pontos de venda.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata1.png)

O campo SUM(Valores) precisa estar presente nas duas planilhas para que o parâmetro funcione. SUM(Valores) é colocado em Detalhe, no cartão Marcas nesta exibição.

O modo de exibição Opções anteriores funcionará como um seletor para essa segunda exibição, um gráfico de dispersão que plota as mesmas marcas em relação ao valor total e à quantidade. SUM(Valores) é colocado em Linhas nesta exibição.

![Um gráfico de dispersão que mostra a relação entre o valor e a quantidade de frutas vendidas, com codificação de cores para variedade de frutas e mercado.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata2.png)

Uma ação de parâmetro será usada para fazer com que as duas exibições funcionem juntas em um painel.

![Uma ação de parâmetro usada para fazer com que duas exibições funcionem juntas em um painel.](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata_dashboard.gif)

Detalhes de exemplo dos dados de resumo

1. Crie o parâmetro Esse parâmetro é denominado _Valor Médio_. O tipo de dados é definido como Flutuante.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summary_parameter.png)
2. Crie uma linha de referência que use o parâmetro Valor médio. O rótulo é definido como Personalizado com o texto "Valor médio: <Value>". A opção Linha é definida como uma cor marrom.

![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summary_refline.png)

4. As duas planilhas são combinadas em um painel. Para criar a ação de parâmetro, clique na guia do painel e selecione Painel > Ações > Adicionar ação > Alterar parâmetro.

A ação é denominada _Valor médio_. O parâmetro de destino faz referência ao parâmetro Valor médio. O campo de origem é definido como SUM(Valores) (Fruta).

A configuração da agregação é onde as informações de estatísticas de resumo são reproduzidas. Ao escolher Média, Mediano, Contar etc., você configura o parâmetro para atualizar com a estatística de sua escolha.

A agregação está definida como Média. Observe também que a agregação do campo de origem na exibição pode ser diferente da agregação usada para a ação de parâmetro.

![](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata_createaction.png)

Opcionalmente, também é possível criar uma ação de destaque para marcas selecionadas no modo de exibição Opções.

![](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata_highlightaction.png)

11. Teste a ação de parâmetro no painel. À medida que você seleciona cabeçalhos e marca, a linha de referência atualiza dinamicamente e exibe a média dos valores.
    
    ![Exemplo de ação de parâmetro](/tableau/next/pt-br/pro/desktop/pt-br/Img/actions_parameters_summarydata_test.gif)