Gestión de los parámetros de consulta

Con los parámetros, puede solicitar valores para utilizar con los filtros o cálculos de una consulta cada vez que se ejecute. Al establecer estos valores en tiempo de ejecución, puede utilizar una consulta en un contexto diferente -como cuenta, región o Periodo de tiempo- cada vez que se ejecute.

Puede crear parámetros personalizados para utilizarlos con una consulta específica, o el propietario de su espacio de trabajo puede crear parámetros globales para utilizarlos con varias consultas.

Crear parámetros personalizados para una consulta

Puede configurar los parámetros de una consulta en el Constructor o en el Editor SQL. Al crear un parámetro, puede utilizarlo con varios filtros y cálculos en la consulta. 

Etapa 1. Crear el parámetro

1. En el panel Parámetros , haga clic en Agregar, y seleccione Crear nuevo parámetro.
   
<!--
2. From the Parameters panel, click Create Parameter.
   
-->
3. Para ayudar a identificar el parámetro, introduzca un nombre único con sólo caracteres alfanuméricos y Ninguno espacios.
4. En Tipo de Filtros, seleccione el tipo de datos por el que desea filtrar, como Texto o Entero.

Etapa 2. Configure los valores de los parámetros

Cuando se ejecuta una consulta, sus parámetros pueden aceptar valores de forma libre -basados en el tipo de datos- o proporcionar una lista de valores específicos entre los que elegir. 

• Para aceptar cualquier valor de forma libre, introduzca el valor por defecto (si procede) y haga clic en Crear.
• Lista de valores específicos:

1. Habilitar Lista de selección.
2. Para Habilitar múltiples valores para el parámetro, marque la casilla Multi-Select .
3. En Opciones de Listas, introduzca los valores a elegir, pulsando Entrar después de cada uno.

   Nota: Para un parámetro de fecha o marca de tiempo, introduzca cada opción en el formato AAAA-MM-dd .

4. Seleccione cualquier valor por defecto para el parámetro y haga clic en Aceptar.

   Nota: Para un parámetro de selección múltiple , seleccione al menos un valor por defecto.

5. Haga clic en Crear para finalizar.

Etapa 3. Utilice el parámetro en la consulta

Para aplicar el valor del parámetro a la consulta, utilícelo en un filtro o cálculo:

• Para establecer el valor de un filtro basado en el parámetro en el Constructor, selecciónelo cuando defina el filtro desde el panel Propiedades del filtro Derecha.

  Nota: Para un parámetro de selección múltiple , seleccione un operador de filtro de Está en Lista o No Está en Lista en la pestaña Filtros .

• Para utilizar el parámetro con un filtro en el Editor SQL o referenciar su valor en un cálculo, introduzca su nombre después de dos puntos (:) en la sentencia SQL, como :ReportingPeriod.

Utilizar parámetros globales en una consulta

El propietario de su espacio de trabajo puede configurar parámetros globales para valores comunes utilizados con varias consultas. Para utilizar parámetros globales en una consulta:

1. En el panel Parámetros , haga clic en Agregar, y seleccione Seleccionar parámetro global.
   
2. Seleccione los parámetros globales que desea utilizar en la consulta y haga clic en Agregar.
3. Para editar el parámetro global, selecciónelo y actualice su nombre o valor según sea necesario para la consulta.

   Nota: Para garantizar un análisis coherente, el propietario del espacio de trabajo puede bloquear un parámetro global para impedir que se edite su valor.

4. Para aplicar el valor de un parámetro global a la consulta, utilícelo en un filtro o cálculo:

   • Para establecer el valor de un filtro basado en el parámetro en el Constructor, selecciónelo cuando defina el filtro desde el panel Propiedades del filtro Derecha.

     Nota: Para un parámetro de selección múltiple , seleccione un operador de filtro de Está en Lista o No Está en Lista en la pestaña Filtros .

   • Para hacer referencia al parámetro en el Editor SQL, introduzca su nombre después de dos puntos (:) en la sentencia SQL, como :ReportingPeriod.
   • Para hacer referencia al valor de un parámetro en una sentencia SQL de un cálculo, seleccione el parámetro en el menú Parámetros .

Editar un parámetro de consulta

Para ajustar o gestionar los detalles de un parámetro:

1. En el panel Parameters , seleccione el parámetro que desea editar.
2. Edite el nombre del parámetro, el Tipo de datos o los valores según sea necesario.
3. Haz clic en Aplicar.

Quitar un parámetro de consulta

Si ya no necesita un parámetro, puede Quitarlo de la consulta. En el panel Parámetros , haga clic en el parámetro Eliminar , y haga clic en Guardar .