As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando um controle com um parâmetro no Amazon Quick
<a name="parameters-controls"></a>

Nos painéis, os controles de parâmetro são exibidos na parte superior da folha de dados, que contém um conjunto de visuais. Fornecer um controle permite que os usuários escolham um valor a ser usado em um filtro predefinido ou ação de URL. Os usuários do painel podem usar controles para aplicar filtragem em todos os conjuntos de dados de elementos visuais em um painel, sem a necessidade de criar os próprios filtros. 

As seguintes regras se aplicam:
+ Para criar ou editar um controle para um parâmetro, certifique-se de que o parâmetro exista. 
+ Os controles de lista de seleção múltipla são compatíveis com URLs de análise, URLs de painel, ações personalizadas e filtros personalizados. O filtro deve ser igual, ou não ser igual, aos valores fornecidos. Nenhuma outra comparação tem suporte. 
+ As listas mostram, no máximo, mil valores. Se houver mais de mil valores distintos, uma caixa de pesquisa será exibida para que você possa filtrar a lista. Quando a lista filtrada contém menos de 1.001 valores, o conteúdo da lista aparece como itens de linha.
+ A opção **Style (Estilo)** exibe somente os tipos de estilo que são apropriados para o tipo de dados e para a configuração de valor único ou de vários valores do parâmetro. Se o estilo que você deseja usar não estiver na lista, crie novamente o parâmetro com as configurações apropriadas e tente novamente.
+ Se o seu parâmetro estiver vinculado a um campo de conjunto de dados, ele deverá ser um campo real. Não há suporte para campos calculados.
+ Os valores são exibidos em ordem alfabética no controle, a menos que haja mais de mil valores distintos. O controle exibe uma caixa de pesquisa em vez disso. Toda vez que pesquisar o valor que deseja usar, ele inicia uma nova consulta. Se os resultados tiverem mais de mil valores, você poderá percorrer os valores com paginação. Há suporte para a pesquisa curinga. Para saber mais sobre a pesquisa curinga, consulte [Como usar a pesquisa curinga](search-filter.md#search-filter-wildcard).

Use o procedimento a seguir para criar ou editar um controle para um parâmetro existente. 

**Criar ou editar um controle para um parâmetro existente**

1. Escolha um menu de contexto do parâmetro existente, o ícone `v` ao lado do nome do parâmetro e selecione **Add control (Adicionar controle)**.

1. Insira um nome para dar um rótulo ao novo controle. Esse rótulo aparece na parte superior do espaço de trabalho e, posteriormente, na parte superior da planilha na qual um painel é exibido. 

1. Escolha um estilo para o controle, entre as seguintes opções:
   + **Campo de texto**

     Um campo de texto permite que você digite seu próprio valor. Um campo de texto funciona com números e com textos (strings).
   + **Campo de texto (multilinha)**

     Um campo de texto multilinha permite que você digite seus próprios valores. Com esta opção, você pode optar por separar os valores inseridos no controle de parâmetros por uma quebra de linha, vírgula, barra vertical (\|) ou ponto e vírgula. Um campo de texto funciona com números e com textos (strings).
   + **Suspenso**

     Um controle de lista suspenso que você pode usar para selecionar um único valor. Um controle de lista funciona com números e com textos (strings). 
   + **Suspenso (seleção múltipla)**

     Um controle de lista que você pode usar para selecionar vários valores. Um controle de lista funciona com números e com textos (strings). 
   + **Lista**

     Um controle de lista que você pode usar para selecionar um único valor. Um controle de lista funciona com números e com textos (strings). 
   + **Lista (seleção múltipla)**

     Um controle de lista que você pode usar para selecionar vários valores. Um controle de lista funciona com números e com textos (strings). 
   + **Slider**

     Um controle deslizante permite que você selecione um valor numérico ao deslizar o controle de uma extremidade à outra da barra. O controle deslizante funciona com números.
   + **Date-picker**

     Ao usar um seletor de data, você pode escolher uma data em um controle de calendário. Ao optar por adicionar um controle de seletor de data, é possível personalizar como formatar datas no controle. Para fazer isso, em **Formato de data**, insira o formato de data desejado usando os tokens descritos em [Personalizando formatos de data no Quick](format-visual-date-controls.md).

1. (Opcional) Se você escolher um controle suspenso, a tela se expandirá para que você possa escolher os valores a serem exibidos. É possível especificar uma lista de valores ou usar um campo em um conjunto de dados. Escolha uma das seguintes opções:
   + **Specific values (Valores específicos)**

     Para criar uma lista de valores específicos, digite um por linha, sem espaços ou vírgulas como separação, conforme exibido na captura de tela a seguir.

     No controle, os valores são exibidos em ordem alfabética, não na ordem em que você os digitou.
   + **Link to a data set field (Link para campo do dataset)**

     Para vincular a um campo, escolha o conjunto de dados que contém seu campo e, em seguida, escolha o campo na lista.

     Se você alterar os valores padrão no parâmetro, escolha **Reset (Redefinir)** no controle para mostrar os novos valores.

   Os valores que você escolhe aqui são unidos com os valores padrão estáticos nas configurações do parâmetro.

1. (Opcional) Habilite a opção **Ocultar a opção [TODOS] do controle se o parâmetro tiver um padrão configurado**. Ao fazer isso, somente os valores dos dados serão mostrados e a opção de selecionar todos os itens será removida no controle. Se você não configurar um padrão estático no parâmetro, esta opção não funcionará. Você pode adicionar um padrão depois de adicionar um controle escolhendo o parâmetro e selecionar **Edit parameter (Editar parâmetro)**.

1. (Opcional) Você pode limitar os valores exibidos nos controles para que mostrem apenas os valores que são válidos de acordo com a seleção em outros controles. Isso se chama um controle em cascata. 

   Para criar um, escolha **Show relevant values only (Mostrar somente valores relevantes)**. Escolha um ou mais controles que podem alterar o que é exibido neste controle. 

   Ao criar controles em cascata, aplicam-se as limitações a seguir.
   + Os controles em cascata devem estar vinculados às colunas do conjunto de dados do mesmo conjunto de dados.
   + O controle secundário deve ser um controle suspenso ou de lista.
   + Para controles de parâmetros, o controle secundário deve estar vinculado a uma coluna do conjunto de dados.
   + Para controles de filtro, o controle secundário deve estar vinculado a um filtro (em vez de mostrar somente valores específicos).
   + O controle primário deve ser um dos seguintes:
     + Um controle de string, número inteiro ou parâmetro numérico.
     + Um controle de filtro de string (EXCLUINDO Top-Bottom filtros).
     + Um controle de filtro numérico não agregado.
     + Um controle de filtro de data (EXCLUINDO Top-Bottom filtros).

1. Quando terminar a escolha de opções para seu controle, escolha **Add (Adicionar)**.

O controle finalizado é exibido na parte superior do espaço de trabalho. O menu de contexto, com a forma de um `v`, oferece quatro opções:
+ **Reset (Redefinir)** restaura a seleção do usuário para o estado padrão.
+ **Atualizar lista** se aplica somente a menus suspensos vinculados a um campo em um conjunto de dados. Escolher **Refresh list (Atualizar lista)** consulta os dados em busca de alterações. Os dados usados no controle são armazenados em cache.
+ **Edit (Editar)** reabre a tela de criação de controle para que você possa alterar suas configurações.

  Após abrir o painel **Editar controle**, você pode clicar em diferentes elementos visuais e controles para visualizar os dados de formatação para o elemento visual ou para o controle específico. Para obter mais informações sobre a formatação de um elemento visual, consulte [Formatação no Amazon Quick](formatting-a-visual.md).
+ **Delete (Excluir)** remove o controle. Você pode recriá-lo ao escolher o menu de contexto do parâmetro.

## Configurando a classificação personalizada para controles
<a name="parameters-controls-custom-sort"></a>

Você pode configurar uma ordem de classificação personalizada para os controles de parâmetros para alterar a forma como os valores aparecem na lista de controle. Por padrão, os controles exibem valores na ordem definida pelo usuário. Você pode personalizar isso para classificar em ordem crescente ou decrescente ou classificar por um campo relacionado no conjunto de dados.

**Para configurar a classificação personalizada para um controle**

1. Escolha o controle de parâmetros na planilha.

1. Escolha o ícone de lápis para abrir o painel de **controle de formatação**.

1. No painel de **controle Formatar**, localize a seção **Classificar**.

1. Configure as opções de classificação. Observe que as opções de classificação dependem se o controle usa valores específicos ou está vinculado a um campo de conjunto de dados.

### Opções de classificação por tipo de controle
<a name="parameters-controls-sort-options"></a>

**Controles de classificação com valores específicos**  
Se o controle usar valores específicos, escolha uma das seguintes opções de classificação:
+ **Crescente (A—Z, 0—9)** — Classifica os valores em ordem crescente.
+ **Decrescente (Z—A, 9—0)** — Classifica os valores em ordem decrescente.
+ **User-defined ordem** — Exibe os valores na ordem exata em que você os inseriu, sem nenhuma classificação automática. Esse é o padrão.

**Controles de classificação vinculados a um campo de conjunto de dados**  
Se o controle estiver vinculado a um campo do conjunto de dados, você poderá classificar pela própria coluna do controle ou por outro campo no mesmo conjunto de dados.
+ **Classificar por coluna de controle** — Classifica valores com base no campo ao qual o controle está vinculado. Escolha uma direção de classificação (**Crescente** ou **Decrescente**) e, opcionalmente, escolha uma função de agregação. Escolha **Sem agregação** para classificar pelos valores brutos da coluna.
+ **Classificar por outro campo** — Classifica valores com base em uma coluna em qualquer conjunto de dados de análise. Para campos calculados, somente colunas calculadas escalares (não agregadas) estão disponíveis. Escolha um campo de classificação, uma direção de classificação e uma função de agregação. Isso é útil para ordenar valores por uma métrica relacionada, como classificar regiões pela receita total.

**nota**  
As funções de agregação disponíveis dependem do tipo de dados da coluna selecionada. ****Para campos numéricos, as opções incluem **Sem agregação**, **Soma**, **Média**, **Contagem, Contagem** **distinta**, **Mínimo**, **Máximo**, **Mediana**, **Percentil**, Var e Stdev.**** **Para campos não numéricos, as opções incluem **Sem agregação**, **Contagem e Contagem** distinta.**

No espaço de trabalho, você também pode redimensionar e reorganizar os controles. Os usuários do painel os veem à medida que você os fizer, mas não podem editá-lo nem excluí-lo.