Artículo
03/30/2012

Parámetros (Generador de informes 3.0 y SSRS)

Los parámetros de informe permiten controlar datos de informe, conectar entre sí informes relacionados y cambiar la presentación de los informes. Para diseñar un informe que utilice los parámetros de forma eficaz, debe entender cómo se relacionan los parámetros y las consultas de conjuntos de datos, cómo incluir los parámetros en expresiones y cómo administrar los parámetros independientemente de las definiciones de informe en el servidor de informes o en un sitio de SharePoint.

Puede crear parámetros de informe mediante las acciones siguientes:

Crear o agregar un conjunto de datos, incrustado o compartido, que tenga una consulta que contenga variables de consulta.
Crear un parámetro manualmente en el panel Datos de informe.
Agregar un elemento de informe que contenga referencias a un parámetro o a un conjunto de datos compartido que contenga variables.

Después de publicar un informe, puede administrar los parámetros independientemente de la definición de informe. Incluso puede crear varios conjuntos de parámetros para el mismo informe. Para obtener más información, vea Establecer las propiedades de los parámetros de un informe publicado y Agregar, modificar y eliminar informes vinculados.

La barra de herramientas del visor de informes muestra cada uno de los parámetros para que los usuarios puedan especificar valores de forma interactiva. En la siguiente ilustración se muestra el área de parámetros de un informe que tiene los parámetros @ StartDate, @ EndDate, @Subcategory y @ ShowAllRows.

Parámetros de la barra de herramientas del visor de informe

Panel Parámetros: la barra de herramientas del Visor de informes muestra un mensaje de petición de datos y un valor predeterminado para cada parámetro. Automáticamente se da formato al diseño de parámetro en la barra de herramientas. El orden viene determinado por el orden de aparición de los parámetros en el panel Datos de informe.
**Parámetros @StartDate y @EndDate**: el parámetro @StartDate es del tipo de datos DateTime. El mensaje de petición de datos Start Date aparece junto al cuadro de texto. Para modificar la fecha, escriba una nueva en el cuadro de texto o utilice el control de calendario.

El parámetro @EndDate aparece junto a @StartDate.
**Parámetro @Subcategory**: el parámetro @Subcategory es del tipo de datosText. Dado que el parámetro @Subcategory tiene una lista de valores disponibles, los valores válidos aparecen en una lista desplegable. Debe elegir los valores de esa lista. Dado que el parámetro @Subcategory puede tener varios valores, aparece la opción Seleccionar todo para permitirle borrar todos los valores y seleccionarlos de la lista.
**Parámetro @ShowAllRows**: el parámetro @ShowAllRows es del tipo de datos Boolean. Utilice los botones de radio para especificar True o False.
Identificador Mostrar u ocultar área de parámetros: en la barra de herramientas del Visor de informes, haga clic en esta flecha para mostrar u ocultar el panel de parámetros.
Botón Parámetros: en la vista previa del Generador de informes, en la Cinta de opciones, haga clic en el botón Parámetros para mostrar u ocultar el panel de parámetros.
Botón Ver informe: en la barra de herramientas del Visor de informes, haga clic en Ver informe para ejecutar el informe después de escribir los valores de parámetro. Si todos los parámetros poseen valores predeterminados, el informe se ejecuta automáticamente en la primera vista.

Para obtener más información sobre el uso de parámetros de forma inmediata, vea Tutorial: agregar un parámetro a un informe (Generador de informes 3.0), Tutorial: Agregar parámetros a un informe (SSRS) o el tema sobre ejemplos de informes (Generador de informes 3.0 y SSRS).

Nota

Los parámetros se pueden publicar como un elemento de informe independiente para las regiones de datos que tienen conjuntos de datos dependientes con parámetros. Aunque los parámetros se enumeren como un elemento de informe, no se puede agregar un parámetro de elemento de informe directamente a un informe. En su lugar, agregue el elemento de informe, y los parámetros de informe necesarios se generarán automáticamente a partir de las consultas de conjunto de datos contenidas en el elemento de informe o que hagan referencia a este último. Para obtener más información acerca de los elementos de informe, vea Elementos de informe (Generador de informes 3.0) y Elementos de informe en el Diseñador de informes (SSRS).

Nota

Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes 3.0 y en el Diseñador de informes en Business Intelligence Development Studio. Cada entorno de creación proporciona varias maneras de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea la información sobre el diseño de informes en el Generador de informes 3.0 y el Administrador de informes (SSRS) en el sitio web microsoft.com.

En este artículo

Usos comunes de los parámetros

Tipos de parámetros

Trabajar con parámetros de informe

Trabajar con parámetros de conjunto de datos

Parámetros en cascada

Pasar parámetros a informes detallados y a subinformes

Administrar parámetros en un servidor de informes o un sitio de SharePoint

En esta sección

Temas relacionados

Usos comunes de los parámetros

Estos son algunos de los usos más comunes de los parámetros:

Permitir a los usuarios especificar valores para personalizar los datos de un informe. Por ejemplo, para proporcionar dos parámetros para la fecha de inicio y de finalización de los datos de ventas.
Permitir a los usuarios especificar valores para ayudarles a personalizar el aspecto de un informe. Por ejemplo, proporcionar un parámetro Boolean para indicar si se expandirán o contraerán todos los grupos de filas anidadas de una tabla.
Crear una lista desplegable de valores para que los usuarios solo puedan elegir un valor válido.
Crear un valor predeterminado para cada parámetro a fin de que el informe pueda ejecutarse de forma automática en la primera vista.
Crear valores en cascada para que la lista desplegable de un parámetro sea el conjunto de valores válidos en función de la selección de un parámetro anterior. Esto le permitirá filtrar sucesivamente los valores de parámetro para reducir los miles de valores posibles a un número más fácil de manejar.
Personalizar conjuntos de parámetros para varios usuarios. Crear dos informes vinculados basados en un informe de ventas en el servidor de informes. Uno utilizará valores de parámetro predefinidos para los vendedores y el otro, para los directores de ventas. Ambos informes utilizan la misma definición de informe.
Permitir a los usuarios filtrar datos de un conjunto de datos compartido. Cuando se agrega un conjunto de datos compartido a un informe, no se puede cambiar la consulta. En el informe, podrá agregar un filtro del conjunto de datos que incluya una referencia al parámetro de informe creado por usted.

Icono de flecha usado con el vínculo Volver al principio Volver al principio

Tipos de parámetros

Los informes incluyen dos tipos de parámetros: de conjunto de datos y de informe.

Parámetro de conjunto de datos: los parámetros de conjunto de datos se crean de forma automática para los conjuntos de datos incrustados o compartidos de cada variable de consulta en el comando de consulta de conjunto de datos. Algunos diseñadores de consultas proporcionan un área para agregar filtros aplicados basados en nombres de campo y una opción para agregar parámetros de conjunto de datos basados en nombres de campo.

Los parámetros de conjunto de datos se configuran una vez definida la consulta de conjunto de datos. Puede especificar valores predeterminados independientemente para cada parámetro de conjunto de datos. Cuando se agrega un conjunto de datos compartido a un informe, los parámetros de conjunto de datos que están marcados como internos no se pueden invalidar en el informe. Podrá invalidar parámetros de conjunto de datos que no estén marcados como internos. También podrá crear parámetros adicionales. Para obtener más información, vea Trabajar con parámetros de conjunto de datos en este tema.
Parámetro de informe: para cada parámetro de conjunto de datos se crea de forma automática un parámetro de informe. También puede crear parámetros de informe de forma manual. Puede configurar parámetros de informe para que un usuario pueda especificar de forma interactiva valores que le permitan a personalizar el contenido o el aspecto de un informe. También puede configurar parámetros de informe para que un usuario no pueda cambiar los valores preconfigurados. Los parámetros de informe se administran independientemente de los informes publicados en el servidor de informes. Para obtener más información, vea Trabajar con parámetros de informe en este tema.

También puede guardar parámetros de informe independientemente de los informes como una parte de los mismos. Las partes del informe se almacenan en el servidor de informes y están disponibles para que otros usuarios las utilicen en sus informes. Las partes del informe que representan parámetros no se pueden administrar en el servidor de informes. Puede buscar los parámetros en la galería de partes de informe y una vez agregados, configurarlos en su informe. Para obtener más información, vea Elementos de informe (Generador de informes 3.0).

En la mayoría de las ocasiones, trabajará con parámetros de informe.

Icono de flecha usado con el vínculo Volver al principio Volver al principio

Trabajar con parámetros de informe

El uso más habitual de los parámetros es modificar los datos de informe recuperados por las consultas de conjuntos de datos. En este escenario, cuando los usuarios ejecutan el informe, se les solicita uno o varios valores y la consulta de conjunto de datos recupera solamente los datos solicitados. La consulta de conjunto de datos incluye parámetros de consulta y el procesador de informes crea automáticamente parámetros de informe que se vinculan indirectamente a dichos parámetros de consulta.

De forma predeterminada, los parámetros creados automáticamente utilizan un nombre, un indicador y un tipo de datos generados automáticamente. Puede cambiar las propiedades de los parámetros de informe en el panel Datos de informe mediante el cuadro de diálogo Propiedades del informe. En la siguiente tabla se resumen las propiedades que se pueden establecer para cada parámetro:

Propiedad	Descripción
Nombre	Escriba un nombre de parámetro con distinción de mayúsculas y minúsculas. El nombre debe comenzar por una letra y estar compuesto de letras, números y caracteres de subrayado (_); además, no debe contener espacios. En el caso de los parámetros generados automáticamente, el nombre coincide con el parámetro de consulta de la consulta del conjunto de datos. De forma predeterminada, los parámetros creados manualmente deben similares a ReportParameter1.
Pedir datos	El texto que aparece junto al parámetro en la barra de herramientas del Visor de informes.
Tipo de datos	Un parámetro de informes debe ser de uno de los siguientes tipos de datos: Text, Integer, Float, DateTime, Boolean. El tipo de datos determina la manera en que un parámetro de informe aparece en la barra de herramientas del Visor de informes. El tipo de datos también puede ser importante al escribir expresiones que incluyan una referencia al parámetro.
Permitir valor en blanco	Seleccione esta opción si el valor del parámetro puede ser una cadena vacía o estar en blanco. Si especifica los valores válidos de un parámetro, y desea que el valor en blanco sea uno de ellos, deberá incluirlo como uno de los valores que especifique. La selección de esta opción no incluye automáticamente el espacio en blanco entre los valores disponibles.
Permitir valor NULL	Seleccione esta opción si el valor del parámetro puede ser un valor NULL. Si especifica los valores válidos de un parámetro, y desea que el valor NULL sea uno de ellos, deberá incluirlo como uno de los valores que especifique. La selección de esta opción no incluye automáticamente NULL entre los valores disponibles.
Permitir varios valores	Proporcione los valores disponibles para crear una lista desplegable que permita realizar selecciones a los usuarios. Esta es una buena forma de asegurarse de que solo se enviarán valores válidos en una consulta de conjunto de datos. Seleccione esta opción si el valor del parámetro puede ser varios valores que se muestran en una lista desplegable. No se admiten valores NULL. Cuando esta opción está seleccionada, se agregan casillas a la lista de valores disponibles en una lista desplegable de parámetros. La parte superior de la lista incluye una casilla para Seleccionar todo. Los usuarios pueden activar los valores que desean usar. Si los datos que proporcionan valores cambian rápidamente, podría darse el caso de que la lista que ve el usuario no sea la más actualizada.
Visible	Seleccione esta opción si desea mostrar el parámetro de informe en la parte superior del informe al ejecutarse éste. Esta opción permite a los usuarios seleccionar los valores de los parámetros en tiempo de ejecución.
Oculto	Seleccione esta opción si desea ocultar el parámetro de informe en el informe. Los valores del parámetro de informe pueden establecerse en una dirección URL de informe, en una definición de suscripción o en el servidor de informes usando el Administrador de informes.
Interno	Seleccione esta opción para ocultar el parámetro de informe. El parámetro de informe solo se puede ver en la definición de informe.
Valores disponibles	Si ha especificado los valores disponibles de un parámetro, los valores válidos aparecerán siempre como una lista desplegable. Por ejemplo, si proporciona los valores disponibles para un parámetro DateTime, aparecerá una lista desplegable para las fechas en el panel de parámetros en lugar de un control de calendario. Para asegurarse de que exista una lista de valores coherente entre un informe y los subinformes, puede establecer una opción en el origen de datos para utilizar una transacción única para todas las consultas de los conjuntos de datos que estén asociadas a un origen de datos. Nota de seguridad En cualquier informe que incluya un parámetro del tipo de datos Text, asegúrese de utilizar una lista de valores disponibles (que también recibe el nombre de lista de valores válidos) y de que los usuarios que ejecuten el informe solamente dispongan de los permisos necesarios para ver los datos del informe. Para obtener más información, vea Seguridad (Generador de informes 3.0).
Valores predeterminados	Establezca los valores predeterminados a partir de una consulta o de una lista estática. Los informes se ejecutan de forma automática en la primera vista cuando cada parámetro de informe tiene un valor predeterminado.
Opciones avanzadas	Establezca un valor que indique si este parámetro afecta directa o indirectamente a los datos de un informe. En el servidor de informes, este valor se utiliza para determinar las opciones de memoria caché de los informes y los datos de los informes. Para obtener más información, vea Propiedades de parámetro de informe (cuadro de diálogo), Avanzadas (Generador de informes 3.0).

Icono de flecha usado con el vínculo Volver al principio Volver al principio

Trabajar con parámetros de conjunto de datos

Los parámetros de consulta deben definirse al crear una consulta en un diseñador de consultas. Algunas extensiones de datos proporcionan una manera de seleccionar los campos que se incluirán como parámetros. Otras extensiones de datos identifican las variables de consulta del comando de consulta. Se crea automáticamente un parámetro de consulta para cada variable de consulta.

No todos los orígenes de datos son compatibles con los parámetros de consulta. En esas ocasiones en las que no es posible filtrar los datos en el origen, puede usar parámetros de informe para proporcionar a los usuarios la capacidad de filtrar los datos después de haberlos recuperado para el informe. Aunque todos los parámetros de consulta tienen sus correspondientes parámetros de informe, podrá definir parámetros de informe de forma independiente. Los parámetros de informe también se pueden usar para cambiar el aspecto o la organización de un informe una vez recuperados los datos.

Para filtrar los datos en la consulta de conjunto de datos, puede incluir una cláusula de restricción que limite los datos recuperados; para ello, deberá especificar los valores que se van a incluir o excluir del conjunto de resultados.

Use el diseñador de consultas asociado a un origen de datos para generar una consulta con parámetros.

En las consultas de Transact-SQL, cada origen de datos es compatible con una sintaxis para parámetros diferente. La compatibilidad varía para los parámetros que se identifican en la consulta por su posición o los que se identifican por su nombre. Para obtener más información, vea los temas relativos a tipos de orígenes de datos externos concretos en Agregar datos a un informe (Generador de informes 3.0 y SSRS). En el diseñador de consultas relacional, debe seleccionar la opción de parámetro de un filtro para crear una consulta parametrizada. Para obtener más información, vea Interfaz de usuario del Diseñador de consultas relacionales (Generador de informes 3.0).
En las consultas basadas en un origen de datos multidimensionales, como Microsoft SQL Server Analysis Services, SAP NetWeaver BI o Hyperion Essbase, podrá especificar si desea crear un parámetro en función del filtro que haya especificado en el diseñador de consultas. Para obtener más información, consulte el tema del diseñador de consultas en Diseñadores de consultas (Generador de informes 3.0) que corresponda a la extensión de datos.

Icono de flecha usado con el vínculo Volver al principio Volver al principio

Parámetros en cascada

Puede crear parámetros en cascada, donde el usuario elige un valor para cada parámetro en un orden concreto, y cada opción limita los valores del parámetro siguiente. Los parámetros en cascada pueden reducir potencialmente miles de opciones a un número más fácil de administrar. Por ejemplo, un usuario elige una categoría de producto; a continuación, elige un producto en la lista de productos disponibles en esa categoría; después, elige un tamaño y, por último, un color.

Para obtener más información, vea Agregar parámetros en cascada a un informe (Generador de informes 3.0 y SSRS).

Icono de flecha usado con el vínculo Volver al principio Volver al principio

Pasar parámetros a informes detallados y subinformes

Los parámetros se usan para conectar informes a subinformes y a informes detallados. Los parámetros de informe se pueden ocultar mediante el uso de valores del informe principal para seleccionar los datos adecuados, o se pueden dejar visibles en tiempo de ejecución.

Para obtener más información, vea Usar parámetros para conectarse a otros informes (Generador de informes 3.0 y SSRS).

Administrar parámetros en un servidor de informes o en un sitio de SharePoint

Una vez publicado un informe, los parámetros se pueden administrar al margen de la definición de informe. Según la forma en que configure el parámetro del informe durante la fase de diseño, los administradores del servidor de informes podrán modificar muchas propiedades de los parámetros de un informe o de un conjunto de datos compartido. Si está diseñando un informe que piensa programar para el almacenamiento en memoria caché o las suscripciones, es posible que existan requisitos adicionales aplicables a los parámetros. Para obtener más información, vea los temas siguientes en la documentación de Reporting Services en los Libros en pantalla de SQL Server.

Informes almacenados en caché: para crear un plan de memoria caché para un informe, cada parámetro debe tener un valor predeterminado. Para obtener más información, vea Almacenamiento en memoria caché de informes en Reporting Services.
Conjuntos de datos compartidos almacenados en caché: para crear un plan de memoria caché para un conjunto de datos compartido, cada parámetro debe tener un valor predeterminado. Para obtener más información, vea Almacenamiento en memoria caché de informes en Reporting Services.
Informes vinculados: puede crear informes vinculados con valores de parámetro preestablecidos para filtrar datos para los distintos destinatarios. Para obtener más información, vea Agregar, modificar y eliminar informes vinculados.
Suscripciones de informes: puede especificar valores de parámetro para filtrar datos y entregar informes mediante suscripciones. Para obtener más información, vea Establecer parámetros en una suscripción y Suscripción y entrega (Reporting Services).
Acceso URL: puede especificar valores de parámetro en una dirección URL a un informe. También puede ejecutar informes y especificar valores de parámetro mediante el acceso desde una dirección URL. Para obtener más información, vea Acceso URL.