Usando um controle com um parâmetro na Amazon QuickSight

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.

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).

2. 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.

3. 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 (Seletor de data)

     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 Personalização de formatos de data na Amazon QuickSight.

4. (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.

5. (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).

6. (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 (EXCETO filtros de cima para baixo).

     • Um controle de filtro numérico não agregado.

     • Um controle de filtro de data (EXCETO filtros de cima para baixo).

7. 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 na Amazon QuickSight.

• Delete (Excluir) remove o controle. Você pode recriá-lo ao escolher o menu de contexto do parâmetro.

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.