

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Trabajar con hojas interactivas en Amazon Quick Sight
<a name="working-with-interactive-sheets"></a>

Una *hoja interactiva* es una colección de datos expresados en elementos visuales con los que los usuarios pueden interactuar cuando la hoja se publica en un panel de control. Los autores de Amazon Quick pueden añadir diferentes diseños, controles y filtros a sus hojas interactivas que los usuarios de los paneles pueden utilizar para obtener información detallada a partir de los datos publicados. De forma predeterminada, cada hoja de un análisis es una hoja interactiva. Si tu cuenta no tiene el **complemento Pixel Perfect Reporting**, solo puedes crear y publicar hojas interactivas.

Para obtener más información sobre cómo crear hojas interactivas, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md).

Para obtener más información sobre el formato de las hojas interactivas, consulte los temas siguientes.

**Topics**
+ [Personalización de los diseños de los paneles en Amazon Quick Sight](customizing-dashboards-and-visuals.md)
+ [Parámetros en Amazon Quick](parameters-in-quicksight.md)
+ [Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md)

# Personalización de los diseños de los paneles en Amazon Quick Sight
<a name="customizing-dashboards-and-visuals"></a>

Puede personalizar el diseño de un panel para organizar los datos de forma que se ajusten a los requisitos de su empresa. Puede elegir entre tres diseños de panel. También puede cambiar el tamaño, el color de fondo, el color del borde y las interacciones de un elemento visual para crear un panel totalmente personalizado.

Utilice los siguientes temas para obtener más información sobre la personalización de paneles y elementos visuales.

**Topics**
+ [Tipos de diseño](types-of-layout.md)
+ [Selección de un diseño](choosing-a-layout.md)
+ [Personalización de elementos visuales en un diseño de formato libre](customizing-visuals-in-free-form.md)
+ [Reglas condicionales](conditional-rules.md)

# Tipos de diseño
<a name="types-of-layout"></a>

Puede elegir entre tres diseños de paneles: **En mosaico**, **Formato libre** y **Clásico**.

## Diseño en mosaico
<a name="tiled-layout"></a>

Los elementos visuales de un diseño en **mosaico** se ajustan a una cuadrícula con espaciado y alineación estándar. Puede crear elementos visuales de cualquier tamaño y colocarlos donde quiera dentro de un panel, pero los elementos visuales no pueden superponerse. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/fixed-layouts-tiled-demo.gif)


Los paneles se muestran tal y como están diseñados, con opciones para ajustarlos a la pantalla o verlos a tamaño real. También puede ajustar un panel completo a la ventana si elige **Ajustar a la ventana** en **Ver**, en la esquina superior derecha. Anteriormente, esta opción se llamaba **Optimizado**.

**nota**  
En los dispositivos móviles, los paneles con diseño en mosaico aparecen como una sola columna en modo vertical o exactamente como se diseñaron en modo horizontal. 

## Diseño de formato libre
<a name="free-form-layout.title"></a>

Los elementos visuales de un diseño de **formato libre** pueden colocarse en cualquier lugar del panel con unas coordenadas precisas. Puede arrastrar una imagen al lugar exacto que desee o ingresar las coordenadas de la ubicación del elemento visual. Siga este procedimiento para ingresar las coordenadas exactas de la ubicación del elemento visual.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/fixed-layouts-freeform-placement1.gif)


Los paneles de control se muestran de la forma que elija para diseñarlos, con opciones para ajustarlos a la pantalla o para verlos en su tamaño real. Puede optimizar los diseños de formato libre para verlos a resoluciones específicas, con la predeterminada de 1600 píxeles. También puede ajustar un panel completo a la ventana de un navegador si elige **Ajustar a la ventana** en **Ver**, en la esquina superior derecha.

**nota**  
Los paneles con resoluciones optimizadas pueden aparecer más grandes o más pequeños en el equipo del usuario si la resolución del equipo del usuario no es igual a la resolución establecida del panel.   
El cambio de **formato libre** a otro diseño puede hacer que algunos elementos visuales cambien.  
En los dispositivos móviles, los paneles de **formato libre** aparecen tal y como se publicaron, sin cambios en el diseño.

## Diseño clásico
<a name="classic-layout.title"></a>

Los elementos visuales de un diseño **clásico** se ajustan a una cuadrícula con espaciado y alineación estándar. Los paneles ocultan datos o cambian el formato para adaptarse a pantallas más pequeñas. Por ejemplo, si cambia un elemento visual para que sea considerablemente menor, el menú de elementos visuales y los editores se ocultan de forma que los elementos del gráfico dispongan de más espacio para mostrarse. Los elementos visuales del gráfico de barras también pueden mostrar menos puntos de datos.

Si reduce el tamaño de la ventana del navegador, Amazon Quick Sight cambia el tamaño y, si es necesario, reordena las imágenes para una visualización óptima. Por ejemplo, los elementos visuales más pequeños que se mostraban en paralelo pueden mostrarse de forma secuencial. El diseño original se restablece cuando el tamaño de la ventana del navegador se aumenta de nuevo.

**nota**  
En los dispositivos móviles, los paneles de control de diseño clásico aparecen como una sola columna o exactamente como se diseñaron en modo horizontal.

# Selección de un diseño
<a name="choosing-a-layout"></a>

**Cambio del diseño de un panel de control**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee cambiar.

1. En la página de análisis, elija **Editar** y, a continuación, elija **Configuración de análisis**.

1. Expanda **Diseño de la hoja** y elija el diseño que desea usar.

1. Cuando haya terminado, seleccione **Apply**.

# Personalización de elementos visuales en un diseño de formato libre
<a name="customizing-visuals-in-free-form"></a>

Puede utilizar el diseño de formato libre para personalizar completamente el color, tamaño, ubicación y visibilidad de cada elemento visual en un panel.

## Organización de elementos visuales
<a name="organizing-visuals.title"></a>

Además de arrastrar un elemento visual a su ubicación preferida dentro de un panel, hay muchas maneras diferentes de mover un elemento visual a la ubicación precisa en la que debe estar.

**Introducción de las coordenadas de la ubicación del elemento visual**

1. Elija el elemento visual que quiera.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abrirá, elija **Ubicación**. 

1. Ingrese las coordenadas **X** e **Y** de la ubicación en la que desea colocar el elemento visual. También puede ajustar el tamaño del elemento visual si ingresa los valores de **Ancho** y **Alto**. 

Las imágenes seleccionadas también se pueden mover pixel-by-pixel con las teclas de flecha del teclado.

Puede superponer los elementos visuales para crear imágenes de varias capas que muestren datos.

Los elementos visuales pueden organizarse en varias capas que pueden desplazarse manualmente al frente y al fondo.

**Desplazamiento de los elementos visuales superpuestos al frente y al fondo**

1. Elija el elemento visual que quiera.

1. **En el menú de tres puntos situado en la parte superior derecha de la imagen, selecciona Opciones de menú.**

1. En **Opciones de menú**, elija entre las siguientes opciones:
   + **Enviar al fondo** envía el elemento visual al fondo.
   + **Enviar hacia atrás** envía el elemento visual una capa hacia atrás.
   + **Traer hacia delante** envía el elemento visual una capa hacia delante.
   + **Traer al frente** trae un elemento visual al frente.

## Cambio del color de fondo de un elemento visual
<a name="changing-a-visuals-background-color.title"></a>

Los colores del fondo, borde y marco de selección de un elemento visual pueden personalizarse en el panel **Configuración de visualización** del panel **Propiedades**.

**Cambio del color del fondo, borde o marco de selección de un elemento visual**

1. Elija el elemento visual que desea cambiar.

1. En el menú de la esquina superior derecha del elemento visual, elija el icono **Propiedades**.

1. En el panel **Propiedades** que aparece a la izquierda, elija **Configuración de visualización**.

1. Navegue hasta la sección **Estilo de tarjeta** y lleve a cabo una o varias de las acciones disponibles:
   + Para cambiar el color del fondo de un elemento visual, elija el cuadro **Color de fondo** y elija el color que desee.
   + Para cambiar el color del borde de un elemento visual, elija el cuadro **Color del borde** y elija el color que desee.
   + Para cambiar el color del marco de selección de un elemento visual, elija el cuadro **Color de selección** y elija el color que desee.

   Si desea usar un color personalizado para el fondo, el borde o el marco de selección del elemento visual, elija el cuadro de color de la propiedad que desee cambiar y, a continuación, elija **Color personalizado**. En la ventana **Color personalizado** que aparecerá, elija su color personalizado o introduzca el código hexadecimal del color. Cuando haya terminado elija **Apply (Aplicar)**.

También puede restablecer el aspecto predeterminado del fondo personalizado de un elemento visual.

**Restablecimiento del aspecto de un elemento visual**

1. Elija el elemento visual que desea cambiar.

1. En el menú de la esquina superior derecha del elemento visual, elija el icono **Propiedades**.

1. En el panel **Propiedades** que aparece a la izquierda, elija **Configuración de visualización**.

1. Elija el color que desee restablecer y, a continuación, elija **Restablecer al valor predeterminado**.

## Ocultación de fondos, bordes y colores de selección de elementos visuales
<a name="hiding-visual-backgrounds-and-borders.title"></a>

También puede elegir no mostrar el borde de fondo o el color de selección de un elemento visual. Esto resulta útil cuando desea superponer varios elementos visuales. Puede ocultar el fondo, el borde y los colores de selección de un elemento visual si elige el icono de ojo situado junto a las casillas **Color del borde**, **Color de fondo** o **Color de selección**. También puede eliminar la animación de carga de un elemento visual si desactiva la casilla **Mostrar animación de carga**. 

## Desactivación de los menús de los elementos visuales
<a name="disabling-visual-menus.title"></a>

Utilice el panel **Interacciones** del panel **Propiedades** para ocultar el **Menú contextual** y el **Menú visual** de las imágenes seleccionadas. Los menús de elementos visuales secundarios se pueden ocultar para que el elemento visual esté menos saturado o para que un elemento visual actúe como una superposición. 

El menú **contextual** se abre al hacer clic en un punto de datos. Las acciones más comunes del **Menú contextual** son **Enfocar**, **Excluir** y **Desglosar**.

El menú **En elemento visual** aparece en la parte superior derecha de un elemento visual. El menú **Elemento visual** se utiliza para acceder al panel **Propiedades**, **Maximizar** el elemento visual, acceder al panel **Opciones de menú** y revisar **Información de anomalías**.

Puede desactivar los menús visuales secundarios borrando las opciones **Menú contextual** y **Menú del elemento visual**.

**nota**  
No puede previsualizar los cambios del panel **Interacciones** en **Análisis**. Publique el panel para ver los cambios.

# Reglas condicionales
<a name="conditional-rules"></a>

Esta característica está disponible actualmente con el diseño de **formato libre**. Las reglas condicionales se usan para ocultar o mostrar elementos visuales cuando se cumplen determinadas condiciones. Esto es muy útil cuando hay varias versiones del mismo elemento visual superpuestas y se desea que el usuario vea la versión que mejor representa el valor del parámetro seleccionado. 

Las reglas condicionales utilizan parámetros y controles de parámetros para ocultar y mostrar elementos visuales. Los parámetros son variables con nombre que pueden pasar un valor para que lo use una acción o un objeto. Esta característica admite parámetros numéricos y de cadena. Para que los parámetros estén accesibles para el lector del panel, se añade un control de parámetros. Un control de parámetros permite a los usuarios elegir un valor para utilizarlo en un filtro predefinido o en una acción de URL. Para obtener más información sobre parámetros y controles de parámetros, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

Use las siguientes secciones para configurar y usar reglas condicionales.

**Topics**
+ [Ocultación de un elemento visual predeterminado](hiding-a-visual-by-default.title.md)
+ [Configuración de una regla condicional](setting-a-conditional-rule.title.md)
+ [Uso de reglas condicionales](using-conditional-rules.md)

# Ocultación de un elemento visual predeterminado
<a name="hiding-a-visual-by-default.title"></a>

En el panel **Interacciones** del panel **Propiedades**, puede optar por ocultar un elemento visual de forma predeterminada. Esto puede ser útil si quiere que el espectador solo vea elementos visuales basados en condiciones específicas.

**Ocultación de un elemento visual predeterminado**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija el elemento visual al que desea agregar una regla.

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que se abrirá, elija **Interacciones** y abra el menú desplegable **Reglas**.

1. En el menú **Reglas**, seleccione **Ocultar este elemento visual de forma predeterminada**.

Los elementos visuales ocultos aparecen totalmente ocultos en un panel de visualización. En el panel **Análisis**, los elementos visuales ocultos aparecen con el mensaje “Oculto en función de una regla”. Con esta visualización, puede ver dónde se encuentran todos los elementos visuales de un panel.

**nota**  
No se pueden crear reglas condicionales que oculten elementos visuales que ya están ocultos de forma predeterminada o que muestren elementos visuales que ya aparecen de forma predeterminada. Si cambia la apariencia predeterminada de un elemento visual, se desactivarán las reglas existentes que contradigan la nueva apariencia predeterminada.

# Configuración de una regla condicional
<a name="setting-a-conditional-rule.title"></a>

Cuando se configura una regla condicional, se crea una instrucción condicional que ocultará o mostrará un elemento visual cuando se cumpla una condición específica. Actualmente se pueden crear reglas condicionales que oculten o muestren un elemento visual. Si quiere crear una regla condicional que haga aparecer un elemento visual oculto, seleccione **Ocultar este elemento visual de forma predeterminada** en el menú **Reglas** del panel **Propiedades**. 

**nota**  
Antes de empezar, cree un parámetro y un control de parámetro correspondiente en los que basar su nueva regla condicional. Los parámetros admitidos son parámetros de cadena y numéricos. Para obtener más información sobre parámetros y controles de parámetros, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

**Establecimiento de una regla condicional**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija el elemento visual al que desea agregar una regla.

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione **AGREGAR REGLA**.

1. En el primer menú del panel **Agregar regla**, elija el parámetro que desee.

1. En el segundo menú del panel **Agregar regla**, elija la condición que desee. Para los parámetros de cadena, las condiciones admitidas son **Igual a**, **Empieza por**, **Contiene** y **No es igual a**. Para los parámetros numéricos, las condiciones admitidas son **Igual a**, **Empieza por**, **Contiene** y **No es igual a**.

1. Ingrese el valor que desea que cumpla la regla condicional.
**nota**  
Los valores distinguen entre mayúsculas y minúsculas.

1. Seleccione **Agregar regla** para aplicar la nueva regla condicional al elemento visual. Para cancelar la regla, seleccione **Cancelar**.

Las reglas condicionales también pueden editarse y eliminarse. 

**Edición de una regla condicional**

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione el icono de menú situado a la derecha de la regla que desea editar y elija **Editar**.

1. Realice los cambios que desee y seleccione **Guardar**.

**Eliminación de una regla condicional**

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione el icono de menú situado a la derecha de la regla que desea editar y elija **Eliminar**.

# Uso de reglas condicionales
<a name="using-conditional-rules"></a>

Una vez que configuró una regla condicional que está conectada a un parámetro y a un control de parámetro, puede utilizar el control de parámetro para activar o desactivar las reglas condicionales que configuró. 

**Habilitación de una regla condicional**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. En la barra de **Controles** de la parte superior del área de trabajo, seleccione el icono desplegable.

1. Elija el control de parámetros asociado a la regla condicional que creó.

1. Elija el valor asociado a la regla condicional que creó en el menú del parámetro. También puede ingresar el valor que desee en el cuadro **Buscar valor**.
**nota**  
Los valores distinguen entre mayúsculas y minúsculas.

   Si selecciona el valor correcto, el elemento visual aparecerá o desaparecerá en función de la regla que se estableció.

También puede incorporar un control de parámetros a la hoja en la que se encuentra el elemento visual. Esto es útil cuando quiere que un control de parámetros esté junto al elemento visual al que está asociado o cuando quiere agregar una regla condicional al control para que solo aparezca cuando se cumplan determinadas condiciones. 

**Incorporación de un control de parámetros a una hoja**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. En la barra de **Controles** de la parte superior del área de trabajo, elija el control que desea mover.

1. En la parte superior derecha del control, abra el menú **Opciones de menú**. 

1. Seleccione **Mover a la hoja**.

**Devolución de un control de parámetros a la barra de controles**

1. En su panel, seleccione el control de parámetros que desea mover. 

1. En la parte superior derecha del control, abra el menú **Opciones de menú**. 

1. Elija **Moverse a la parte superior de la hoja**. 

# Parámetros en Amazon Quick
<a name="parameters-in-quicksight"></a>

Los *parámetros* son variables con nombre que pueden pasar un valor para que lo use una acción o un objeto. Al utilizar parámetros, puede crear una forma más sencilla para que un usuario del panel interactúe con las características de éste de una forma menos técnica. Los parámetros también pueden conectar un panel con otro, lo que permite al usuario profundizar hasta llegar a datos de otro análisis.

Por ejemplo, un usuario de un panel puede utilizar una lista para elegir un valor. Ese valor define un parámetro que a su vez establece el valor elegido en un filtro, un cálculo o una acción de URL. A continuación, los elementos visuales del panel reaccionarán a las opciones que elija el usuario. 

Para que los parámetros estén accesibles para el lector del panel, se añade un control de parámetros. Puede configurar los controles en cascada, de modo que una selección en un control filtre las opciones que aparecen en otro. Un control puede aparecer como una lista de opciones, un control deslizante, o un área de entrada de texto. Aunque no cree un control, puede transferir un valor al parámetro en la URL del panel.

Para que un parámetro funcione, tiene que estar conectado a algo en su análisis, independientemente de si tiene un control relacionado. Puede hacer referencia a los parámetros de la siguiente manera:
+ Campos calculados (excepto los parámetros con varios valores)
+ Filtros
+ Panel de control y análisis URLs
+ Acciones
+ Títulos y descripciones a lo largo de un análisis

A continuación se indican algunas maneras de usar los parámetros:
+ Puede utilizar un cálculo para transformar los datos que se muestran en un análisis. 
+ Si agrega un control con un filtro a un análisis que va a publicar, los usuarios del panel podrán filtrar los datos sin necesidad de crear sus propios filtros.
+ Puede usar los controles y las acciones personalizadas para permitir que los usuarios del panel establezcan valores para las acciones de dirección URL. 

**Topics**
+ [Configuración de parámetros en Amazon Quick](parameters-set-up.md)
+ [Uso de un control con un parámetro en Amazon Quick](parameters-controls.md)
+ [Creación de parámetros predeterminados en Amazon Quick](parameters-default-values.md)
+ [Conexión a parámetros en Amazon Quick](parameters-connections.md)

# Configuración de parámetros en Amazon Quick
<a name="parameters-set-up"></a>

Utilice el siguiente procedimiento para crear o editar un parámetro básico.

**Creación o edición de un parámetro básico**

1. Elija un análisis con el que trabajar y, a continuación, decida qué campo desea parametrizar.

1. Elija el icono **Parámetros** de la lista de iconos situada en la parte superior de la página.

1. Para agregar un nuevo parámetro, seleccione el signo más (**\$1 Agregar**) situado en la parte superior del panel.

   Para editar un parámetro, elija el icono con forma de `v` situado cerca del nombre del parámetro y, a continuación, elija **Editar parámetro**. 

1. En **Nombre**, ingrese un valor alfanumérico para el parámetro.

1. En **Tipo de datos**, elija **Cadena**, **Número**, **Entero** o **Fecha y hora** y, a continuación, siga los pasos siguientes.
   + Si elige **Cadena**, **Número** o **Entero**, haga lo siguiente:

     1. En **Valores**, elija **Valor único** o **Valores múltiples**.

        Elija la opción de valor único para los parámetros que solo pueden contener un valor. Elija varios valores para los parámetros que pueden contener uno o más valores. Los parámetros con varios valores no puede ser de los tipos `datetime`. Tampoco admiten valores predeterminados dinámicos.

        Para cambiar un parámetro existente entre uno y varios valores, elimine el parámetro y vuelva a crearlo.

     1. (Opcional) En **Valor predeterminado estático** o **Valores predeterminados múltiples estáticos**, ingrese uno o más valores.

        Este tipo de valor estático se utiliza durante la primera carga de la página si no se proporciona un valor dinámico predeterminado o un parámetro URL.

     1. (Opcional) Seleccione **Mostrar como vacío de forma predeterminada**.

        Seleccione esta opción para mostrar el valor predeterminado de las listas de varios valores como en blanco. Esta opción solo se aplica a los parámetros de varios valores.
   + Si elige **Fecha y hora**, haga lo siguiente:

     1. En **Grado de detalle del periodo de tiempo**, elija **Día**, **Hora**, **Minuto** o **Segundo**.

     1. En **Fecha predeterminada**, seleccione **Fecha fija** o **Fecha relativa** y, a continuación, haga lo siguiente:
        + Si selecciona **Fecha fija**, ingrese una fecha y hora con el selector de fecha y hora.
        + Si selecciona **Fecha relativa**, elija una fecha variable. Puede elegir **Hoy**, **Ayer**, o puede especificar la **Condición de filtro** (inicio de o fin de), **Rango** (este, anterior o siguiente) y **Periodo** (año, trimestre, mes, semana o día).

1. (Opcional) Seleccione **Establecer un valor predeterminado dinámico** para crear un valor predeterminado específico del usuario.

   Un *valor predeterminado dinámico *es un valor predeterminado que varía en función del usuario y se utiliza la primera vez que se carga la página del panel. Utilice un valor predeterminado dinámico para crear una vista personalizada por usuario.

   No se pueden utilizar campos calculados como valores predeterminados dinámicos.

   Los valores predeterminados dinámicos no impiden que un usuario seleccione un valor diferente. Si desea proteger los datos, puede agregar un bloqueo de nivel de fila. Para obtener más información, consulte [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datosUso de reglas basadas en usuarios](restrict-access-to-a-data-set-using-row-level-security.md).

   Esta opción solo aparece si elige un parámetro de valor único. Los parámetros con varios valores no pueden tener valores predeterminados dinámicos.
**nota**  
Si elige un parámetro con varios valores, la pantalla cambia para suprimir las opciones predeterminadas. En su lugar, verá un cuadro con el texto **Especifique los valores que desea usar para este control**. Puede escribir varios valores en este cuadro, cada uno en una línea. Estos valores se seleccionarán de forma predeterminada en el control del parámetro. Los valores indicados se agregan a los que decida incluir en el control del parámetro. Para obtener más información sobre los controles de parámetros, consulte [Controles de parámetros](parameters-controls.md).

1. (Opcional) Establezca un valor reservado para determinar el valor del valor **Seleccionar todo**. El *valor reservado* de un parámetro es el valor que se asigna a un parámetro cuando se elige **Seleccionar todo** como su valor. Cuando establece un valor reservado específico para su parámetro, ese valor ya no se considera un valor de parámetro válido en su conjunto de datos. El valor reservado no se puede utilizar en ningún *consumidor de parámetros*, como filtros, controles y campos calculados, ni en acciones personalizadas. Además, no aparece en la lista de control de parámetros. Puede elegir entre **Valor recomendado**, **Nulo** y **Personalizado**. El **valor recomendado** es el predeterminado. Si elige **Valor recomendado**, el valor reservado se establece en los siguientes valores en función del tipo de valor:
   + Cadenas: `"ALL_VALUES"`
   + Números: `"Long.MIN_VALUE"-9,223,372,036,854,775,808`
   + “Enteros: `Int.MIN_VALUE"-2147483648`

   Para establecer un valor reservado en su nuevo parámetro, elija la lista desplegable **Configuración avanzada** en la página **Crear un nuevo parámetro** o en la página **Editar parámetro** y seleccione el valor que desee.

1. Seleccione **Crear** o **Actualizar** para completarla creación o actualización del parámetro.

Después de crear un parámetro, puede utilizarlo de diversas formas. Puede crear un control (como, por ejemplo, un botón) que permita elegir un valor para el parámetro. Para obtener más información, consulte las siguientes secciones.

# Uso de un control con un parámetro en Amazon Quick
<a name="parameters-controls"></a>

En los paneles, los controles de parámetros aparecen en la parte superior de la hoja de datos, que contiene un conjunto de elementos visuales. Proporcionar un control permite a los usuarios elegir un valor para utilizarlo en un filtro o acción de URL. Los usuarios de un panel pueden utilizar controles para aplicar filtros a todos los conjuntos de datos de elementos visuales de un panel, sin tener que crear ellos mismos los filtros. 

Se aplican las siguientes reglas:
+ Para crear o editar un control de un parámetro, asegúrese de que el parámetro existe. 
+ Los controles de lista de selección múltiple son compatibles con el análisis URLs, el panel de control URLs, las acciones personalizadas y los filtros personalizados. El filtro tiene que ser igual o distinto a los valores proporcionados. No se admiten más comparaciones. 
+ Las listas muestran hasta 1000 valores. Si hay más de 1000 valores distintos, aparece un cuadro de búsqueda para que pueda filtrar la lista. Cuando la lista filtrada contiene menos de 1001 valores, el contenido de la lista aparece como partidas.
+ La opción **Estilo** solo muestra los tipos de estilos que correspondan al tipo de datos del parámetro y a la selección de valor individual o múltiple. Si el estilo que quiere utilizar no está en la lista, vuelva a crear el parámetro con la configuración adecuada e inténtelo de nuevo.
+ Si el parámetro está vinculado a un campo del conjunto de datos, debe ser un campo real. No se admiten campos calculados.
+ Los valores se muestran en orden alfabético en el control, a menos que haya más de 1000 valores distintos. A continuación, el control muestra un cuadro de búsqueda en su lugar. Cada vez que busca el valor que se desea utilizar, se inicia una nueva consulta. Si los resultados contienen más de 1000 valores, puede desplazarse por los valores con paginación. Se admite la búsqueda con comodines. Para obtener más información sobre la búsqueda con comodines, consulte [Uso de la búsqueda comodín](search-filter.md#search-filter-wildcard).

Utilice el siguiente procedimiento para crear o editar un control para un parámetro existente. 

**Creación o edición de un control para un parámetro existente**

1. Elija el menú contextual de un parámetro existente, el icono `v` situado junto al nombre del parámetro, y elija **Agregar control**.

1. Escriba un nombre para la etiqueta del nuevo control. Esta etiqueta aparece en la parte superior del área de trabajo y, posteriormente, en la parte superior de la hoja en la que se muestra un panel. 

1. Elija el estilo del control entre los siguientes:
   + **Campo de texto**

     Un campo de texto le permite escribir su propio valor. Un campo de texto funciona con números y texto (cadenas).
   + **Campo de texto: multilínea**

     Un campo de texto multilínea le permite ingresar sus propios valores. Con esta opción, puede elegir separar los valores que ingrese en el control de parámetros mediante un salto de línea, una coma, una barra (\$1) o un punto y coma. Un campo de texto funciona con números y texto (cadenas).
   + **Lista desplegable**

     Un control de lista desplegable que puede utilizar para seleccionar un único valor. Un control de lista funciona con números y texto (cadenas). 
   + **Lista desplegable multiselección**

     Un control de lista que puede utilizar para seleccionar varios valores. Un control de lista funciona con números y texto (cadenas). 
   + **Lista**

     Un control de lista que puede utilizar para seleccionar un único valor. Un control de lista funciona con números y texto (cadenas). 
   + **Lista: multiselección**

     Un control de lista que puede utilizar para seleccionar varios valores. Un control de lista funciona con números y texto (cadenas). 
   + **Slider**

     Un control deslizante permite seleccionar un valor numérico al deslizar el control de un extremo a otro de la barra. Un control deslizante funciona bien con números.
   + **Selector de fecha**

     Con un selector de fecha, puede elegir una fecha de un control de calendario. Al agregar un selector de fecha, puede personalizar el formato de las fechas en el control. Para ello, en **Formato de fecha**, ingrese el formato de fecha que quiera con los tokens descritos en [Personalización de los formatos de fecha en Quick](format-visual-date-controls.md).

1. (Opcional) Si elige un control desplegable, la pantalla se expande de modo que puede elegir los valores que se mostrarán. Puede especificar una lista de valores o utilizar un campo de un conjunto de datos. Seleccione una de las siguientes opciones:
   + **Valores específicos**

     Para crear una lista de valores específicos, escriba uno por línea, sin espacios ni comas de separación, tal y como se muestra en la siguiente captura de pantalla.

     En el control, los valores se muestran alfabéticamente, no en el orden en que los escribió.
   + **Enlazar a un campo del conjunto de datos**

     Para enlazar a un campo, elija el conjunto de datos que contiene el campo y, a continuación, seleccione el campo en la lista.

     Si cambia los valores predeterminados del parámetro, seleccione **Restablecer** en el control para mostrar los nuevos valores.

   Los valores que elija aquí se agregan a los valores predeterminados estáticos de la configuración del parámetro.

1. (Opcional) Active la opción **Ocultar [TODOS] del control si el parámetro tiene configurado un valor predeterminado**. Al hacer esto solo se muestran los valores de los datos y se elimina la opción de seleccionar todos los elementos en el control. Si no configura un valor predeterminado estático en el parámetro, esta opción no funciona. Para agregar un valor predeterminado después de añadir un control, elija el parámetro y **Editar parámetro**.

1. (Opcional) Puede limitar los valores que se muestran en los controles de modo que solo aparezcan los que sean válidos en función de lo seleccionado en otros controles. Esto se denomina control en cascada. 

   Para crear uno, elija **Mostrar solo valores relevantes**. Elija uno o varios controles que puedan cambiar lo que se muestra en este control. 

   Al crear controles en cascada, se aplican las siguientes limitaciones.
   + Los controles en cascada deben estar vinculados a columnas del mismo conjunto de datos.
   + El control secundario debe ser un control desplegable o de lista.
   + En el caso de los controles de parámetros, el control secundario debe estar vinculado a una columna del conjunto de datos.
   + En el caso de los controles de filtro, el control secundario debe estar vinculado a un filtro (en lugar de mostrar solo valores específicos).
   + El control principal debe ser uno de los siguientes.
     + Un control de parámetros de cadena, entero o numérico.
     + Un control de filtro de cadena (EXCLUIDOS los filtros superior e inferior).
     + Un control de filtro numérico no agregado.
     + Un control de filtro de fecha (EXCLUIDOS los filtros superior e inferior).

1. Cuando haya terminado de elegir opciones para el control, seleccione **Agregar**.

El control terminado aparece en la parte superior del espacio de trabajo. El menú contextual, con forma de `v`, ofrece cuatro opciones:
+ **Restablecer** restaura la selección del usuario a su estado predeterminado.
+ **Actualizar lista** se aplica únicamente a las listas desplegables que están enlazadas a un campo de un conjunto de datos. Al elegir **Actualizar lista** se consultan los datos para comprobar si hay cambios. Los datos utilizados en el control se almacenan en la caché.
+ **Editar** vuelve a abrir la pantalla de creación del control para que pueda modificar la configuración.

  Una vez que tenga abierto el panel **Editar control**, puede hacer clic en diferentes elementos visuales y controles para ver los datos de formato para el elemento visual o control específico. Para obtener más información sobre el formato de un elemento visual, consulte [Formatear en Amazon Quick](formatting-a-visual.md).
+ **Eliminar** elimina el control. Puede volver a crearlo eligiendo el menú contextual del parámetro.

En el espacio de trabajo, también puede reordenar y redimensionar los controles. Los usuarios del panel los verán exactamente igual que usted, salvo que no podrán editarlos ni eliminarlos.

# Creación de parámetros predeterminados en Amazon Quick
<a name="parameters-default-values"></a>

En esta sección obtendrá más información sobre los tipos de valores predeterminados de parámetros que están disponibles y cómo configurar cada uno de ellos. 

Cada campo puede tener asociado un parámetro y un control. Cuando alguien visualiza un panel o un informe por correo electrónico, cualquier control de hoja que tenga configurado un valor predeterminado estático utiliza el valor predeterminado estático. El valor predeterminado puede cambiar cómo se filtran los datos, cómo se comportan las acciones personalizadas y qué texto se muestra en un título de hoja dinámico. Los informes de correo electrónico también admiten valores predeterminados dinámicos. 

El valor predeterminado más sencillo es un valor predeterminado estático (que no cambia), que muestra el mismo valor a todo el mundo. Como diseñador del panel, elige el valor predeterminado. La persona que utiliza el panel no puede cambiarlo. Sin embargo, esa persona puede elegir cualquier valor de los controles. Establecer un valor predeterminado no cambia esto. Para restringir los valores que una persona puede seleccionar, considere el uso de la seguridad a nivel de fila. Para obtener más información, consulte [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datosUso de reglas basadas en usuarios](restrict-access-to-a-data-set-using-row-level-security.md). 

**Creación o edición de un valor predeterminado estático que se aplique a todas las vistas del panel**

1. Elija el menú contextual (`v`) situado junto al parámetro que desea editar o cree un parámetro nuevo siguiendo los pasos que se indican en [Configuración de parámetros en Amazon Quick](parameters-set-up.md). 

1. Ingrese un valor para **Valor predeterminado estático** para establecer un valor predeterminado estático. 

Para mostrar un valor predeterminado diferente en función de quién esté viendo el panel, cree un parámetro predeterminado dinámico (DDP). El uso de valores predeterminados dinámicos implica cierta preparación para asignar a las personas los valores predeterminados que tienen asignados. En primer lugar, debe crear una consulta de base de datos o un archivo de datos que contenga información sobre las personas, los campos y los valores predeterminados que se mostrarán. Esto se agrega a un conjunto de datos y, a continuación, se agrega el conjunto de datos al análisis. A continuación, encontrará procedimientos que puede utilizar para recopilar información, crear el conjunto de datos y agregar el valor predeterminado dinámico al parámetro.

Use las siguientes pautas cuando cree un conjunto de datos para valores predeterminados dinámicos:
+ Se recomienda utilizar un único conjunto de datos que contenga todas las definiciones dinámicas predeterminadas de una agrupación lógica de usuarios o grupos. Si puede, manténgalas en una única tabla o archivo. 
+ También recomendamos que los nombres de los campos del conjunto de datos coincidan con los nombres de los campos del análisis. No es necesario que todos los campos del conjunto de datos formen parte del análisis, por ejemplo, si utiliza el mismo conjunto de datos para los valores predeterminados en varios paneles. Los campos pueden estar en cualquier orden. 
+ No se recomienda combinar nombres de usuario y de grupo en la misma columna o incluso en el mismo conjunto de datos. Este tipo de configuración requiere más trabajo de mantenimiento y solución de problemas. 
+ Si utiliza un archivo delimitado por comas para crear el conjunto de datos, asegúrese de eliminar cualquier espacio entre los valores del archivo. El siguiente ejemplo muestra el formato correcto de valores separados por comas (CSV). Encierre el texto (cadenas) que incluya caracteres no alfanuméricos, como espacios, apóstrofes, etc. entre comillas simples o dobles. Puede entrecomillar los campos que contengan fechas u horas, pero no es obligatorio. Puede entrecomillar los campos numéricos, por ejemplo, si los números contienen caracteres especiales, como se muestra a continuación. 

  ```
  "Value includes spaces","Field contains ' other characters",12345.6789,"20200808"
  ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
  ```
+ Tras crear el conjunto de datos, asegúrese de comprobar los tipos de datos que Quick selecciona para los campos.

Antes de empezar, necesita una lista de los nombres de usuario o grupo de las personas que van a tener valores predeterminados dinámicos. Para generar una lista de usuarios o grupos, puede utilizar la AWS CLI y obtener la información. Al ejecutar comandos de la CLI, asegúrese de tener instalada y configurada la AWS CLI . Para obtener más información, consulte [Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) en la *Guía del usuario de AWS CLI *. 

Este es solo un ejemplo de cómo obtener una lista de nombres de usuarios o grupos. Utilice cualquier método que mejor le funcione.

**Identificación de las personas para un parámetro dinámico predeterminado (DDP)**
+ Enumere los nombres de usuario individuales o los nombres de grupo:
  + Para enumerar nombres de usuario individuales, incluya una columna que identifique a las personas para su DDP. Esta columna debe contener el nombre de usuario del sistema de cada persona que utilice para conectarse desde su proveedor de identidad a Quick. El nombre de usuario suele coincidir con el alias de correo electrónico de la persona antes del signo @, pero no siempre. 

    Para obtener una lista de usuarios, utilice la operación o el AWS CLI comando [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html)Quick API. El comando de la CLI se muestra en el siguiente ejemplo. Especifique la Región de AWS para su proveedor de identidad, por ejemplo, `us-east-1`.

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region
    ```

    El siguiente ejemplo modifica el comando anterior al agregar una consulta que limita los resultados a los usuarios activos.

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'
    ```

    El conjunto de resultados es similar al siguiente ejemplo. Este ejemplo es un extracto de la salida JSON (`--output json`). Las personas que tienen nombres de usuario federados tienen un principio IDs que comienza por la palabra`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 los nombres de grupo, incluya una columna que identifique los grupos que contienen los nombres de usuario para su DDP. Esta columna debe contener los nombres de los grupos del sistema que se utilizan para conectarse desde su proveedor de identidad a Quick. Para identificar los grupos que puede agregar al conjunto de datos, utilice una o más de las siguientes operaciones rápidas de API o comandos de CLI: 
    + [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html)— Muestra los grupos rápidos por Cuenta de AWS ID y espacio de nombres para los Región de AWS que contienen su proveedor de identidad.
    + [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html)— Muestra los usuarios del grupo rápido especificado.
    + [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html)— Muestra los grupos rápidos de los que forma parte un usuario rápido.

    También puede pedir a su administrador de red que consulte a su proveedor de identidad para obtener esta información. 

Los dos procedimientos siguientes proporcionan instrucciones sobre cómo terminar de crear un conjunto de datos para valores dinámicos predeterminados. El primer procedimiento es para crear un conjunto de datos para un DDP de valor único. El segundo es para crear un conjunto de datos para un DDP de varios valores. 

**Creación de un conjunto de datos para un DDP de valor único**

1. Cree columnas de conjunto de datos con parámetros de valor único. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, la compatibilidad con los grupos solo está disponible en la edición Quick Enterprise. 

1. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de valor único, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro.

   Los parámetros de valor único solo funcionan según lo especificado si la combinación de entidad de usuario y valor predeterminado dinámico es única para el campo de ese parámetro. Si hay varios valores en un campo predeterminado para una entidad de usuario, el control de valor único para ese campo muestra el valor predeterminado estático en su lugar. Si no se define ningún valor predeterminado estático, el control no muestra ningún valor predeterminado. Tenga cuidado si utiliza nombres de grupo, porque algunos nombres de usuario pueden ser miembros de varios grupos. Si esos grupos tienen valores predeterminados diferentes, entonces este tipo de nombre de usuario funciona como una entrada duplicada. 

   El siguiente ejemplo muestra una tabla que parece contener dos parámetros de valor único. Suponemos esto porque ningún nombre de usuario está vinculado a varios valores predeterminados. Para que esta tabla sea más fácil de entender, agregamos la palabra `'default'` delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores de cada fila: Cuando lo ve `anacarolinasilva` los controles muestran una región predeterminada `NorthEast` y un segmento predeterminado `SMB`.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/parameters-default-values.html)

1. Importe estos datos a Quick y guárdelos como un conjunto de datos nuevo. 

1. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).

**Creación de un conjunto de datos para un DDP de varios valores**

1. Cree columnas de conjunto de datos con parámetros de varios valores. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, la compatibilidad con grupos solo está disponible en la edición Quick Enterprise. 

1. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de varios valores, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro. 

   A diferencia de los parámetros de valor único, los parámetros de varios valores permiten varios valores en el campo asociado al parámetro. 

   El siguiente ejemplo muestra una tabla que parece contener un parámetro de valor único y un parámetro de varios valores. Podemos suponerlo porque cada nombre de usuario tiene un valor único en una columna y algunos nombres de usuario tienen varios valores en la otra columna. Para que esta tabla sea más fácil de entender, agregamos la palabra `'default'` delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores a cada fila: Cuando `viewed-by` es `liujie`, los controles muestran un valor de `default-region` `SouthEast`, y un valor de `default-city` `Atlanta`. Y si leemos una fila más adelante, veremos que `liujie` también tiene `Raleigh` como `default-city`.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/parameters-default-values.html)

   En este ejemplo, el parámetro al que aplicamos `default-region` funciona correctamente tanto si se trata de un parámetro de un solo valor como de varios valores. Si es un parámetro de valor único, funcionan dos entradas para un usuario porque ambas entradas tienen el mismo valor, `SouthEast`. Si es un parámetro de varios valores, funciona igual, salvo que se selecciona un solo valor predeterminado. Sin embargo, si cambiamos el parámetro que utiliza `default-city` predeterminada como valor predeterminado de un parámetro de varios valores a un parámetro de valor único, no veremos seleccionados estos valores predeterminados. En su lugar, el parámetro utiliza el valor predeterminado estático, si hay alguno definido. Por ejemplo, si el valor predeterminado estático se establece en `Atlanta`, `liujie` tiene `Atlanta` seleccionada en ese control, pero no `Raleigh`. 

   En algunos casos, es posible que el valor predeterminado estático también se utilice como valor predeterminado dinámico. Si es así, asegúrese de probar el control para un nombre de usuario que no utilice un valor predeterminado que pueda ser ambos.

   Si un nombre de usuario pertenece a varios grupos, el usuario nombrado ve un conjunto de valores predeterminados que es la unión de los valores predeterminados de los dos grupos. 

1. Importe estos datos a Quick y guárdelos como un conjunto de datos nuevo. 

1. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).

Siga este procedimiento para agregar un parámetro dinámico predeterminado a su análisis. Antes de comenzar, asegúrese de que dispone de un conjunto de datos que contiene los valores predeterminados dinámicos para cada nombre de usuario o de grupo. Asegúrese también de que su análisis utiliza este conjunto de datos. Para obtener ayuda con estos requisitos, consulte los procedimientos anteriores.

**Adición de un DDP a su análisis**

1. En la consola rápida, elija el icono de **parámetros** en la parte superior de la página y elija un parámetro existente. Seleccione **Editar parámetro** en el menú del parámetro. Para agregar un nuevo parámetro, elija el signo más (`+`) cerca de **Parámetros**.

1. Elija **Establecer un valor predeterminado dinámico**.

1. Configure las siguientes opciones con sus parámetros:
   + **Conjunto de datos con valores predeterminados e información del usuario**: elija el conjunto de datos que creó y agregó a su análisis. 
   + **Columna de nombre de usuario**: para crear valores predeterminados basados en nombres de usuario, elija la columna del conjunto de datos que contiene los nombres de usuario.
   + **Columna de nombre de grupo**: para crear valores predeterminados basados en nombres de grupo, elija la columna del conjunto de datos que contiene los nombres de grupo.
   + **Columna para el valor predeterminado**: elija la columna que contiene los valores predeterminados para este parámetro.

1. Seleccione **Aplicar** para guardar los cambios de configuración y, a continuación, haga clic en **Actualizar** para guardar los cambios de los parámetros. Para salir sin guardar los cambios, elija **Cancelar**.

1. Agregue un filtro para cada campo que contenga valores predeterminados dinámicos para que los valores predeterminados funcionen. Para obtener más información sobre cómo usar filtros con parámetros, consulte [Uso de filtros con parámetros en Amazon Quick](parameters-filtering-by.md).

   Amazon Quick usa el valor predeterminado estático para cualquier persona cuyo nombre de usuario no exista en el conjunto de datos, no tenga un valor predeterminado asignado o no tenga un valor predeterminado único. Cada persona solo puede tener un conjunto de valores predeterminados. Si no desea usar valores predeterminados dinámicos, puede establecer un valor predeterminado estático en su lugar. 

# Conexión a parámetros en Amazon Quick
<a name="parameters-connections"></a>

Esta sección se utiliza para conectar un parámetro y hacer que funcione después de haberlo configurado. 

Después de crear un parámetro, puede crear consumidores de los parámetros. Los *consumidores de parámetros* son componentes que consumen el valor de un parámetro, tales como filtros, controles, campos calculados o acciones personalizadas. 

También puede desplazarse por estas opciones de la forma siguiente:
+ Para crear un filtro, selecciona el icono de **filtro** en la parte superior de la página. En resumen, debe crear un filtro con **Filtro personalizado** y habilitar **Utilizar parámetros**. La lista solo muestra los parámetros pertinentes.
+ Para añadir un control nuevo para el parámetro, seleccione el icono de **parámetros** situado en la parte superior de la página. En resumen, elija el parámetro y, a continuación, **Agregar control**. 
+ Para utilizar un parámetro en un campo calculado, edite un campo calculado existente o agregue uno nuevo eligiendo **Añadir** en la parte superior izquierda. La lista de parámetros aparece debajo de la lista de campos.
**nota**  
No es posible usar parámetros con varios valores para los campos calculados.
+ Para crear una acción de URL, elija el menú con forma de **v** en un elemento visual y, a continuación elija **Acciones de URL**.

Para obtener más información sobre cada uno de estos temas, consulte las secciones siguientes. 

**Topics**
+ [Uso de filtros con parámetros](parameters-filtering-by.md)
+ [Uso de campos calculados con parámetros](parameters-calculated-fields.md)
+ [Uso de acciones personalizadas con parámetros](parameters-custom-actions.md)
+ [Parámetros en URLs](parameters-in-a-url.md)
+ [Parámetros en títulos y descripciones](parameters-in-titles.md)

# Uso de filtros con parámetros en Amazon Quick
<a name="parameters-filtering-by"></a>

En esta sección se explica cómo filtrar los datos de un análisis o panel según el valor de un parámetro de valor único. Para utilizar un parámetro de varios valores (uno con un control desplegable multiselección), cree un filtro personalizado que sea igual (o no igual) a los valores. 

Antes de utilizar un filtro con un parámetro, debe conocer previamente cómo trabajar con filtros. 

1. Compruebe que ya se haya creado algún parámetro para el análisis. Elija **Editar** desde el parámetro o desde el menú del control para averiguar qué configuración está en uso.

1. Elija el panel **Filtro** a la izquierda de la pantalla. Si ya existe un filtro para el campo que desee utilizar, selecciónelo para abrir su configuración. De lo contrario, cree un filtro para el campo que desea filtrar según un parámetro.

1. Elija **Utilizar parámetros**.

1. Elija los parámetros en la lista o listas que aparecen debajo de **Usar parámetros**. Para los campos de texto (cadenas), elija en primer lugar **Filtro personalizado** y, a continuación, habilite **Usar parámetros**.

   Para los campos de fecha, elija los parámetros **Fecha de inicio** y **Fecha de finalización**, tal y como se muestra en la siguiente captura de pantalla. 

   Para los campos con otros tipos de datos, elija **Seleccionar un parámetro** y, a continuación, elija el parámetro en la lista. 
**nota**  
Los parámetros que pueden contener varios valores deben utilizar igual o distinto como tipo de comparación.

1. Elija **Aplicar** para guardar los cambios.

Pruebe el nuevo filtro eligiendo el control situado junto a la parte superior del análisis. En este ejemplo, utilizamos un parámetro básico que no tiene valores predeterminados y un control dinámico que está vinculado al campo **Región** del conjunto de datos de muestra denominado **Canalización de ventas**. El control consulta los datos y devuelve todos los valores. 

Si elimina o vuelve a crear un parámetro que está en uso en un filtro, puede actualizar el filtro con el nuevo parámetro. Para ello, abra el filtro, seleccione el nuevo parámetro que desea utilizar y, a continuación, elija **Aplicar**.

Si cambia el nombre de un parámetro, no es preciso actualizar el filtro ni ningún otro consumidor.

# Uso de campos calculados con parámetros en Amazon Quick
<a name="parameters-calculated-fields"></a>

Puede pasar el valor de un parámetro a un campo calculado de un análisis. Cuando crea un cálculo, puede elegir parámetros existentes de la lista de parámetros bajo **Lista de parámetros**. No puede crear un campo calculado que contenga un parámetro de varios valores, es decir, aquellos con un control desplegable multiselección.

Para la fórmula, puede utilizar cualquiera de las funciones disponibles. Puede pasar la selección del visor desde el control de parámetros, a la función `ifElse`. A cambio, obtiene una métrica. A continuación se muestra un ejemplo. 

```
ifelse(

${KPIMetric} = 'Sales',sum({Weighted Revenue}),

${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),

${KPIMetric} = '# Active', distinct_count(ActiveItem),

NULL

)
```

El ejemplo anterior crea una métrica (un decimal) que se puede utilizar en un campo. Así, cuando un usuario elige un valor del control de parámetros, el elemento visual se actualiza para reflejar su selección.

# Uso de acciones personalizadas con parámetros en Amazon Quick
<a name="parameters-custom-actions"></a>

Una *acción personalizada* le permite lanzar URLs o filtrar imágenes seleccionando un punto de datos en una imagen o eligiendo el nombre de la acción en el menú contextual. Cuando utilice una acción de dirección URL con un parámetro, podrá pasar o enviar parámetros dinámicamente a la dirección URL. Para que eso funcione, configure un parámetro y, a continuación, úselo en la dirección URL cuando cree una acción personalizada con un tipo de **acción de dirección URL**. Los parámetros de los extremos emisor y receptor deben tener el mismo nombre y tipo de datos. Todos los parámetros son compatibles con acciones de dirección URL.

Para obtener información detallada acerca de la creación de una acción de dirección URL, consulte [Creación y edición de acciones personalizadas en Amazon Quick Sight](custom-actions.md). Si solo desea utilizar un parámetro en un enlace sin crear una acción de dirección URL, consulte [Uso de parámetros en una URL](parameters-in-a-url.md).

# Uso de parámetros en una URL
<a name="parameters-in-a-url"></a>

Puede usar el nombre y el valor de un parámetro en una URL de Amazon Quick para establecer un valor predeterminado para ese parámetro en un panel o análisis. 

En el siguiente ejemplo se muestra la dirección URL de un panel que establece un parámetro para otro panel.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```

En el ejemplo anterior, la primera parte es el enlace del panel de destino: `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`. El símbolo de almohadilla (`#)` sigue a la primera parte para introducir los *fragmentos*, que contienen los valores que se desea establecer.

Los AWS servidores no reciben ni registran los valores de los fragmentos. Esta funcionalidad hace que los valores de datos estén más seguros.

El fragmento que sigue al símbolo `#` cumple las siguientes reglas: 
+ Los parámetros tienen el prefijo `p.`. Los nombres se refieren al parámetro, no al control. Puede ver el nombre del parámetro abriendo el análisis y eligiendo **Parámetro** en la barra lateral izquierda.
+ El valor se establece usando el signo igual (`=`). Se aplican las siguientes reglas:
  + Los valores literales no usan comillas. 
  + El navegador codifica automáticamente los espacios contenidos en los valores, por lo que no es necesario utilizar caracteres de escape al crear una URL manualmente. 
  + Para devolver todos los valores, establezca el parámetro igual a `"[ALL]"`.
  + Para asignar el valor del parámetro a `null`, configúrelo como igual a `%00`. Por ejemplo, `p.population=%00`.
  + En las acciones personalizadas, los nombres de los parámetros de destino comienzan por `$`. Por ejemplo: `<<$passThroughParameter>>`
  + En las acciones personalizadas, los valores de los parámetros se muestran con corchetes angulares `<< >>`, por ejemplo, `<<dashboardParameter1>>`). El usuario del panel ve el valor buscado, no la variable. 
+ Para una acción de URL personalizada, los parámetros con varios valores solo necesitan una instancia del mismo parámetro en el fragmento. Por ejemplo: `p.city=<<$city>>`
+ Para una URL directa, los distintos valores de un mismo parámetro tienen dos instancias del mismo parámetro en el fragmento. Más abajo se ofrece un ejemplo.
+ Los signos de Y comercial (`&`) separan los distintos parámetros. Más abajo se ofrece un ejemplo.

El servidor convierte la fecha a UTC y la envía al backend como una cadena sin zona horaria. Para utilizar fechas en horario universal coordinado (UTC), excluya la zona horaria. Los siguientes son algunos ejemplos de formatos de fecha que funcionan: 
+ `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
```

En el navegador, este código se convierte en lo siguiente.

```
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
```

El ejemplo anterior establece cuatro parámetros:
+ `shipDate` es un parámetro de fecha: `Sept 30, 2018`.
+ `city` es un parámetro de cadena con varios valores: `New York` y `Seattle`
+ `teamMember` es un parámetro de número entero: `12`.
+ `percentageRank` es un parámetro decimal: `2.3`.

En el siguiente ejemplo se muestra cómo establecer valores para un parámetro que acepta múltiples 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 transferir valores de un panel (o análisis) a otro en función de la selección del punto de datos del usuario, use acciones de direcciones URL personalizadas. Si lo desea, también puede generarlos URLs manualmente y usarlos para compartir una vista específica de los datos.

Para obtener más información sobre la creación de acciones personalizadas, consulte [Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md).

# Uso de parámetros en títulos y descripciones en Amazon Quick
<a name="parameters-in-titles"></a>

Al crear parámetros en Amazon Quick, puede utilizarlos en los títulos y descripciones de sus gráficos y análisis para mostrar de forma dinámica los valores de los parámetros. 

Puede utilizar parámetros en las siguientes áreas de su análisis:
+ Títulos y subtítulos de los gráficos
+ Títulos de ejes
+ Títulos de leyendas
+ Títulos de control de parámetros
+ Títulos y descripciones de hojas

En la imagen siguiente se muestra un título de gráfico que utiliza un parámetro.

![\[Imagen del panel Formato del elemento visual con un parámetro en el título del gráfico y un gráfico con el valor del parámetro en el título encerrado en un círculo rojo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/parameters-in-titles-labels2.png)


Utilice los siguientes procedimientos para obtener información sobre cómo agregar parámetros a áreas a lo largo de su análisis. Para obtener más información sobre parámetros y cómo crearlos, consulte [Parameters](parameters-in-quicksight.md).

## Adición de parámetros a títulos y subtítulos de gráficos
<a name="parameters-in-titles-chart-titles"></a>

Utilice el siguiente procedimiento para obtener información sobre cómo agregar parámetros a títulos y subtítulos de gráficos.

**Adición de un parámetro a un título o subtítulo de gráfico**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, elija la pestaña **Título**.

1. Seleccione **Mostrar título** o **Mostrar subtítulo**. Es posible que estas opciones ya estén seleccionadas.

1. Seleccione los tres puntos a la derecha de **Editar título** o **Editar subtítulo** y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título.

   Para obtener más información sobre la edición de títulos y subtítulos en elementos visuales, consulte [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md).

## Adición de parámetros a los títulos de los ejes
<a name="parameters-in-titles-axis-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de los ejes.

**Adición de un parámetro a un título de eje**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Seleccione **Mostrar título**.

1. Seleccione los tres puntos a la derecha del título predeterminado del eje y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título del eje en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título del eje.

   Para obtener más información sobre la edición de títulos de ejes, consulte [Ejes y líneas de cuadrícula](showing-hiding-axis-grid-tick.md).

## Adición de parámetros a los títulos de leyenda
<a name="parameters-in-titles-legend-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de leyenda.

**Adición de un parámetro a un título de leyenda**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, elija **Leyenda**.

1. Seleccione **Mostrar título de leyenda**.

1. Seleccione los tres puntos a la derecha de **Título de leyenda** y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título de leyenda en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título de leyenda.

   Para obtener más información sobre cómo formatear leyendas, consulte [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md).

## Adición de parámetros a los títulos de control
<a name="parameters-in-titles-control-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de control de parámetros.

**Adición de un parámetro a un título de control de parámetros**

1. Seleccione el control de parámetros que desea editar, elija los tres puntos a la derecha del título del control de parámetros y, a continuación, seleccione **Editar**.

1. En la página **Editar control** que se abre, seleccione **Mostrar título**.

1. Seleccione los tres puntos a la derecha de **Mostrar nombre** y, a continuación, seleccione un parámetro de la lista.

   El parámetro se agrega al título del control de parámetros.

   Para obtener más información sobre el uso de los controles de parámetros, consulte [Controles de parámetros](parameters-controls.md).

## Adición de parámetros a los títulos y descripciones de las hojas
<a name="parameters-in-titles-sheet-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos y descripciones de las hojas de su análisis.

**Adición de un parámetro a un título o descripción de hoja**

1. En la página de análisis, elija **Hojas** en la barra de aplicaciones y, a continuación, seleccione **Agregar título** o **Agregar descripción**.

   Aparecerá un título o descripción de hoja en la hoja.

1. En **Título de la hoja** o en **Descripción**, seleccione los tres puntos de la derecha y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título o descripción de la hoja y el valor del parámetro aparecerá en el texto cuando cierre el cuadro de texto.

   Para obtener más información sobre cómo agregar títulos y descripciones de hoja, consulte [Adición de un título y una descripción a un análisis](adding-a-title-and-description.md).

# Uso de acciones personalizadas para filtrar y navegar
<a name="quicksight-actions"></a>

Para añadir opciones interactivas para los suscriptores del panel (lectores rápidos), debe crear acciones personalizadas en uno o más elementos visuales del análisis. Mejorar los paneles con acciones personalizadas ayuda a los usuarios a explorar los datos al agregar más contexto dentro del conjunto de datos. Puede facilitar la búsqueda de detalles y nuevas perspectivas en el mismo cuadro de mando, en otro distinto o en otra aplicación. Puede agregar hasta 10 acciones personalizadas a cada elemento visual de un panel.

Antes de empezar, es útil hacer una planificación. Por ejemplo, identifique los campos que son buenos candidatos para filtrar, para abrir una hoja diferente, para abrir una URL o para enviar un correo electrónico. Para cada hoja, identifique los widgets que muestran estos campos. A continuación, decida qué widgets van a contener acciones. También es una buena idea crear un esquema de nombres para que los nombres de las acciones sean coherentes en todo el análisis. Los nombres coherentes facilitan a la persona que utiliza el análisis la comprensión de lo que hará la acción, además de facilitarle el mantenimiento de las acciones que podría estar duplicando en todo el análisis. 

Las acciones solo existen en el widget del panel en el que se crean y funcionan en el contexto de la hoja principal de ese widget y de los campos secundarios que muestra. Solo se pueden crear acciones en determinados tipos de widgets: elementos visuales e información. No se pueden agregar a otros widgets, por ejemplo, controles de filtros o listas. Las acciones personalizadas solo se pueden activar desde el widget donde las crea.

Para activar una acción, la persona que utiliza el análisis puede hacer clic con el botón izquierdo (seleccionar) o con el botón derecho (utilizar el menú contextual) en un punto de datos. Un *punto de datos* es un elemento del conjunto de datos, por ejemplo, un punto en un gráfico de líneas, una celda en una tabla dinámica, un corte en un gráfico circular, etc. Si la persona hace clic en un elemento visual, se activa la acción de *selección*. Esta es la acción que actualmente pertenece a la categoría **En selección** de las **Acciones** de un análisis. Si, por el contrario, el usuario hace clic con el botón derecho del ratón en un elemento visual, puede elegir entre una lista de acciones de *menú*. Cualquier acción de la lista es actualmente miembro de la categoría **Opción de menú** de las **Acciones** de un análisis. La categoría **En selección** puede contener una y solo una acción miembro. 

De forma predeterminada, la primera acción que se crea se convierte en la acción de selección, la que se activa al hacer clic con el botón izquierdo. Para eliminar una acción de la categoría **En selección**, cambie la configuración de **Activación** de la acción a **Opción de menú**. Después de guardar el cambio, puede establecer la **Activación** de otra acción en **Seleccionar**. 

Al configurar una acción, puede elegir entre tres **tipos de acción**:
+ **Acción de filtrado**: filtra los datos incluidos en el elemento visual o en toda la hoja. De forma predeterminada, los filtros están disponibles para todos los campos del elemento visual principal. Los filtros en cascada están activados de forma predeterminada. Las acciones de filtrado funcionan en varios conjuntos de datos mediante mapeos de campos generadas automáticamente. 

  Si el análisis utiliza más de un conjunto de datos, puede ver los mapeos de campos generadas automáticamente para los campos que existen en varios conjuntos de datos. Para ello, seleccione ****Ver asignación de campos**** al final de la configuración de la acción, mientras edita una acción. Si visualiza una lista de acciones, seleccione ****Ver asignación de campos**** en el menú de cada acción. Los mapeos de campos aparecen en una nueva pantalla que muestra el mapeo entre el conjunto de datos inicial y todos los demás conjuntos de datos del elemento visual. Si no se mapea automáticamente ningún campo, aparecerá un mensaje con un enlace al [mapeo y unión de campos](mapping-and-joining-fields.md). 

  
+ **Acciones de navegación**: permiten navegar entre diferentes hojas de un mismo análisis. 
+ **Acciones de URL**: abren un enlace a otra página web. Si desea abrir un panel diferente, utilice una acción de URL. Puede utilizar una acción de URL para enviar puntos de datos y parámetros a otras URLs personas. Puede incluir cualquier campo o parámetro disponible. 

  Si la URL utiliza el esquema `mailto`, al ejecutar la acción se abre su editor de correo electrónico predeterminado. 

**Topics**
+ [Adición de filtros interactivos con un solo clic](quick-actions.md)
+ [Creación y edición de acciones personalizadas en Amazon Quick Sight](custom-actions.md)
+ [Reparación de acciones personalizadas](repairing-custom-actions.md)
+ [Descripción del mapeo de campos para acciones personalizadas en Amazon Quick Sight](quicksight-actions-field-mapping.md)

# Adición de filtros interactivos con un solo clic
<a name="quick-actions"></a>

El *filtrado interactivo con un solo clic proporciona un point-and-click filtrado* que va desde el elemento visual en el que se puede hacer clic hasta todos los demás elementos visuales e información de una hoja. Agréguelo a su análisis para comenzar con resúmenes y profundizar en las métricas, todo dentro de la misma hoja del panel. 

Una vez configurado, al hacer clic en un punto de datos (por ejemplo, un punto de un gráfico de líneas), se filtrará al instante con todos los campos asignados de todos los demás visuales de esa hoja. Si tiene varios conjuntos de datos, se deben mapear todos los campos de destino para que esto funcione. Además, solo puede tener una acción que funcione haciendo clic en un punto de datos; todas las demás acciones funcionan desde el menú contextual. 

Utilice el procedimiento siguiente para crear un filtro con un solo clic en un análisis.

**Creación de un filtro de un clic en un elemento visual o información**

1. En su análisis, elija un elemento visual o una información al que quiera agregar un filtro interactivo. 

1. Elija **Acciones** en el menú desplegable Opciones de menú ubicado en la esquina superior derecha.

1. Seleccione **Filtrar elementos visuales de la misma hoja.** Al hacer esto se agrega inmediatamente el filtrado con un solo clic. 

1. Repita este proceso para cada elemento visual que desee hacer interactivo.

# Creación y edición de acciones personalizadas en Amazon Quick Sight
<a name="custom-actions"></a>

Puede crear una acción para cada tarea que quiera agregar a un elemento visual. Las acciones que cree pasarán a formar parte de la funcionalidad de cada elemento visual o información.

La siguiente tabla define cuándo utilizar cada tipo de acción.


|  Acción a realizar  |  Tipo de acción  | 
| --- | --- | 
|  Adición o personalización de una acción de filtrado interactiva, incluidos los filtros de un solo clic  |  Acción de filtrado  | 
|  Apertura de otra hoja en el mismo panel  |  Acción de navegación  | 
|  Apertura de una hoja en un panel diferente en la misma Cuenta de AWS  |  Acciones de URL  | 
|  Apertura de una URL (`https`, `http`)  |  Acciones de URL  | 
|  Envío de un correo electrónico (`mailto`)  |  Acciones de URL  | 

Puede establecer los siguientes atributos y opciones para una acción personalizada:
+ ****Nombre de la acción****: se trata de un nombre descriptivo que se elige para la acción. De forma predeterminada, las acciones se denominan **Action 1**, **Action 2**, y así sucesivamente. Si la acción personalizada está activada desde un menú contextual, este nombre aparece en el menú al hacer clic con el botón derecho en un punto de datos.

  Para que el nombre de la acción sea dinámico, puede parametrizarlo. Usa el icono con el signo más situado junto al encabezado del nombre de la acción para mostrar una lista de las variables disponibles. Las variables aparecen entre corchetes `<< >>`. Los parámetros llevan el prefijo `$` , por ejemplo, `<<$parameterName>>`. Los nombres de campo no tienen prefijo, por ejemplo, `<<fieldName>>`.
+ ****Activación****: las opciones disponibles son **Seleccionar** u **Opción de menú**. Para utilizar una acción, puede *seleccionar* el punto de datos (clic con el botón izquierdo) o navegar hasta la *opción de menú* en el menú contextual (clic con el botón derecho). Las acciones de navegación y las acciones de URL aparecen en el centro del menú contextual, justo encima de las opciones de **Color**. Las acciones que se activan por menú también están disponibles en la leyenda en un elemento visual.
+ ****Tipo de acción****: el tipo de acción que desea. Los ajustes específicos de un tipo de acción solo se muestran después de elegir el tipo de acción. 
  + Las opciones de configuración de la **acción de filtrado** son las siguientes: 
    + ****Alcance de filtro****: los campos que se filtrarán. Para filtrar todos los campos, elija **Todos los campos**. De lo contrario, elija **Seleccionar campos** y, a continuación, desactive los elementos que no desee filtrar. 

      El valor predeterminado es **Todos los campos**.
    + ****Elementos visuales de destino****: los widgets del panel de destino. Para aplicar el filtro a todos ellos, elija **Todos los elementos visuales**. De lo contrario, elija **Seleccionar elementos visuales** y, a continuación, desactive los elementos que no desee filtrar. Cuando una acción de filtro se aplica a otros elementos visuales, el efecto se denomina *filtros en cascada*. 

      El valor predeterminado es **Todos los elementos visuales**.

      Un filtro en cascada aplica todos los elementos visuales configurados en la sección **Elementos visuales de destino** de una acción de filtro específica. Amazon Quick Sight evalúa inicialmente sus imágenes y preconfigura los ajustes por usted. Pero puede cambiar los valores predeterminados si lo desea. Puede configurar varios filtros en cascada en varios elementos visuales de la misma hoja o análisis. Cuando utilice el análisis o el panel, puede utilizar varios filtros en cascada al mismo tiempo, aunque los active de uno en uno. 

      Una acción de filtrado requiere al menos un elemento visual de destino, porque una acción de filtro requiere un origen y un destino. Para filtrar únicamente el elemento visual actual, cree un filtro normal eligiendo **Filtro** a la izquierda.
  + Las opciones de configuración de la **acción de navegación** son las siguientes: 
    + ****Hoja de destino****: la hoja de destino. 
    + ****Parámetros****: los parámetros que se enviarán a la hoja de destino. Elija el icono con el signo más para añadir un parámetro existente. 
  + Las opciones de configuración de la **acción de URL** son las siguientes: 
    + ****URL****: la URL que se abrirá. Las acciones de URL pueden ser enlaces directos a otra aplicación. Los esquemas de URL válidos incluyen `https`, `http` y `mailto`. 
    + ****\$1** (Valores)**: (opcional) Los parámetros que se van a enviar a la URL de destino. Los nombres de los parámetros empiezan por `$`. Los parámetros de los extremos emisor y receptor deben tener el mismo nombre y tipo de datos. 
    + ****Abrir en****: dónde abrir la URL. Puede elegir **Nueva pestaña del navegador**, **Misma pestaña del navegador** o **Nueva ventana del navegador**.

Algunos tipos de acciones permiten incluir valores de parámetros o campos disponibles en el elemento visual o la información. Puede escribirlos manualmente o elegir **\$1** para seleccionarlos de una lista. Para que la acción personalizada funcione, todos los campos y parámetros a los que hace referencia deben estar en uso en el widget principal.

Utilice el procedimiento siguiente para crear, ver o editar una acción personalizada en un análisis.

**Creación, visualización o edición de una acción personalizada**

1. Con el análisis abierto, elija **Acciones** en el menú desplegable **Opciones de menú** ubicado en la esquina superior derecha. 

   Las acciones existentes, si las hay, se muestran por tipo de activación. Para activar o desactivar una acción existente, utilice la casilla situada a la derecha del nombre de la acción.

1. (Opcional) Para editar o ver una acción existente, selecciona el icono de menú situado junto al nombre de la acción. 

   Para editar la acción, elija **Editar**. 

   Para eliminarlo, elija **Eliminar**.

1. Para crear una nueva acción, seleccione una de las siguientes opciones:
   + El icono de añadir situado junto al encabezado **Acciones**
   + El botón **Definir una acción personalizada**

1. En **Nombre de la acción**, defina un nombre para la acción. Para hacer que el nombre de la acción sea dinámico, utilice el icono del signo más para añadir valores de parámetros o campos. 

1. En **Activación**, elija cómo se ejecuta la acción.

1. En **Tipo de acción**, elija el tipo de acción que desea utilizar. 

1. En una **Acción de filtrado**, haga lo siguiente: 

   1. En **Alcance de filtro**, seleccione el alcance del filtro.

   1. En **Elementos visuales de destino**, elija el alcance del filtro en cascada.

1. En una **Acción de navegación**, haga lo siguiente: 

   1. En **Hoja de destino**, elija la hoja de destino.

   1. En **Parámetros**, seleccione el icono más situado junto al encabezado **Parámetros**, seleccione un parámetro y, a continuación, elija un valor de parámetro. Puede elegir todos los valores, ingresar valores personalizados o seleccionar campos específicos.

1. En una **Acción de URL**, haga lo siguiente: 

   1. En **URL**, ingrese el hipervínculo.

   1. Seleccione el icono con el signo más situado junto al encabezado de la **URL**. A continuación, agregue variables de la lista.

   1. En **Abrir en**, elija cómo abrir la URL.

1. Cuando haya terminado con la acción, elija una de las siguientes opciones en la parte inferior del panel **Acciones** (es posible que tenga que desplazarse hacia abajo):
   + **Guardar**: permite guardar las selecciones y crear la acción personalizada.
   + **Cerrar**: cierra esta acción personalizada y descarta los cambios.
   + **Eliminar**: elimina esta acción.

# Reparación de acciones personalizadas
<a name="repairing-custom-actions"></a>

Para que una acción personalizada funcione, todos los campos y parámetros a los que hace referencia deben estar activos en el widget principal. Si falta un campo en el widget de origen, o si falta un parámetro en el análisis, la acción para ese campo o parámetro deja de estar disponible. Las acciones de menú ya no se incluyen en el menú contextual. Las acciones de selección ya no responden a los intentos de interacción. Sin embargo, en todos los demás aspectos, el widget sigue funcionando. No se muestra ningún error a los usuarios. Puede corregir las acciones de filtrado y las acciones de URL dañadas si incluye de nuevo los campos que faltan en el visual o la información dañada.

El siguiente procedimiento explica cómo arreglar una acción que se interrumpió porque alguien eliminó un campo o parámetro sin actualizar la acción. Estos pasos proporcionan una guía básica para solucionar este problema. Sin embargo, utilice su propio criterio para decidir si debe realizar cambios en el análisis. Si no estás seguro, es mejor que pidas ayuda a un administrador de Amazon Quick antes de cambiar algo. Por ejemplo, podría haber una manera de restaurar una versión anterior del análisis, lo que podría ser más seguro si no está seguro de lo que le pasó.

**Eliminación de un campo de una acción interrumpida**

1. En la página de inicio, seleccione **Análisis**. A continuación, elija el análisis a arreglar.

1. Elija el elemento visual o la información en el que la acción ya no funciona. Asegúrese de que está resaltado en la hoja.

1. Elija **Acciones** en el menú desplegable Opciones de menú ubicado en la esquina superior derecha.

1. Busca la acción que deseas corregir y selecciona **Editar**.

1. Si el tipo de acción es **Acción de filtrado** y aparece un error que indica que *se eliminó el campo utilizado por esta acción*, compruebe la configuración de **Ámbito de filtro**. Los **campos seleccionados** solo pueden mostrar campos que estén en el elemento visual. Para desactivar los campos seleccionados que se eliminan, elija una de las siguientes opciones:
   + Cambie la configuración de **Alcance del filtro** a **Todos los campos**. De este modo, el widget podrá filtrar todos los campos. 
   + Si desea utilizar una lista de **Campos seleccionados**, verifique la lista de campos. Si necesita incluir otro campo, deberá agregarlo primero al elemento visual.

1. Si el tipo de acción es **Acción de navegación**, siga las indicaciones del mensaje de error, que refleja el tipo de cambio que causó el error.

1. Si el tipo de **acción es URL**, compruebe la configuración de **URL** para las variables marcadas con corchetes angulares dobles (`<<FIELD-OR-$PARAMETER>`). Abre la lista de variables disponibles seleccionando el icono con el signo más. Elimine los campos o parámetros que no estén en la lista. Asegúrese de eliminar también el *parámetro URL* correspondiente y su espaciador (`?` para el primer parámetro URL, o `&` para los siguientes). Los siguientes ejemplos muestran (en **negrita**) qué parte se elimina si estuviera eliminando el campo llamado `Product` del elemento visual.

   ```
   https://www.example.com/examplefunction?q=<<Product>
   ```

   ```
   https://www.example.com/examplefunction?q=<<Product>&uact=<<$CSN>
   ```

   ```
   https://www.example.com/examplefunction?pass=yes&q=<<Product>+<<City>&oq=<<Product>+<<City>&uact=<<$CSN>
   ```

   Asegúrese de probar la nueva URL. 

1. (Opcional) Para eliminar la acción, desplácese hasta el final y seleccione **Eliminar**.

1. Cuando haya terminado, confirme los cambios realizados en la acción. Desplácese hasta el final del panel **Acción** y seleccione **Guardar**. 

   Si el error también existe en un panel asociado, comparta y publique de nuevo el panel para propagar la corrección.

# Descripción del mapeo de campos para acciones personalizadas en Amazon Quick Sight
<a name="quicksight-actions-field-mapping"></a>

La asignación automatizada de campos se basa en campos idénticos. Los campos con el mismo nombre y tipo de datos se mapean automáticamente a través de conjuntos de datos. Sus nombres de campo y tipos de datos deben coincidir exactamente. Esto funciona de forma similar a una unión, excepto en que se genera automáticamente en función de los nombres y tipos de datos para cada campo coincidente. Si faltan campos, puede crearlos mediante campos calculados en el conjunto de datos al que le falta un campo. Si no desea que algunos de los campos se mapeen entre sí, puede cambiarlos o eliminarlos del conjunto de datos. 

Es importante asegurarse de que todos los campos de destino estén asignados si están habilitados para su uso con una acción de filtro (en el **ámbito de filtro**). Esto permite que el filtrado se aplique automáticamente. Si no se asignan algunos campos de destino, el filtrado automático no funciona.

La asignación solo se genera cuando se crea o se guarda una acción personalizada. Así que después de cada cambio que afecte a la asignación, asegúrese de volver a ella y guardarla de nuevo. Cuando se crea una acción, la asignación se basa en los campos tal y como existen en ese punto. Al guardar una acción, permanecerán asignados todos los campos asignados cuyo nombre haya cambiado desde que creó la acción personalizada. Sin embargo, si modifica el tipo de datos de un campo asignado, la asignación se eliminará.

Si a la asignación le faltan algunos campos, puede realizar una de las siguientes acciones para solucionarla:
+ Diríjase solo a los campos asignados. Para ello, quite los campos no asignados del **ámbito de filtro**.
+ Elimine el objeto visual en cuestión de los objetos visuales de destino.
+ Cree campos calculados para proporcionar los campos que faltan para la asignación y, a continuación, guarde la acción personalizada.
+ Edite el conjunto de datos y cambie el nombre de los campos o modifique sus tipos de datos y guarde la acción personalizada.
+ Edite el conjunto de datos y cambie el nombre de los campos o modifique sus tipos de datos y vuelva a guardar la acción personalizada.

**nota**  
La información que aparece en la pantalla de asignación muestra la configuración de la última vez que la guardó. Para actualizar o actualizar la vista, vuelva a guardar la acción.

Si agrega o edita conjuntos de datos, no se mapearán ni remapearán automáticamente. Esto hará que el filtrado funcione incorrectamente. Por ejemplo, supongamos que agrega un nuevo conjunto de datos y, a continuación, crea elementos visuales para él. Los nuevos objetos visuales no responderán a las acciones de filtrado, ya que no hay ninguna asignación de campos para conectarlos. Cuando realice cambios, recuerde guardar las acciones personalizadas de nuevo para rehacer las asignaciones de campos.

Si quita un campo parametrizado o cualquier otro campo de destino del objeto visual de origen, se interrumpirá la acción que lo utilice. La acción del campo que falta no funcionará cuando seleccione un punto de datos o si está oculta en el menú contextual. 

Para obtener información sobre cómo preparar el conjunto de datos para el mapeo automático de campos, consulte [Asignación de campos](mapping-and-joining-fields.md#mapping-and-joining-fields-automatic).