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á. # Trabalhando com planilhas interativas no Amazon Quick Sight *Planilha interativa* é uma coleção de dados expressos em elementos visuais com os quais os usuários podem interagir quando a planilha é publicada em um painel. Os autores do Amazon Quick podem adicionar diferentes layouts, controles e filtros às suas planilhas interativas que os visualizadores do painel podem usar para obter informações detalhadas dos dados publicados. Por padrão, cada planilha em uma análise é uma planilha interativa. Se sua conta não tiver o **complemento de relatórios perfeito do Pixel**, você só poderá criar e publicar planilhas interativas. Para obter mais informações sobre como criar uma planilha interativa, consulte [Iniciando uma análise no Quick Sight](creating-an-analysis.md). Para obter mais informações sobre formatação de planilhas interativas, consulte os tópicos a seguir. **Topics** + [Personalização de layouts de painéis no Amazon Quick Sight](customizing-dashboards-and-visuals.md) + [Parâmetros no Amazon Quick](parameters-in-quicksight.md) + [Como usar ações personalizadas para filtros e navegação](quicksight-actions.md) # Personalização de layouts de painéis no Amazon Quick Sight É possível personalizar o layout de um painel para organizar os dados de acordo com seus requisitos de negócios. Você pode escolher entre três layouts para o painel. Além disso, é possível alterar o tamanho, a cor de fundo, a cor da borda e as interações de um elemento visual para criar um painel totalmente personalizado. Use os tópicos a seguir para saber mais sobre como personalizar painéis e elementos visuais. **Topics** + [Tipos de layout](types-of-layout.md) + [Como escolher de um layout](choosing-a-layout.md) + [Personalização de elementos visuais em um layout de forma livre](customizing-visuals-in-free-form.md) + [Regras condicionais](conditional-rules.md) # Tipos de layout Existem três designs de layout de painel que você pode escolher: **Lado a lado**, **Forma livre** e **Clássico**. ## Layout lado a lado Os elementos visuais em um layout **lado a lado** se ajustam a uma grade com espaçamento e alinhamento padrão. Você pode criar elementos visuais de qualquer tamanho e colocá-los onde quiser em um painel, mas os elementos visuais não podem se sobrepor. ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/fixed-layouts-tiled-demo.gif) Os painéis são exibidos conforme projetados, com opções de ajuste ao tamanho da tela ou com visualização em tamanho real. Você também pode ajustar um painel inteiro à sua janela ao escolher **Ajustar à janela** para **Visualização** no canto superior direito. Esta opção era anteriormente chamada de **Otimização**. **nota** Em dispositivos móveis, os painéis com layout lado a lado aparecem como uma única coluna no modo retrato ou exatamente como projetados no modo paisagem. ## Layout de forma livre Os elementos visuais em um layout de **forma livre** podem ser colocados em qualquer lugar do painel usando coordenadas precisas. Você pode arrastar um elemento visual para o local exato desejado ou pode inserir as coordenadas do local para o elemento visual. Use o procedimento apresentado a seguir para inserir as coordenadas exatas do local para o elemento visual. ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/fixed-layouts-freeform-placement1.gif) Os painéis são exibidos da maneira que você escolher projetá-los, com opções de ajuste ao tamanho da tela ou com visualização em tamanho real. É possível otimizar os layouts de forma livre para a visualização em resoluções específicas, sendo o padrão 1.600 pixels. Você também pode ajustar um painel inteiro à janela de um navegador ao escolher **Ajustar à janela** para **Visualização** no canto superior direito. **nota** Os painéis com resoluções otimizadas poderão aparecer maiores ou menores no computador do visualizador se a resolução do computador do visualizador não for igual à resolução definida para o painel. Alternar da **forma livre** para outro layout pode causar a alteração de alguns elementos visuais. Em dispositivos móveis, os painéis de **forma livre** aparecem como publicados, sem alterações no layout. ## Layout clássico Os elementos visuais em um layout **clássico** se ajustam a uma grade com espaçamento e alinhamento padrão. Os painéis ocultam dados ou alteram a formatação para se ajustarem em telas menores. Por exemplo, se você alterar um elemento visual para torná-lo consideravelmente menor, o menu e os editores dos elementos visuais serão ocultos para que haja mais espaço para a exibição dos elementos do gráfico. Os visuais de gráfico de barras também exibem menos pontos de dados. Se você reduzir o tamanho da janela do navegador, o Amazon Quick Sight redimensionará e, se necessário, reordenará as imagens para uma exibição ideal. Por exemplo, visuais menores que estavam lado a lado poderão ser exibidos sequencialmente. O layout original é restaurado quando o tamanho da janela do navegador é aumentado novamente. **nota** Em dispositivos móveis, os painéis com layout clássico aparecem como uma única coluna ou exatamente como projetados no modo paisagem. # Como escolher de um layout **Alterar o layout de um painel** 1. Abra o [console Quick](https://quicksight.aws.amazon.com/). 1. Na página inicial do Quick, escolha **Análises** e, em seguida, escolha a análise que você deseja alterar. 1. Na página de análise, escolha **Editar** e, em seguida, selecione **Configurações de análise**. 1. Expanda o **Layout da planilha** e escolha o layout que você deseja usar. 1. Quando terminar, escolha **Apply (Aplicar)**. # Personalização de elementos visuais em um layout de forma livre É possível usar o layout de forma livre para personalizar totalmente a cor, o tamanho, o local e a visibilidade de cada elemento visual em um painel. ## Como organizar elementos visuais Além de arrastar um elemento visual para o local de sua preferência em um painel, há muitas maneiras diferentes de mover um elemento visual para o local exato em que ele precisa estar. **Inserir as coordenadas do local de um elemento visual** 1. Escolha o elemento visual que você deseja usar. 1. No menu no canto superior direito do elemento visual, selecione o ícone **Formatar elemento visual**. 1. No painel **Propriedades** que será aberto, escolha **Posicionamento**. 1. Insira as coordenadas **X** e **Y** do local em que você deseja posicionar seu elemento visual. Também é possível ajustar o tamanho do elemento visual ao inserir valores de **Largura** e de **Altura**. Imagens selecionadas também podem ser movidas pixel-by-pixel usando as teclas de seta do teclado. Você pode sobrepor elementos visuais uns sobre os outros para criar elementos visuais em várias camadas que mostram dados. Os elementos visuais podem ser organizados em várias camadas que podem ser movidas para frente e para trás manualmente. **Mover elementos visuais sobrepostos para frente e para trás** 1. Escolha o elemento visual que você deseja usar. 1. **No menu de três pontos no canto superior direito do visual, escolha Opções de menu.** 1. Em **Opções de menu**, escolha uma das seguintes opções: + **Enviar para trás** envia o elemento visual para trás. + **Recuar** recua o elemento visual em uma camada. + **Avançar** avança o elemento visual em uma camada. + **Trazer para frente** envia o elemento visual para frente. ## Como alterar a cor de fundo de um elemento visual As cores do plano de fundo, da borda e da moldura de seleção de um elemento visual podem ser personalizadas no painel de **Configurações de exibição**, no painel **Propriedades**. **Para alterar a cor do plano fundo, da borda ou da moldura de seleção de um elemento visual** 1. Escolha o elemento visual que você deseja alterar. 1. No menu localizado no canto superior direito do elemento visual, escolha o ícone **Propriedades**. 1. No painel **Propriedades** que aparecerá à esquerda, escolha **Configurações de exibição**. 1. Navegue até a seção **Estilo de cartão** e realize uma ou mais das ações disponíveis: + Para alterar a cor do plano de fundo de um elemento visual, selecione a caixa de cores **Plano de fundo** e, em seguida, escolha a cor desejada. + Para alterar a cor da borda de um elemento visual, selecione a caixa de cores **Borda** e, em seguida, escolha a cor desejada. + Para alterar a cor da moldura de seleção de um elemento visual, selecione a caixa de cores **Seleção** e, em seguida, escolha a cor desejada. Se você desejar usar uma cor personalizada para o plano de fundo, para a borda ou para a moldura de seleção do elemento visual, escolha a caixa de cores da propriedade que deseja alterar e, em seguida, selecione **Cor personalizada**. Na janela **Cor personalizada** que aparecerá, escolha a cor personalizada ou insira o código hexadecimal da cor de sua preferência. Ao concluir, selecione **Apply (Aplicar)**. Além disso, é possível restaurar o plano de fundo personalizado de um elemento visual para a aparência padrão. **Redefinir a aparência de um elemento visual** 1. Escolha o elemento visual que você deseja alterar. 1. No menu localizado no canto superior direito do elemento visual, escolha o ícone **Propriedades**. 1. No painel **Propriedades** que aparecerá à esquerda, escolha **Configurações de exibição**. 1. Escolha a cor que você deseja redefinir e, em seguida, selecione **Restaurar para o padrão**. ## Como ocultar planos de fundo, bordas e cores da seleção de um elemento visual Você também pode optar por não mostrar a borda do plano de fundo ou a cor da seleção de um elemento visual. Isso é útil quando você deseja sobrepor vários elementos visuais. É possível ocultar as cores do plano de fundo, da borda e da seleção de um elemento visual ao selecionar o ícone de olho ao lado das caixas de cores de **Borda**, **Plano de fundo** ou **Seleção**. Além disso, você pode remover a animação de carregamento de um elemento visual ao desmarcar a caixa de seleção **Mostrar animação de carregamento**. ## Como desabilitar os menus de um elemento visual Use o painel **Interações** no painel **Propriedades** para ocultar o menu **Contexto** e o menu do **Elemento visual** dos elementos visuais selecionados. É possível ocultar os menus secundários do elemento visual para deixar o visual menos sobrecarregado ou para que ele funcione como uma sobreposição. O menu de **contexto** é aberto ao clicar nos pontos de dados. As ações comuns no **menu de contexto** incluem **Foco**, **Excluir** e **Busca detalhada**. O menu em **elemento visual** aparece no lado superior direito de um elemento visual. O menu **Em elemento visual** é usado para acessar o painel **Propriedades**, **Maximizar** o elemento visual, acessar o painel **Opções de menu** e analisar **Insights sobre anomalias**. É possível desativar os menus secundários de um elemento visual ao desmarcar as opções **menu de contexto** e **menu em elemento visual**. **nota** Não é possível visualizar as alterações no painel **Interações** em **Análises**. Publique o painel para visualizar suas alterações. # Regras condicionais No momento, este recurso está disponível com o layout de **forma livre**. As regras condicionais são usadas para ocultar ou mostrar elementos visuais quando condições específicas são atendidas. As regras podem ser úteis quando você tem várias versões sobrepostas de um mesmo elemento visual e deseja que o visualizador do painel visualize a versão que melhor representa o valor do parâmetro selecionado. As regras condicionais usam parâmetros e controles de parâmetros para ocultar e mostrar elementos visuais. Os parâmetros são variáveis com nomes definidos capazes de transferir um valor para ser usado por uma ação ou um objeto. Este recurso oferece suporte a parâmetros de string e de número. Para tornar os parâmetros acessíveis ao visualizador do painel, você adiciona um controle de parâmetro. Um controle de parâmetros permite que os usuários escolham um valor para usar em um filtro definido previamente ou em uma ação de URL. Para obter mais informações sobre os parâmetros e os controles de parâmetros, consulte [Parâmetros no Amazon Quick](parameters-in-quicksight.md). Use as seções apresentadas abaixo para configurar e usar regras condicionais. **Topics** + [Ocultação de um elemento visual por padrão](hiding-a-visual-by-default.title.md) + [Definição de uma regra condicional](setting-a-conditional-rule.title.md) + [Como usar regras condicionais](using-conditional-rules.md) # Ocultação de um elemento visual por padrão No painel **Interações** do painel **Propriedades**, é possível escolher ocultar um elemento visual por padrão. Fazer isso pode ser útil se você desejar que o visualizador veja somente elementos visuais com base em condições específicas. **Ocultar um elemento visual por padrão** 1. Na página inicial do Quick, escolha **Análises** e, em seguida, escolha a análise que você deseja personalizar. 1. Escolha o elemento visual ao qual você deseja adicionar uma regra. 1. No menu no canto superior direito do elemento visual, selecione **Propriedades**. 1. No painel **Propriedades** que será aberto, escolha **Interações** e abra o menu suspenso **Regras**. 1. No menu **Regras**, escolha **Ocultar este elemento visual por padrão**. Os elementos visuais ocultos aparecem totalmente ocultos em um painel de visualização. No painel **Análises**, os elementos visuais ocultos ficam visíveis com a mensagem “Oculto com base em regra”. Com esta exibição, você pode visualizar o local no qual todos os elementos visuais de um painel estão localizados. **nota** Não é possível criar regras condicionais que ocultem elementos visuais que já estão ocultos por padrão ou que mostrem elementos visuais que já aparecem por padrão. Se você alterar a aparência padrão de um elemento visual, as regras existentes que contradizem a nova aparência padrão serão desabilitadas. # Definição de uma regra condicional Ao configurar uma regra condicional, você cria uma instrução condicional que ocultará ou mostrará um elemento visual quando uma condição específica for atendida. No momento, é possível criar regras condicionais que ocultam ou mostram um elemento visual. Se você deseja criar uma regra condicional que faça com que um elemento visual oculto apareça, selecione **Ocultar este elemento visual por padrão** no menu **Regras** do painel **Propriedades**. **nota** Antes de começar, crie um parâmetro e um controle de parâmetros correspondente para basear a nova regra condicional. Os parâmetros com suporte são parâmetros de string e parâmetros de números. Para obter mais informações sobre os parâmetros e os controles de parâmetros, consulte [Parâmetros no Amazon Quick](parameters-in-quicksight.md). **Definir uma regra condicional** 1. Na página inicial do Quick, escolha **Análises** e, em seguida, escolha a análise que você deseja personalizar. 1. Escolha o elemento visual ao qual você deseja adicionar uma regra. 1. No menu no canto superior direito do elemento visual, selecione **Propriedades**. 1. No painel **Propriedades** que aparecerá à esquerda, escolha **Interações** e, em seguida, selecione **Regras**. 1. Escolha **ADICIONAR REGRA**. 1. No primeiro menu do painel **Adicionar regra**, escolha o parâmetro desejado. 1. No segundo menu do painel **Adicionar regra**, escolha a condição desejada. Para parâmetros de string, as condições com suporte são **Igual a**, **Inicia com**, **Contém** e **Não é igual a**. Para parâmetros de número, as condições com suporte são **Igual a**, **Inicia com**, **Contém** e **Não é igual a**. 1. Insira o valor que você deseja que a regra condicional atenda. **nota** Os valores diferenciam maiúsculas de minúsculas. 1. Escolha **Adicionar regra** para aplicar a nova regra condicional ao elemento visual. Para cancelar a regra, escolha **Cancelar**. As regras condicionais também podem ser editadas e excluídas. **Editar uma regra condicional** 1. No menu no canto superior direito do elemento visual, selecione **Propriedades**. 1. No painel **Propriedades** que aparecerá à esquerda, escolha **Interações** e, em seguida, selecione **Regras**. 1. Escolha o ícone do menu no lado direito da regra que deseja editar e selecione **Editar**. 1. Faça as alterações desejadas e escolha **Salvar**. **Excluir uma regra condicional** 1. No menu no canto superior direito do elemento visual, selecione **Propriedades**. 1. No painel **Propriedades** que aparecerá à esquerda, escolha **Interações** e, em seguida, selecione **Regras**. 1. Escolha o ícone do menu no lado direito da regra que deseja editar e selecione **Excluir**. # Como usar regras condicionais Depois de configurar uma regra condicional conectada a um parâmetro e a um controle de parâmetros, você poderá usar o controle de parâmetros para habilitar ou desabilitar as regras condicionais definidas. **Habilitar uma regra condicional** 1. Na página inicial do Quick, escolha **Análises** e, em seguida, escolha a análise que você deseja personalizar. 1. Na barra **Controles** na parte superior do seu espaço de trabalho, escolha o ícone do menu suspenso. 1. Escolha o controle de parâmetros associado à regra condicional que você criou. 1. Escolha o valor associado à regra condicional que você criou usando o menu do parâmetro. Você também pode inserir o valor desejado na caixa **Pesquisar valor**. **nota** Os valores diferenciam maiúsculas de minúsculas. Selecionar o valor correto faz com que o elemento visual apareça ou desapareça com base na regra definida. Também é possível trazer um controle de parâmetros para a planilha em que seu elemento visual está. Isso é útil quando você deseja que um controle de parâmetros fique próximo ao elemento visual ao qual ele está associado ou quando deseja adicionar uma regra condicional ao controle para que ele apareça somente quando condições específicas forem atendidas. **Trazer um controle de parâmetros para uma planilha** 1. Na página inicial do Quick, escolha **Análises** e, em seguida, escolha a análise que você deseja personalizar. 1. Na barra **Controles** na parte superior do seu espaço de trabalho, escolha o controle que deseja mover. 1. No lado superior direito do controle, abra o menu **Opções de menu**. 1. Escolha **Mover para a planilha**. **Retornar um controle de parâmetros para a barra Controles** 1. No seu painel, selecione o controle de parâmetros que deseja mover. 1. No lado superior direito do controle, abra o menu **Opções de menu**. 1. Escolha **Mover para o topo da planilha**. # Parâmetros no Amazon Quick Os *parâmetros* são variáveis com nomes definidos capazes de transferir um valor para ser usado por uma ação ou um objeto. Ao usar parâmetros, você pode criar uma maneira mais fácil para um usuário do painel interagir com os recursos do painel de uma forma menos técnica. Os parâmetros também podem conectar um painel a outro, permitindo que um usuário de um painel analise dados de um outra análise. Por exemplo, o usuário de um painel pode usar uma lista para escolher um valor. Esse valor define um parâmetro que, por sua vez, define um filtro, cálculo ou ação de URL para o valor escolhido. Em seguida, os visuais no painel reagem às escolhas do usuário. Para tornar os parâmetros acessíveis ao visualizador do painel, você adiciona um controle de parâmetro. Você pode configurar controles em cascata, de forma que uma seleção em um controle filtre as opções que são exibidas em outro controle. Um controle pode aparecer como uma lista de opções, um controle deslizante ou uma área de entrada de texto. Se não criar um controle, você ainda poderá passar um valor para o parâmetro no URL do painel. Para que um parâmetro funcione, ele precisa estar conectado a algo em sua análise, independentemente de ter um controle relacionado. Você pode fazer referência a parâmetros da seguinte forma: + Campos calculados (exceto para parâmetros com vários valores) + Filtros + Painel e análise URLs + Ações + Títulos e descrições ao longo de uma análise Algumas maneiras como você pode usar parâmetros: + Usando um cálculo, você pode transformar os dados exibidos em uma análise. + Se você adicionar um controle com um filtro a uma análise que está publicando, os usuários do painel poderão filtrar os dados sem criar seus próprios filtros. + Ao usar controles e ações personalizadas, você pode permitir que os usuários do painel definam valores para as ações de URL. **Topics** + [Configurando parâmetros no Amazon Quick](parameters-set-up.md) + [Usando um controle com um parâmetro no Amazon Quick](parameters-controls.md) + [Criação de parâmetros padrões no Amazon Quick](parameters-default-values.md) + [Conexão com parâmetros no Amazon Quick](parameters-connections.md) # Configurando parâmetros no Amazon Quick Use o procedimento a seguir para criar ou editar um parâmetro básico. **Criar ou editar um parâmetro básico** 1. Escolha uma análise com a qual deseja trabalhar e decida qual campo deseja parametrizar. 1. Escolha o ícone **Parâmetros** na lista de ícones na parte superior da página. 1. Adicione um novo parâmetro ao escolher o sinal de adição (**\$1 Adicionar**) próximo à parte superior do painel. Edite um parâmetro existente selecionando primeiramente o ícone em forma de `v` próximo ao nome do parâmetro e, em seguida, selecionando **Edit parameter (Editar parâmetro)**. 1. Em **Nome**, insira um valor alfanumérico para o parâmetro. 1. Em **Tipo de dados**, escolha **String**, **Número**, **Inteiro** ou **Datetime** e, em seguida, conclua as etapas a seguir. + Se você escolher **String**, **Número** ou **Inteiro**, faça o seguinte: 1. Em **Valores**, escolha **Valor único** ou **Vários valores**. Escolha a opção de valor único para parâmetros que podem conter somente um valor. Escolha vários valores para parâmetros que podem conter um ou mais valores. Parâmetros com vários valores não podem ser de um tipo de dados `datetime`. Eles também não oferecem suporte a valores padrão dinâmicos. Para alternar um parâmetro entre valor único e vários valores, exclua e recrie o parâmetro. 1. (Opcional) Para **Valor padrão estático** ou **Múltiplos valores padrão estáticos**, insira um ou mais valores. Esse tipo de valor estático será usado durante o carregamento de uma página pela primeira vez, se um valor padrão dinâmico ou um parâmetro de URL não for fornecido. 1. (Opcional) Escolha **Mostrar como em branco por padrão**. Selecione esta opção para mostrar o valor padrão para listas de vários valores como em branco. Esta opção se aplica somente a parâmetros com vários valores. + Se você escolher **Datetime**, faça o seguinte: 1. Em **Granularidade de tempo**, escolha **Dia**, **Hora**, **Minuto** ou **Segundo**. 1. Em **Data padrão**, selecione **Data fixa** ou **Data relativa** e, em seguida, faça o seguinte: + Se você selecionar **Data fixa**, insira uma data e uma hora usando o seletor de data e de hora. + Se você selecionar **Data relativa**, escolha uma data de realização. É possível escolher **Hoje**, **Ontem** ou especificar a **Condição de filtro** (início de ou fim de), o **Intervalo** (este, anterior ou próximo) e o **Período** (ano, trimestre, mês, semana ou dia). 1. (Opcional) Escolha **Definir um padrão dinâmico** para criar um padrão que é específico para o usuário. Um *padrão dinâmico* é um valor padrão por usuário para a primeira vez que a página é carregada no painel. Use um padrão dinâmico para criar uma visualização personalizada para cada usuário. Campos calculados não podem ser usados como padrões dinâmicos. Padrões dinâmicos não impedem que um usuário selecione um valor diferente. Se desejar proteger os dados, você poderá adicionar um bloqueio no nível da linha. Para obter mais informações, consulte [Uso da segurança por linha com regras baseadas em usuários para restringir o acesso a um conjunto de dadosComo usar regras baseadas em usuários](restrict-access-to-a-data-set-using-row-level-security.md). Essa opção só será exibida se você escolher um parâmetro de valor único. Parâmetros com vários valores não podem ter valores padrão dinâmicos. **nota** Se você escolher um parâmetro com vários valores, a tela mudará para remover as opções padrão. Em vez disso, você verá uma caixa com o texto **Enter values you want to use for this control (Insira os valores que deseja usar para este controle)**. Você pode inserir vários valores nesta caixa, cada um em uma única linha. Esses valores são usados como os valores padrão selecionados no controle do parâmetro. Esses valores são unidos com aqueles que você inserir para o controle do parâmetro. Consulte [Controles de parâmetros](parameters-controls.md) para obter mais informações sobre esse tema. 1. (Opcional) Defina um valor reservado para determinar o valor do valor **Selecionar tudo**. O *valor reservado* de um parâmetro é o valor atribuído a um parâmetro quando você escolhe **Selecionar tudo** como seu valor. Quando você configura um valor reservado específico para o parâmetro, esse valor não é mais considerado um valor de parâmetro válido em seu conjunto de dados. O valor reservado não pode ser usado em *consumidores de parâmetros*, como filtros, controles, campos calculados e ações personalizadas. Além disso, ele não aparece na lista de controle de parâmetros. É possível escolher entre **Valor recomendado**, **Nulo** e **Valor personalizado**. O **Valor recomendado** é o padrão. Se você escolher **Valor recomendado**, o valor reservado será definido com os seguintes valores com base no tipo de valor: + Strings: `"ALL_VALUES"` + Números: `"Long.MIN_VALUE"-9,223,372,036,854,775,808` + Inteiros: `Int.MIN_VALUE"-2147483648` Para definir um valor reservado em seu novo parâmetro, escolha a lista suspensa **Configurações avançadas** na página **Criar um novo parâmetro** ou na página **Editar parâmetro** e selecione o valor desejado. 1. Escolha **Create (Criar)** ou **Update (Atualizar)** para concluir a criação ou atualização do parâmetro. Depois de criar um parâmetro, é possível usá-lo de várias maneiras. Você pode criar um controle (como um botão), para que possa escolher um valor para o parâmetro. Para obter mais informações, consulte as seções a seguir. # Usando um controle com um parâmetro no Amazon Quick 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 análise URLs URLs, 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 (\$1) 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 [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 (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). 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. 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. # Criação de parâmetros padrões no Amazon Quick Use esta seção para saber mais sobre os tipos de padrões do parâmetro disponíveis e como configurar cada um deles. Cada campo pode ter um parâmetro e um controle associados a ele. Quando alguém visualiza um painel ou um relatório por e-mail, qualquer controle de planilha que tenha um valor padrão estático configurado usa o padrão estático. O valor padrão pode alterar a forma como os dados são filtrados, a maneira como as ações personalizadas se comportam e quais textos são exibidos no título de uma planilha dinâmica. Os relatórios de e-mail também oferecem suporte a padrões dinâmicos. O padrão mais simples é um padrão estático (imutável), que mostra o mesmo valor para todos os usuários. Como criador do painel, você escolhe o valor padrão. Esse valor não poderá ser alterado pelas pessoas que usam o painel. No entanto, as pessoas podem escolher quaisquer valores nos controles. Definir um padrão não alterará isso. Para restringir os valores que uma pessoa pode selecionar, considere usar a segurança por linha. Para obter mais informações, consulte [Uso da segurança por linha com regras baseadas em usuários para restringir o acesso a um conjunto de dadosComo usar regras baseadas em usuários](restrict-access-to-a-data-set-using-row-level-security.md). **Criar ou editar um valor padrão estático que se aplique à visualização do painel de todos os usuários** 1. Escolha o menu de contexto (`v`) pelo parâmetro que você deseja editar ou crie um novo parâmetro ao seguir as etapas em [Configurando parâmetros no Amazon Quick](parameters-set-up.md). 1. Insira um valor em **Valor padrão estático** para definir um padrão estático. Para exibir um padrão diferente com base em quem está visualizando o painel, crie um parâmetro padrão dinâmico (DDP, na sigla em inglês). O uso de padrões dinâmicos envolve determinada preparação para mapear as pessoas aos padrões atribuídos a elas. Primeiro, você precisa criar uma consulta ao banco de dados ou um arquivo de dados que contenha informações sobre as pessoas, os campos e os valores padrão a serem exibidos. Você adiciona isso a um conjunto de dados e, em seguida, adiciona o conjunto de dados à sua análise. A seguir, você encontrará procedimentos que podem ser usados ​​para coletar informações, criar o conjunto de dados e adicionar o padrão dinâmico ao parâmetro. Use as seguintes diretrizes ao criar um conjunto de dados para valores padrão dinâmicos: + Recomendamos usar um único conjunto de dados que contenha todas as definições padrão dinâmicas para um agrupamento lógico de usuários ou de grupos. Se possível, mantenha as definições em uma única tabela ou em um único arquivo. + Também recomendamos que os campos no seu conjunto de dados tenham nomes que se assemelhem aos nomes dos campos na análise. Não são todos os campos do conjunto de dados que precisam fazer parte da análise, por exemplo, se você estiver usando o mesmo conjunto de dados para os padrões em vários painéis. Os campos podem estar em qualquer ordem. + Não recomendamos combinar nomes de usuários e de grupos na mesma coluna ou no mesmo conjunto de dados. Esse tipo de configuração é mais trabalhoso para manter e para solucionar problemas. + Se você usar um arquivo delimitado por vírgula para criar o conjunto de dados, certifique-se de remover qualquer espaço entre os valores no arquivo. O exemplo apresentado a seguir mostra o formato correto para valores separados por vírgulas (CSV, na sigla em inglês). Delimite textos (strings) que incluam caracteres não alfanuméricos, como espaços, apóstrofos e assim por diante, entre aspas simples ou duplas. É possível delimitar campos que sejam datas ou horas entre aspas, mas isso não é obrigatório. Você pode delimitar campos numéricos entre aspas, por exemplo, se os números contiverem caracteres especiais, conforme mostrado a seguir. ``` "Value includes spaces","Field contains ' other characters",12345.6789,"20200808" ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08 ``` + Depois de criar o conjunto de dados, verifique novamente os tipos de dados que o Quick seleciona para os campos. Antes de começar, você precisa de uma lista de nomes de usuários ou de grupos para as pessoas que terão padrões dinâmicos. Para gerar uma lista de usuários ou de grupos, é possível usar a AWS CLI para obter as informações. Para executar comandos da CLI, certifique-se de ter a AWS CLI instalada e configurada. Para obter mais informações, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) no *Guia do usuário da AWS CLI *. Este é apenas um exemplo de como obter uma lista de nomes de usuários ou de grupos. Use o método que funcionar melhor para você. **Identificar pessoas para um parâmetro padrão dinâmico (DDP)** + Liste nomes de usuários individuais ou nomes de grupos: + Para listar nomes de usuários individuais, inclua uma coluna que identifique as pessoas para seu DDP. Essa coluna deve conter o nome de usuário do sistema de cada pessoa que ela usa para se conectar do seu provedor de identidade ao Quick. Geralmente, esse nome do usuário é semelhante ao alias antes do símbolo de @ do e-mail de uma pessoa, mas isso não é regra. Para obter uma lista de usuários, use a operação ou o AWS CLI comando [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html)Quick API. O comando da CLI é mostrado no exemplo a seguir. Especifique a Região da AWS para seu provedor de identidades, por exemplo, `us-east-1`. ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region ``` O exemplo a seguir altera o comando anterior ao adicionar uma consulta que limita os resultados aos usuários ativos. ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]' ``` O conjunto de resultados deve ser semelhante ao exemplo a seguir. Este exemplo é um trecho da saída em JSON (`--output json`). Pessoas que têm nomes de usuário federados têm princípios IDs que começam com a palavra`federated`. ``` [ { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva", "UserName": "anacarolinasilva", "Email": "anacasilva@example.com", "Role": "ADMIN", "Active": true, "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate", "UserName": "Reader/liujie-stargate", "Role": "READER", "Active": true, "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal", "UserName": "embedding/cxoportal", "Email": "saanvisarkar@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com", "UserName": "zhangwei@example.com", "Email": "zhangwei@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "user/d-96123-example-id-1123" } ] ``` + Para listar nomes de grupos, inclua uma coluna que identifique os grupos que contêm os nomes de usuários para seu DDP. Essa coluna deve conter os nomes dos grupos do sistema usados para se conectar do seu provedor de identidade ao Quick. Para identificar grupos que você pode adicionar ao conjunto de dados, use uma ou mais das seguintes operações rápidas de API ou comandos da CLI: + [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html)— Lista grupos rápidos por Conta da AWS ID e namespace para aqueles Região da AWS que contêm seu provedor de identidade. + [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html)— Lista os usuários no grupo rápido especificado. + [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html)— Lista os grupos rápidos dos quais um usuário do Quick é membro. Como alternativa, é possível pedir ao administrador da rede que consulte o provedor de identidades para obter essas informações. Os próximos dois procedimentos fornecem instruções sobre como concluir a criação de um conjunto de dados para valores padrão dinâmicos. O primeiro procedimento é a criação de um conjunto de dados para um DDP de valor único. O segundo procedimento é a criação de um conjunto de dados para um DDP de vários valores. **Criar um conjunto de dados para um DDP de valor único** 1. Crie colunas de conjunto de dados com parâmetros de valor único. A primeira coluna na consulta ou no arquivo deve ser para as pessoas que usam o painel. Este campo pode conter nomes de usuários ou nomes de grupos. No entanto, o suporte para grupos só está disponível na edição Quick Enterprise. 1. Em cada campo que exibe um padrão dinâmico para um parâmetro de valor único, adicione uma coluna ao conjunto de dados. O nome da coluna não importa, portanto, você pode usar o mesmo nome do campo ou do parâmetro. Os parâmetros de valor único funcionarão, conforme especificado, somente se a combinação entre a entidade utilizadora e o padrão dinâmico for exclusiva para o campo desse parâmetro. Se houver vários valores em um campo padrão para uma entidade utilizadora, o controle de valor único desse campo exibirá o padrão estático em vez disso. Se nenhum padrão estático for definido, o controle não exibirá um valor padrão. Tenha cuidado ao usar nomes de grupos, pois alguns nomes de usuários podem ser membros de diversos grupos. Se esses grupos tiverem valores padrão diferentes, esse tipo de nome do usuário funcionará como uma entrada duplicada. O exemplo apresentado a seguir mostra uma tabela que parece conter dois parâmetros de valor único. Fazemos essa suposição porque nenhum nome do usuário está associado a vários valores padrão. Para facilitar a compreensão desta tabela, adicionamos a palavra `'default'` antes dos nomes dos campos da análise. Dessa maneira, é possível realizar a leitura da tabela fazendo a seguinte afirmação ao alterar os valores de cada linha: quando visualizados por `anacarolinasilva`, os controles apresentam uma região padrão `NorthEast` e um segmento padrão `SMB`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/parameters-default-values.html) 1. Importe esses dados para o Quick e salve-os como um novo conjunto de dados. 1. Na sua análise, adicione o conjunto de dados que você criou. A análise precisa usar, no mínimo, outro conjunto de dados que corresponda às colunas definidas para os padrões. Para obter mais informações, consulte [Como adicionar um conjunto de dados a uma análise](adding-a-data-set-to-an-analysis.md). **Criar um conjunto de dados para um DDP de vários valores** 1. Crie colunas de conjunto de dados com parâmetros de vários valores. A primeira coluna na consulta ou no arquivo deve ser para as pessoas que usam o painel. Este campo pode conter nomes de usuários ou nomes de grupos. No entanto, o suporte para grupos só está disponível na edição Quick Enterprise. 1. Em cada campo que exibe um padrão dinâmico para um parâmetro de vários valores, adicione uma coluna ao conjunto de dados. O nome da coluna não importa, portanto, você pode usar o mesmo nome do campo ou do parâmetro. Ao contrário dos parâmetros de valor único, os parâmetros de vários valores permitem vários valores no campo associado ao parâmetro. O exemplo apresentado a seguir mostra uma tabela que parece conter um parâmetro de valor único e um parâmetro de vários valores. Podemos fazer essa suposição porque cada nome do usuário tem um valor exclusivo em uma coluna e alguns nomes de usuários têm vários valores na outra coluna. Para facilitar a compreensão desta tabela, adicionamos a palavra `'default'` antes dos nomes dos campos da análise. Dessa maneira, é possível realizar a leitura da tabela fazendo a seguinte afirmação ao alterar os valores de cada linha: quando `viewed-by` for `liujie`, os controles apresentam um valor de `default-region` como `SouthEast` e um valor de `default-city` como `Atlanta`. Se lermos mais uma linha, veremos que `liujie` também tem `Raleigh` como `default-city`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/parameters-default-values.html) Neste exemplo, o parâmetro ao qual aplicamos `default-region` funciona corretamente, seja ele um parâmetro de valor único ou de vários valores. Se for um parâmetro de valor único, duas entradas funcionarão para um usuário porque ambas as entradas têm o mesmo valor, `SouthEast`. Se for um parâmetro de vários valores, ele ainda funcionará, exceto que somente um valor será selecionado por padrão. No entanto, se alterarmos o parâmetro que usa `default-city` como padrão de um parâmetro de vários valores para um parâmetro de valor único, não veremos esses padrões selecionados. Em vez disso, o parâmetro usará o padrão estático, se ele estiver definido. Por exemplo, se o padrão estático estiver definido como `Atlanta`, `liujie` terá `Atlanta` selecionada nesse controle, mas não `Raleigh`. Em alguns casos, seu valor padrão estático também pode ser usado como um padrão dinâmico. Nesse caso, certifique-se de testar o controle para um nome do usuário que não usa um valor padrão e que pode ser ambos. Se um nome do usuário pertencer a vários grupos, o usuário nomeado visualizará um conjunto de valores padrão que corresponde a uma união dos valores padrão dos dois grupos. 1. Importe esses dados para o Quick e salve-os como um novo conjunto de dados. 1. Na sua análise, adicione o conjunto de dados que você criou. A análise precisa usar, no mínimo, outro conjunto de dados que corresponda às colunas definidas para os padrões. Para obter mais informações, consulte [Como adicionar um conjunto de dados a uma análise](adding-a-data-set-to-an-analysis.md). Use o procedimento apresentado a seguir para adicionar um parâmetro padrão dinâmico à sua análise. Antes de começar, certifique-se de ter um conjunto de dados que contenha os padrões dinâmicos para cada nome do usuário ou nome de grupo. Certifique-se também de que sua análise esteja usando este conjunto de dados. Para obter ajuda com relação a esses requisitos, consulte os procedimentos anteriores. **Adicionar um DDP à sua análise** 1. No console rápido, escolha o ícone **Parâmetros** na parte superior da página e escolha um parâmetro existente. Escolha **Editar parâmetro** no menu do parâmetro. Para adicionar um novo parâmetro, escolha o sinal de mais (`+`) próximo a **Parâmetros**. 1. Escolha **Set a dynamic default (Definir padrão dinâmico)**. 1. Configure as seguintes opções com suas configurações: + **Conjunto de dados com valores padrão e informações do usuário**: escolha o conjunto de dados que você criou e adicionou à sua análise. + **Coluna de nome do usuário**: para criar padrões baseados em nomes de usuários, escolha a coluna no conjunto de dados que contém os nomes de usuários. + **Coluna de nome de grupo**: para criar padrões baseados em nomes de grupos, escolha a coluna no conjunto de dados que contém os nomes de grupos. + **Coluna de valor padrão**: escolha a coluna que contém valores padrão para este parâmetro. 1. Escolha **Aplicar** para salvar as alterações de configurações e, em seguida, selecione **Atualizar** para salvar as alterações de parâmetros. Para sair sem salvar as alterações, escolha **Cancelar** em vez disso. 1. Adicione um filtro para cada campo que contém padrões dinâmicos para que os padrões funcionem. Para saber mais sobre como usar filtros com parâmetros, consulte [Usando filtros com parâmetros no Amazon Quick](parameters-filtering-by.md). O Amazon Quick usa o valor padrão estático para qualquer pessoa cujo nome de usuário não exista no conjunto de dados, não tenha um padrão atribuído ou não tenha um padrão exclusivo. Cada pessoa pode ter somente um conjunto de padrões. Se você não desejar usar padrões dinâmicos, poderá definir um padrão estático em vez disso. # Conexão com parâmetros no Amazon Quick Depois configurar um parâmetro, use esta seção para conectá-lo e fazê-lo funcionar. Depois de criar um parâmetro, você pode criar os consumidores dos parâmetros. *Consumidores dos parâmetros* são componentes que consomem o valor de um parâmetro, como filtros, controles, campos calculados ou ações personalizadas. Você pode navegar até cada uma dessas opções de uma outra forma, como mostramos a seguir: + Para criar um filtro, escolha o ícone **Filtro** na parte superior da página. Crie um **Custom Filter (Filtro personalizado)** e habilite **Use parameters (Usar parâmetros)**. A lista mostra apenas os parâmetros qualificados. + Para adicionar um novo controle para o parâmetro, escolha o ícone **Parâmetros** na parte superior da página. Escolha o parâmetro e, em seguida, escolha **Add control (Adicionar controle)**. + Para usar um parâmetro em um campo calculado, edite um campo calculado existente ou adicione um novo escolhendo **Add (Adicionar)** na parte superior esquerda. A lista de parâmetros é exibida abaixo da lista de campos. **nota** Não é possível usar parâmetros de vários valores com campos calculados. + Para criar uma ação de URL, selecione o menu em forma de **v** e, em seguida, selecione ** URL Actions (Ações de URL)**. Para obter mais informações sobre cada um desses tópicos, consulte as seguintes seções. **Topics** + [Como usar filtros com parâmetros](parameters-filtering-by.md) + [Como usar campos calculados com parâmetros](parameters-calculated-fields.md) + [Como usar ações personalizadas com parâmetros](parameters-custom-actions.md) + [Parâmetros em URLs](parameters-in-a-url.md) + [Parâmetros em títulos e em descrições](parameters-in-titles.md) # Usando filtros com parâmetros no Amazon Quick Use esta seção para filtrar os dados de uma análise ou painel por um parâmetro de valor único. Para usar um parâmetro de vários valores, ou seja, um parâmetro com um controle suspenso de seleção múltipla, crie um filtro personalizado que seja igual (ou que não seja igual) aos valores. Antes de usar um filtro com um parâmetro, você já deve saber como trabalhar com filtros. 1. Verifique se sua análise tem um parâmetro já criado. Escolha **Editar** no menu de parâmetros ou de controles para descobrir quais configurações estão em uso. 1. Escolha o painel **Filter (Filtro)** à esquerda da tela. Se já houver um filtro para o campo que você deseja usar, escolha-o para abrir suas configurações. Caso contrário, crie um filtro para o campo que você deseja filtrar por parâmetro. 1. Escolha **Use Parameters (Usar parâmetros)**. 1. Escolha os parâmetros nas listas abaixo de **Use Parameters (Parâmetros de uso)**. Para campos de texto (string), primeiro escolha **Custom Filter (Filtro personalizado)** e, em seguida, habilite **Use Parameters (Parâmetros de uso)**. Para campos de data, escolha os parâmetros **Start date (Data de início)** e a **End date (Data de término)**, como exibido na captura de tela a seguir. Para campos com outros tipos de dados, escolha **Select a parameter (Selecione um parâmetro)** e, em seguida, escolha o parâmetro na lista. **nota** Os parâmetros que podem conter vários valores devem usar igual ou diferente como o tipo de comparação. 1. Selecione **Apply (Aplicar)** para salvar as alterações. Teste seu novo filtro escolhendo o controle perto da parte superior da análise. Neste exemplo, usamos um parâmetro básico que não tem padrões e um controle dinâmico vinculado ao campo **Região** no conjunto de dados de amostra denominado **Funil de vendas**. O controle consulta os dados, apresentando todos os valores. Se você excluir ou recriar um parâmetro que esteja usando em um filtro, pode atualizar o filtro com o novo parâmetro. Para fazer isso, abra o filtro, escolha o novo parâmetro que você deseja usar e, em seguida, escolha **Apply (Aplicar)**. Se você renomear um parâmetro, não precisará atualizar o filtro nem nenhum outro consumidor. # Usando campos calculados com parâmetros no Amazon Quick Você pode passar o valor de um parâmetro a um campo calculado em uma análise. Ao criar um cálculo, você pode escolher os parâmetros existentes na lista de parâmetros em **Parameter list (Lista de parâmetros)**. Não é possível criar um campo calculado que contenha um parâmetro de vários valores, ou seja, aqueles parâmetros com um controle suspenso de seleção múltipla. Para a fórmula, você pode usar qualquer uma das funções disponíveis. Você pode transferir a seleção do visualizador do controle de parâmetros para a função `ifElse`. Em troca, você obtém uma métrica. Por exemplo: ``` ifelse( ${KPIMetric} = 'Sales',sum({Weighted Revenue}), ${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}), ${KPIMetric} = '# Active', distinct_count(ActiveItem), NULL ) ``` O exemplo anterior cria uma métrica (um decimal) que você pode usar em uma fonte de campos. Depois, quando um usuário escolher um valor do controle de parâmetro, o visual será atualizado para refletir a seleção. # Usando ações personalizadas com parâmetros no Amazon Quick Uma *ação personalizada* permite que você inicie URLs ou filtre imagens selecionando um ponto de dados em uma imagem ou escolhendo o nome da ação no menu de contexto. Ao usar uma ação de URL com um parâmetro, você pode passar ou enviar parâmetros de maneira dinâmica para o URL. Para que isso funcione, configure um parâmetro e utilize-o no URL ao criar uma ação personalizada com um tipo de ação da **URL action (Ação de URL)**. Os parâmetros sobre o final do envio e do recebimento devem corresponder em nome e tipo de dados. Todos os parâmetros são compatíveis com ações de URL. Para obter detalhes sobre a criação de uma ação de URL, consulte [Criação e edição de ações personalizadas no Amazon Quick Sight](custom-actions.md). Se você deseja apenas usar um parâmetro em um link, sem criar uma ação de URL, consulte [Como usar parâmetros em um URL](parameters-in-a-url.md). # Como usar parâmetros em um URL Você pode usar um nome e valor de parâmetro em uma URL no Amazon Quick para definir um valor padrão para esse parâmetro em um painel ou análise. O exemplo a seguir mostra a URL de um painel que define um parâmetro para outro painel. ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345 ``` No exemplo anterior, a primeira parte é o link para o painel de destino: `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`. O sinal de hash (`#)` segue a primeira parte para inserir os *fragmentos*, que contêm os valores que você deseja definir. Os valores nos fragmentos não são recebidos nem registrados pelos AWS servidores. Essa funcionalidade mantém os valores de seus dados mais seguros. O fragmento depois de `#` segue estas regras: + Os parâmetros são prefixados com `p.`. O nome é o nome do parâmetro, e não o nome do controle. Você pode visualizar o nome do parâmetro abrindo a análise e selecionando **Parameter (Parâmetro)** na barra lateral esquerda. + O valor é definido usando o sinal de igual (`=`). As seguintes regras se aplicam: + Os valores literais não usam aspas. + Os espaços dentro de valores são codificados automaticamente pelo navegador, de modo que você não precisa usar caracteres de escape quando cria uma URL manualmente. + Para retornar todos os valores, defina o parâmetro igual a `"[ALL]"`. + Para atribuir o valor do parâmetro a `null`, defina-o igual a `%00`. Por exemplo, .`p.population=%00` + Em ações personalizadas, os nomes de parâmetros de destino começam com `$`, por exemplo: `<<$passThroughParameter>>` + Em ações personalizadas, os valores de parâmetros são exibidos entre parênteses angulares `<< >>`, por exemplo, `<>`. O usuário do painel vê o valor de pesquisa, e não a variável. + Para uma ação de URL personalizada, os parâmetros de vários valores precisam apenas de uma instância do mesmo parâmetro no fragmento, por exemplo: `p.city=<<$city>>` + Para uma URL direta, vários valores de um único parâmetro têm duas instâncias do mesmo parâmetro no fragmento. Por exemplo, veja o seguinte. + O sinal de e comercial (`&`) separa vários parâmetros. Por exemplo, veja o seguinte. O servidor converte a data em UTC e a envia para o back-end como uma string sem um fuso horário. Para usar datas em Tempo Universal Coordenado (UTC), exclua o fuso horário. Veja a seguir alguns exemplos de formatos de data que funcionam: + `2017-05-29T00%3A00%3A00` + `2018-04-04 14:51 -08:00` + `Wed Apr 04 2018 22:51 GMT+0000` ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3 ``` No navegador, esse código torna-se o seguinte: ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3 ``` O exemplo anterior define quatro parâmetros: + `shipDate` é um parâmetro de data: `Sept 30, 2018`. + `city` é um parâmetro de string de vários valores: `New York` e `Seattle` + `teamMember` é um parâmetro de inteiro: `12`. + `percentageRank` é um parâmetro de decimal: `2.3` O exemplo a seguir mostra como definir os valores de um parâmetro que aceita vários valores. ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA ``` Para passar valores de um painel (ou análise) para um outro painel com base na seleção de ponto de dados do usuário, use ações de URL personalizadas. Se preferir, você também pode gerá-los URLs manualmente e usá-los para compartilhar uma visão específica dos dados. Para obter informações sobre a criação de ações personalizadas, consulte [Como usar ações personalizadas para filtros e navegação](quicksight-actions.md). # Usando parâmetros em títulos e descrições no Amazon Quick Ao criar parâmetros no Amazon Quick, você pode usá-los em títulos e descrições em todos os seus gráficos e análises para exibir dinamicamente os valores dos parâmetros. Você pode usar parâmetros nas seguintes áreas da sua análise: + Títulos e subtítulos de gráficos + Títulos de eixos + Títulos de legendas + Títulos de controle de parâmetros + Títulos de planilhas e descrições A imagem apresentada a seguir mostra um título de gráfico que usa um parâmetro. ![\[Imagem do painel Formatar elemento visual com um parâmetro no título de gráfico e um gráfico com o valor de parâmetro no título demarcado em vermelho.\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/parameters-in-titles-labels2.png) Use os procedimentos a seguir para aprender como adicionar parâmetros às áreas em toda a sua análise. Para obter mais informações sobre os parâmetros e como criá-los, consulte [Parâmetros](parameters-in-quicksight.md). ## Como adicionar parâmetros aos títulos e aos subtítulos de gráficos Use o procedimento a seguir para aprender como adicionar parâmetros aos títulos e aos subtítulos de gráficos. **Adicionar um parâmetro ao título ou ao subtítulo de um gráfico** 1. Abra o painel **Propriedades** do elemento visual que você deseja formatar. 1. No painel **Propriedades**, selecione a guia **Título**. 1. Selecione **Mostrar título** ou **Mostrar subtítulo**. Essas opções podem já estar selecionadas. 1. Escolha os três pontos à direita de **Editar título** ou de **Editar subtítulo** e, em seguida, escolha um parâmetro na lista. O parâmetro será adicionado ao título no painel **Propriedades**. No gráfico, o valor de parâmetro será exibido no título. Para obter mais informações sobre a edição de títulos e de subtítulos em elementos visuais, consulte [Títulos e legendas sobre tipos visuais no Quick](customizing-a-visual-title.md). ## Como adicionar parâmetros aos títulos de eixos Use o procedimento a seguir para aprender como adicionar parâmetros aos títulos de eixos. **Adicionar um parâmetro a um título de eixo** 1. Abra o painel **Propriedades** do elemento visual que você deseja formatar. 1. No painel **Propriedades**, escolha o eixo que você deseja formatar. 1. Selecione **Mostrar título**. 1. Escolha os três pontos à direita do título do eixo padrão e, em seguida, escolha um parâmetro na lista. O parâmetro será adicionado ao título do eixo no painel **Propriedades**. No gráfico, o valor de parâmetro será exibido no título do eixo. Para obter mais informações sobre a edição de títulos de eixos, consulte [Eixos e linhas de grade](showing-hiding-axis-grid-tick.md). ## Como adicionar parâmetros aos títulos de legendas Use o procedimento a seguir para aprender como adicionar parâmetros aos títulos de legendas. **Adicionar um parâmetro a um título de legenda** 1. Abra o painel **Propriedades** do elemento visual que você deseja formatar. 1. No painel **Propriedades**, escolha **Legenda**. 1. Selecione **Mostrar título da legenda**. 1. Escolha os três pontos à direita de **Título da legenda** e, em seguida, escolha um parâmetro na lista. O parâmetro será adicionado ao título da legenda no painel **Propriedades**. No gráfico, o valor de parâmetro será exibido no título da legenda. Para obter mais informações sobre a formatação de legendas, consulte [Legendas sobre tipos visuais no Quick](customizing-visual-legend.md). ## Como adicionar parâmetros para títulos de controles Use o procedimento a seguir para aprender como adicionar parâmetros aos títulos de controles de parâmetros. **Adicionar um parâmetro a um título de controle de parâmetros** 1. Selecione o controle de parâmetros que deseja editar, escolha os três pontos à direita do título do controle de parâmetros e, em seguida, clique em **Editar**. 1. Na página **Editar controle** que é aberta, selecione **Mostrar título**. 1. Escolha os três pontos à direita de **Nome de exibição** e, em seguida, escolha um parâmetro na lista. O parâmetro será adicionado ao título do controle de parâmetros. Para obter mais informações sobre como usar controles de parâmetros, consulte [Controles de parâmetros](parameters-controls.md). ## Como adicionar parâmetros aos títulos de planilhas e às descrições Use o procedimento a seguir para aprender como adicionar parâmetros aos títulos de planilhas e às descrições em sua análise. **Adicionar um parâmetro à descrição ou ao título de uma planilha** 1. Na página de análise, escolha **Planilhas** na barra de aplicativos e, em seguida, selecione **Adicionar título** ou **Adicionar descrição**. Um título da planilha ou uma descrição aparecerá na planilha. 1. Em **Título da planilha** ou em **Descrição**, escolha os três pontos à direita e, em seguida, selecione um parâmetro na lista. O parâmetro é adicionado ao título da planilha ou à descrição e o valor de parâmetro aparece no texto quando você fecha a caixa de texto. Para obter mais informações sobre como adicionar títulos de planilhas e descrições, consulte [Como adicionar um título e uma descrição para uma análise](adding-a-title-and-description.md). # Como usar ações personalizadas para filtros e navegação Para adicionar opções interativas para assinantes do painel (leitores rápidos), você cria ações personalizadas em um ou mais elementos visuais em sua análise. Aprimorar os painéis com ações personalizadas ajuda as pessoas a explorar os dados ao adicionar mais contexto ao conjunto de dados. Isso pode facilitar o detalhamento dos detalhes e a localização de novos insights no mesmo painel, em um painel diferente ou em uma aplicação distinta. É possível adicionar até dez ações personalizadas a cada elemento visual em um painel. Antes de começar, é útil fazer um planejamento. Por exemplo, identifique campos que sejam bons candidatos para a filtragem, para a abertura de uma planilha diferente, para a abertura de um URL ou para o envio de e-mails. Para cada planilha, identifique os widgets que exibem esses campos. Em seguida, decida quais widgets conterão as ações. Além disso, é uma boa ideia criar um esquema de nomenclatura para que os nomes das ações sejam consistentes em toda a análise. Nomes consistentes tornam mais fácil para as pessoas que usam sua análise descobrirem o que a ação fará, além disso, eles facilitam a manutenção de ações que você pode estar duplicando ao longo da análise. As ações existem somente no widget do painel em que você as cria e funcionam somente no contexto da planilha primária e dos campos secundários exibidos por esse widget. Você pode criar ações somente em tipos específicos de widget: elementos visuais e insights. Não é possível adicioná-las a outros widgets, por exemplo, filtros ou controles de lista. As ações personalizadas podem ser ativadas somente usando o widget no qual você as criou. Para ativar uma ação, a pessoa que utiliza a análise pode clicar com o botão esquerdo do mouse (selecionar) ou com o botão direito do mouse (usar o menu de contexto) em um ponto de dados. Um *ponto de dados* corresponde a um item no conjunto de dados, por exemplo, um ponto em um gráfico de linhas, uma célula em uma tabela dinâmica, uma fatia em um gráfico de pizza e assim por diante. Se a pessoa clicar em um elemento visual, a ação de *seleção* será ativada. No momento, esta é a ação que é membro da categoria **Ao selecionar** das **Ações** em uma análise. Se, em vez disso, a pessoa clicar com o botão direito do mouse em um elemento visual, ela poderá escolher em uma lista de ações de *menu*. No momento, qualquer ação listada é membro da categoria **Opções de menu** das **Ações** em uma análise. A categoria **Ao selecionar** pode conter uma e somente uma ação de membro. Por padrão, a primeira ação criada se torna a ação de seleção, ou seja, aquela ação que é ativada ao clicar com o botão esquerdo do mouse. Para remover uma ação da categoria **Ao selecionar**, altere a configuração **Ativação** da ação para **Opções de menu**. Após salvar essa alteração, você poderá definir a configuração **Ativação** de uma ação diferente como **Selecionar**. É possível escolher entre três **Tipos de ação** ao configurar uma ação: + **Ação de filtragem**: filtre os dados inclusos em um elemento visual ou em uma planilha inteira. Por padrão, as filtragens estão disponíveis para todos os campos do elemento visual primário. As filtragens em cascata estão habilitadas por padrão. As ações de filtro funcionam em vários conjuntos de dados usando mapeamentos de campo gerados automaticamente. Se a análise usar mais de um conjunto de dados, você poderá exibir os mapeamentos de campo gerados automaticamente para campos que existem em vários conjuntos de dados. Para fazer isso, escolha ****Exibir mapeamento de campo**** no final das configurações de ação, enquanto edita uma ação. Se você estiver visualizando uma lista de ações, escolha ****Exibir mapeamento de campo**** no menu de cada ação. Os mapeamentos de campo aparecem em uma nova tela que mostra o mapeamento entre o conjunto de dados inicial e todos os outros conjuntos de dados no visual. Se nenhum campo for mapeado automaticamente, uma mensagem será exibida com um link para [Campos de mapeamento e junção](mapping-and-joining-fields.md). + **Ações de navegação**: habilite a navegação entre diferentes planilhas na mesma análise. + **Ações de URL**: abra um link para outra página da Web. Se desejar abrir um painel diferente, use uma ação de URL. Você pode usar uma ação de URL para enviar pontos de dados e parâmetros para outros URLs. É possível incluir qualquer campo ou parâmetro disponível. Se o URL usar o esquema `mailto`, a execução da ação abrirá seu editor de e-mails padrão. **Topics** + [Como adicionar filtros interativos com um clique](quick-actions.md) + [Criação e edição de ações personalizadas no Amazon Quick Sight](custom-actions.md) + [Como reparar ações personalizadas](repairing-custom-actions.md) + [Entendendo o mapeamento de campo para ações personalizadas no Amazon Quick Sight](quicksight-actions-field-mapping.md) # Como adicionar filtros interativos com um clique A *filtragem interativa com um clique fornece uma point-and-click filtragem* que varia do visual clicável para todos os outros recursos visuais e insights em uma pasta. Adicione isso à análise para começar a realizar resumos e detalhar as métricas na mesma planilha do painel. Depois de configurar isso, ao clicar em um ponto de dados (por exemplo, um ponto em um gráfico de linhas), você filtra instantaneamente usando todos os campos mapeados em todos os outros elementos visuais dessa planilha. Se você tiver vários conjuntos de dados, todos os campos de destino devem ser mapeados para que isso funcione. Além disso, você pode ter apenas uma ação que funcione clicando em um ponto de dados; todas as demais ações devem funcionar no menu de contexto. Use o procedimento a seguir para criar um filtro de um clique em uma análise. **Criar uma filtragem com um clique em um elemento visual ou em um insight** 1. Na análise, escolha um elemento visual ou um insight ao qual você deseja adicionar filtragem interativa. 1. Escolha **Ações** no menu Opções de menu suspenso localizado no canto superior direito. 1. Escolha **Filtrar elementos visuais da mesma planilha**. Ao fazer isso, a filtragem com um clique será adicionada imediatamente. 1. Repita esse processo para cada elemento visual que você deseja tornar interativo. # Criação e edição de ações personalizadas no Amazon Quick Sight Você cria uma ação para cada tarefa que deseja adicionar a um elemento visual. As ações que você cria se tornam parte da funcionalidade de cada elemento visual ou insight. A tabela a seguir define quando usar cada tipo de ação. | Ação a ser executada | Tipo de ação | | --- | --- | | Adicionar ou personalizar uma ação de filtragem interativa, incluindo filtragens com um clique | Ação de filtragem | | Abrir outra planilha no mesmo painel | Ação de navegação | | Abrir uma planilha em um painel diferente na mesma Conta da AWS | Ação de URL | | Abrir um URL (`https` ou `http`) | Ação de URL | | Enviar um e-mail (`mailto`) | Ação de URL | É possível definir os seguintes atributos e opções para uma ação personalizada: + ****Nome da ação****: este é um nome descritivo que você escolhe para a ação. Por padrão, as ações são nomeadas **Action 1**, **Action 2**, e assim por diante. Se sua ação personalizada estiver ativada em um menu de contexto, esse nome será exibido no menu quando você clicar com o botão direito do mouse em um ponto de dados. Para tornar o nome da ação dinâmico, você pode parametrizá-lo. Use o ícone de adição próximo ao cabeçalho do nome da ação para exibir uma lista das variáveis disponíveis. As variáveis são delimitadas entre parênteses angulares `<< >>`. Os parâmetros são prefixados com `$`, por exemplo `<<$parameterName>>`. Os nomes dos campos não têm prefixos, por exemplo `<>`. + ****Ativação****: as opções disponíveis são **Selecionar** ou **Opções de menu**. Para usar uma ação, você pode *selecionar* o ponto de dados (ao clicar com o botão esquerdo do mouse) ou navegar até as *opções de menu* no menu de contexto (ao clicar com o botão direito do mouse). As ações de navegação e as ações de URL são listadas no meio do menu de contexto, logo acima das opções de **Cores**. As ações ativadas pelo menu também estão disponíveis na legenda de um elemento visual. + ****Tipo de ação****: o tipo de ação que você deseja. As configurações que são específicas para um tipo de ação são exibidas somente depois que você escolhe o tipo de ação. + As configurações da **ação de filtragem** incluem o seguinte: + ****Escopo do filtro****: os campos a serem filtrados. Para filtrar todos os campos, escolha **All fields (Todos os campos)**. Como alternativa, escolha **Selecionar campos** e, em seguida, desative os itens que você não deseja como destinos. O padrão é **Todos os campos**. + ****Elementos visuais de destino****: os widgets do painel a serem segmentados. Para aplicar o filtro a todos eles, escolha **Todos os elementos visuais**. Como alternativa, escolha **Selecionar elementos visuais** e, em seguida, desative os itens que você não deseja como destinos. Quando você aplica uma ação de filtro a outros visuais, o efeito é chamado de *filtros em cascata*. O padrão é **Todos os elementos visuais.** Um filtro em cascata aplica todos os visuais configurados na seção **Target visuals (Visuais de destino)** de uma ação de filtro específica. O Amazon Quick Sight avalia inicialmente seus recursos visuais e pré-configura as configurações para você. Entretanto, você pode alterar os padrões se desejar. Você pode configurar vários filtros em cascata em vários visuais na mesma planilha ou análise. Quando você estiver usando a análise ou o painel, você poderá usar vários filtros em cascata ao mesmo tempo, embora você ative um de cada vez. Uma ação de filtragem requer, no mínimo, um elemento visual de destino, porque uma ação de filtragem requer uma origem e um destino. Para filtrar apenas o visual atual, crie um filtro regular escolhendo **Filter (Filtrar)** à esquerda. + As configurações da **ação de navegação** incluem o seguinte: + ****Planilha de destino****: a planilha a ser usada como destino. + ****Parâmetros****: os parâmetros a serem enviados para a planilha de destino. Escolha o ícone de adição para adicionar um parâmetro existente. + As configurações da **ação de URL** incluem o seguinte: + ****URL****: o URL a ser aberto. As ações de URL podem ser links diretos para outras aplicações. Os esquemas de URL válidos incluem `https`, `http` e `mailto`. + ****\$1** (Valores)** — (Opcional) Os parâmetros a serem enviados para o URL de destino. Os nomes dos parâmetros começam com `$`. Os parâmetros sobre o final do envio e do recebimento devem corresponder em nome e tipo de dados. + ****Abrir em****: local em que o URL será aberto. Você pode escolher **New browser tab (Nova guia do navegador)**, **Same browser tab (Mesma guia do navegador)** ou **New browser window (Nova janela do navegador)**. Alguns tipos de ações possibilitam que você inclua valores de parâmetros ou de campos que estão disponíveis no elemento visual ou no insight. Você pode digitá-los manualmente ou escolher **\$1** para selecionar em uma lista. Para que a ação personalizada funcione, todos os campos e parâmetros referenciados devem estar em uso ativo no widget primário. Use o procedimento a seguir para criar, exibir ou editar uma ação personalizada em uma análise. **Criar, visualizar ou editar uma ação personalizada** 1. Com a análise aberta, escolha **Ações** no menu **Opções de menu** suspenso localizado no canto superior direito. As ações existentes serão exibidas por tipo de ativação, se houver. Para ativar ou desativar uma ação existente, use a caixa à direita do nome da ação. 1. (Opcional) Para editar ou visualizar uma ação existente, escolha o ícone do menu ao lado do nome da ação. Para editar a ação, escolha **Edit (Editar)**. Para excluí-la, escolha **Delete (Excluir)**. 1. Para criar uma nova ação, escolha uma das seguintes opções: + O ícone de adição próximo ao título **Ações** + O botão **Definir uma ação personalizada**. 1. Em **Nome da ação**, defina um nome para a ação. Para tornar o nome da ação dinâmico, use o ícone de adição para adicionar valores de parâmetros ou campos. 1. Em **Ativação**, escolha como a ação será executada. 1. Em **Tipo de ação**, escolha o tipo de ação que você deseja usar. 1. Para uma **Ação de filtragem**, faça o seguinte: 1. Em **Escopo do filtro**, escolha o escopo do filtro. 1. Em **Elementos visuais de destino**, escolha até que ponto o filtro realizará a cascata. 1. Para uma **Ação de navegação**, faça o seguinte: 1. Em **Planilha de destino**, escolha a planilha de destino. 1. Em **Parâmetros**, escolha o ícone de adição próximo ao título **Parâmetros**, selecione um parâmetro e, em seguida, escolha um valor de parâmetro. É possível escolher todos os valores, inserir valores personalizados ou selecionar campos específicos. 1. Para uma **Ação de URL**, faça o seguinte: 1. Em **URL**, insira o hiperlink. 1. Escolha o ícone de adição próximo ao título **do URL**. Em seguida, adicione variáveis ​​da lista. 1. Em **Abrir em**, escolha como o URL será aberto. 1. Após concluir a ação, escolha uma das seguintes opções na parte inferior do painel **Ações** (talvez seja necessário rolar para baixo): + **Salvar**: salve suas seleções e crie a ação personalizada. + **Fechar**: feche esta ação personalizada e descarte as alterações. + **Excluir**: exclua esta ação. # Como reparar ações personalizadas Para que uma ação personalizada funcione, todos os campos e parâmetros referenciados devem estar ativos no widget primário. Se um campo estiver ausente no widget de origem ou se um parâmetro estiver ausente na análise, a ação para esse campo ou para esse parâmetro ficará indisponível. As ações de menu não estão mais inclusas no menu de contexto. As ações selecionadas não respondem mais às tentativas de interação. No entanto, em todos os outros aspectos, o widget continua a funcionar. Nenhum erro é exibido para seus usuários. Você pode corrigir ações de filtragem e ações de URL que não estão funcionando ao adicionar os campos ausentes novamente ao elemento visual ou ao insight com falha. O procedimento a seguir explica como corrigir uma ação que não está funcionando porque alguém removeu um campo ou um parâmetro sem atualizar a ação. Estas etapas fornecem orientações básicas sobre como corrigir esse problema. No entanto, use seu próprio julgamento sobre como ou se deverá fazer alterações na análise. Se você não tiver certeza, é melhor pedir ajuda a um administrador do Amazon Quick antes de alterar qualquer coisa. Por exemplo, pode haver uma maneira de restaurar uma versão anterior da análise, o que pode ser mais seguro se você não tiver certeza do que aconteceu com ela. **Remover um campo de uma ação que não está funcionando** 1. Na página inicial, escolha **Análises**. Em seguida, escolha a análise a ser corrigida. 1. Escolha o elemento visual ou o insight em que a ação não funciona mais. Certifique-se de que isso estará destacado na planilha. 1. Escolha **Ações** no menu Opções de menu suspenso localizado no canto superior direito. 1. Localize a ação que você deseja corrigir e escolha **Editar**. 1. Se o tipo de ação for **Ação de filtragem** e você receber um erro informando que *o campo usado por esta ação foi removido*, verifique as configurações de **Escopo do filtro**. Os **campos selecionados** podem exibir somente campos que estão no elemento visual. Para desabilitar os campos selecionados que foram removidos, escolha uma das seguintes opções: + Altere a configuração do **Escopo do filtro** para **Todos os campos**. Isso possibilitará que o widget filtre todos os campos. + Se você desejar usar uma lista de **Campos selecionados**, verifique a lista com os campos. Se precisar incluir outro campo, será necessário adicioná-lo ao elemento visual primeiro. 1. Se o tipo de ação for **Ação de navegação**, siga as orientações presentes na mensagem de erro, que reflete sobre o tipo de alteração que causou o erro. 1. Se o tipo de ação for **Ação de URL**, verifique a configuração do **URL** para variáveis ​​marcadas com parênteses angulares duplos (`<`). Abra a lista de variáveis disponíveis escolhendo o ícone de adição. Remova quaisquer campos ou parâmetros que não estejam na lista. Certifique-se de remover também o *parâmetro de URL* correspondente e seu separador (`?` para o primeiro parâmetro de URL ou `&` para os parâmetros subsequentes). Os exemplos a seguir mostram (em **negrito**) qual parte será removida se você estiver removendo o campo denominado `Product` do elemento visual. ``` https://www.example.com/examplefunction?q=< ``` ``` https://www.example.com/examplefunction?q=<&uact=<<$CSN> ``` ``` https://www.example.com/examplefunction?pass=yes&q=<+<&oq=<+<&uact=<<$CSN> ``` Certifique-se de testar o novo URL. 1. (Opcional) Para excluir a ação, role até o final da página e escolha **Excluir**. 1. Quando terminar, confirme as alterações na ação. Role até a parte inferior do painel **Ação** e escolha **Salvar**. Se o erro também existir em um painel associado, compartilhe e publique o painel novamente para propagar a correção. # Entendendo o mapeamento de campo para ações personalizadas no Amazon Quick Sight O mapeamento de campo automatizado é baseado em campos idênticos. Os campos com o mesmo nome e tipo de dados são mapeados automaticamente entre conjuntos de dados. Seus nomes de campo e tipos de dados devem corresponder de maneira exata. Isso funciona de forma semelhante a uma junção, exceto pelo fato de ser gerado automaticamente com base em nomes e tipos de dados para cada campo correspondente. Se estiver faltando campos, é possível criá-los usando campos calculados no conjunto de dados que está faltando um campo. Se não quiser ter alguns dos campos mapeados uns para os outros, você pode renomeá-los ou removê-los do conjunto de dados. É importante garantir que todos os campos de destino sejam mapeados se estiverem habilitados para uso com uma ação de filtro (no **Filter scope (Escopo do filtro)**). Isso permite que a filtragem seja aplicada automaticamente. Se alguns campos de destino não forem mapeados, a filtragem automática não funcionará. O mapeamento é gerado somente quando você cria ou salva uma ação personalizada. Portanto, após realizar alterações que afetem o mapeamento, certifique-se de retornar e salvá-lo novamente. Quando você cria uma ação, o mapeamento é baseado nos campos conforme existem naquele ponto. Quando você salva uma ação, todos os campos mapeados que você renomeou desde que criou a ação personalizada permanecem mapeados. No entanto, se você alterar o tipo de dados de um campo mapeado, o mapeamento será removido. Se o seu mapeamento estiver com alguns campos ausentes, você pode fazer um dos seguintes procedimentos para corrigi-lo: + Visar apenas os campos mapeados, removendo os campos não mapeados do **Filter scope (Escopo do filtro).** + Remova o visual em questão dos visuais de destino. + Criar campos calculados para fornecer os campos ausentes para o mapeamento e, em seguida, salvar sua ação personalizada. + Editar o conjunto de dados e renomear os campos ou alterar os tipos de dados deles e, em seguida, salvar sua ação personalizada. + Edite o conjunto de dados e renomeie os campos ou altere seus tipos de dados, e salve novamente sua ação personalizada. **nota** As informações exibidas na tela de mapeamento mostram a configuração desde o último momento em que você a salvou. Para atualizar a exibição, salve a ação novamente. Se você adicionar ou editar conjuntos de dados, eles não serão mapeados nem remapeados automaticamente. Isso faz com que a filtragem funcione incorretamente. Por exemplo, suponha que você adicione um novo conjunto de dados e crie visuais para ele. Os novos visuais não responderão às ações de filtro, pois não há mapeamento de campo para conectá-los. Ao fazer alterações, lembre-se de salvar suas ações personalizadas novamente para refazer os mapeamentos de campo. Se você remover um campo parametrizado ou qualquer outro campo de destino do visual de origem, a ação que o utiliza será interrompida. A ação para o campo ausente não funciona quando você seleciona um ponto de dados ou fica oculta no menu de contexto. Para obter informações sobre como preparar seu conjunto de dados para mapeamento de campo automatizado, consulte [Mapear campos](mapping-and-joining-fields.md#mapping-and-joining-fields-automatic).