Gestión de 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 establecer los parámetros de una consulta tanto en el Constructor como en el Editor SQL. Al crear un parámetro, puede utilizarlo con varios filtros y cálculos en la consulta. 

Paso 1. Crear el parámetro Crear el parámetro

1. En el panel Parámetros , haga clic en Añadir
   , y seleccione Crear nuevo parámetro.
2. Para ayudar a identificar el parámetro, introduzca un nombre único con sólo caracteres alfanuméricos y sin espacios.
3. En Tipo de filtro, seleccione el tipo de datos por el que desea filtrar, como Texto o Entero.

Paso 2. Configurar los valores de los parámetros Establezca los valores de los parámetros

Cuando se ejecuta una consulta, sus parámetros pueden aceptar valores de forma libre -según 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 predeterminado (si procede) y haga clic en Crear.
• Para proporcionar una lista de valores específicos:

1. Activar Lista de selección.
2. Para habilitar valores múltiples para el parámetro, marque la casilla Multi-Select .
3. En Opciones de la lista, introduzca los valores a elegir, pulsando Intro después de cada uno. Nota: Para un parámetro de fecha o fecha-hora, 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.

Paso 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 basándose en el parámetro en Builder, selecciónelo cuando defina el filtro desde el panel derecho Propiedades del filtro. Nota: Para un parámetro de selección múltiple, seleccione un operador de filtro de Está en la lista o No está en la 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 múltiples consultas. Para utilizar parámetros globales en una consulta:

1. En el panel Parámetros, haga clic en Añadir, y seleccione Seleccionar parámetro global.
   
2. Seleccione los parámetros globales que desea utilizar en la consulta y haga clic en Añadir.
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 Builder, selecciónelo cuando defina el filtro desde el panel derecho Propiedades del filtro. Nota: Para un parámetro de selección múltiple, seleccione un operador de filtro de Está en la lista o No está en la 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 la 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, el tipo de datos o los valores del parámetro según sea necesario.
3. Haz clic en Aplicar.

Eliminar un parámetro de consulta

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