Usar parámetros para controlar los datos de los informes
Nuevo: 17 de julio de 2006
Se pueden utilizar parámetros para controlar los datos que se recuperan de un origen de datos cuando se procesa un informe, así como para filtrar los datos una vez obtenidos. Se recomienda limitar los datos que se recuperan del origen de datos a los que sean estrictamente necesarios para el informe. No obstante, cuando se utilizan procedimientos almacenados para recuperar datos, no se puede controlar lo que se recupera de la consulta, por lo que es necesario filtrar los datos del informe una vez recuperados.
Filtrar datos en el origen de datos
Los parámetros de consulta permiten especificar exactamente los datos que se desean recuperar del origen de datos. Permiten filtrar datos en el servidor antes de enviarlos al informe.
Cuando se define un conjunto de datos con una consulta que incluye variables, el diseñador de consultas de Reporting Services crea un parámetro de consulta para cada variable. Se crea el parámetro de informe correspondiente para cada parámetro de consulta a fin de que los usuarios o los autores de informes puedan seleccionar valores para los parámetros de informe y pasarlos en la consulta al origen de datos.
Parámetros de consulta
Los parámetros de consulta se definen como parte de la definición de consulta de un conjunto de datos. Puesto que cada conjunto de datos de informe define una sola consulta, los parámetros de consulta se definen como propiedades en el conjunto de datos.
Cuando se define un conjunto de datos, se especifica un tipo determinado de origen de datos, por ejemplo Microsoft SQL Server. El Diseñador de informes abre un diseñador de consultas diseñado para funcionar con ese tipo de origen de datos o el diseñador de consultas genérico que funciona con cualquier tipo de origen de datos. Cuando se define la consulta para ese origen de datos, el diseñador de consultas identifica variables en el texto de comando de consulta y crea un parámetro de consulta para cada uno. Para obtener más información acerca de la sintaxis de consulta esperada por el origen de datos, vea Usar parámetros de consulta con orígenes de datos específicos.
En el caso de los orígenes de datos de SQL Server, las consultas suelen incluir variables en la cláusula WHERE de una instrucción Transact-SQL para limitar los datos devueltos cuando se ejecuta una consulta. De forma similar, una consulta de origen de datos de Analysis Services suele incluir variables MDX utilizadas en una cláusula FILTER. Las consultas también pueden incluir variables pasadas como entradas a procedimientos almacenados o funciones definidas por el usuario.
Cada vez que se modifica la consulta de un conjunto de datos, se vuelve a procesar la consulta. Si se modifica una consulta al quitar una variable o cambirle el nombre, los parámetros de consulta reflejarán esos cambios. Sólo las variables que existan en el texto de comando de consulta serán parámetros de consulta en la definición de consulta del conjunto de datos.
El valor predeterminado de cada parámetro de consulta se establece en una expresión que devuelve el parámetro de informe correspondiente. Este enlace de parámetros se define en la ficha Parámetros de las propiedades de conjuntos de datos. Por ejemplo, en un origen de datos de SQL Server, si el parámetro de consulta es @MyParameter, el parámetro de informe será MyParameter y el valor de @MyParameter será la expresión =Parameters!MyParameter.Value. Para obtener más información, vea Conjunto de datos (ficha Parámetros del Diseñador de informes). Se pueden editar los parámetros de consulta y establecer sus valores predeterminados de forma manual. Para obtener más información, vea Cómo asociar un parámetro de consulta a un parámetro de informe (Diseñador de informes).
[!NOTA] Cuando se quita o cambia el nombre de un parámetro de consulta, no se quita ni se cambia automáticamente el parámetro de informe correspondiente.
Parámetros de informe
En el Diseñador de informes, se crean automáticamente los parámetros de informe cuando se define una consulta de conjunto de datos que incluye variables. En el Generador de informes, los parámetros de informe se crean automáticamente cuando se establece un símbolo del sistema en una cláusula de filtro. También se pueden crear parámetros de informe que no están enlazados a parámetros de consulta de forma manual en el cuadro de diálogo Parámetros del informe.
- El tipo de datos de los parámetros de consulta y otras propiedades de parámetros de informe afectan a la presentación del parámetro en la barra de herramientas del informe. Según el tipo de datos del parámetro, se pueden establecer propiedades de parámetros de informe mediante botones de opción, cuadros de texto, listas desplegables, controles de calendario o varias casillas.
- Los parámetros de informe pueden tener uno o varios valores. Los parámetros de varios valores permiten a los usuarios seleccionar más de un valor para el parámetro.
- Un parámetro de informe puede depender de otro. El orden de los parámetros de informe es importante. Los parámetros situados más adelante en la lista pueden depender de parámetros anteriores. Esto permite definir un conjunto de parámetros, denominados parámetros en cascada, donde la lista de valores de uno de ellos dependa del valor seleccionado en otro parámetro.
- Los parámetros de informe se pueden utilizar en las expresiones. Las expresiones que incluyen parámetros se pueden utilizar en todos los casos en los que se puede emplear una expresión. Cuando se ejecuta el informe, se sustituye el valor de cada parámetro en la expresión. De este modo, las selecciones de parámetros del usuario pueden controlar condicionalmente un gran número de elementos del aspecto y el contenido de un informe, incluido ocultar filas y columnas, ordenar y filtrar datos y manipular datos NULL.
Los parámetros de informe forman parte de una definición de informe cuando se crea un informe, pero se pueden administrar de forma independiente después de publicar un informe. En la vista Diseño o Datos del Diseñador de informes, se pueden editar los parámetros definidos para el informe. Para obtener más información, vea Cómo agregar, editar o eliminar un parámetro de informe (Diseñador de informes). Una vez publicada la definición de informe, se pueden modificar las propiedades de los parámetros mediante el Administrador de informes. Para obtener más información, vea Establecer las propiedades de los parámetros de un informe publicado.
Modificar rápidamente los valores válidos de un parámetro
Cuando se especifican valores disponibles que cambian con rapidez, los valores pueden llegar a ser obsoletos incluso antes de que se ejecute el informe. Esta situación puede dar lugar a que el usuario seleccione un valor de la lista que haya dejado de ser válido para cuando el usuario lo envíe y ejecute el informe. Para evitarlo, escriba consultas que devuelvan conjuntos de datos para listas de valores válidos que no cambien durante el tiempo que un usuario tarda en seleccionar un valor y ejecutar el informe.
Evite también los valores no consultados que cambian con rapidez. Por ejemplo, si proporciona la fecha actual como un valor disponible, escriba una expresión que utilice la propiedad DateTime.Today en lugar de DateTime.Now. De esta forma, se elimina la parte temporal de cambio rápido del valor.
Filtrar datos de informe
Se pueden filtrar datos de informe una vez obtenidos del origen de datos al definir una expresión de filtro en un conjunto de datos que incluya una referencia a parámetros. De este modo, cuando la persona que lee el informe selecciona valores para un parámetro, cuando se procesa el informe, sólo se muestran en el informe los datos filtrados.
Vea también
Tareas
Cómo asociar un parámetro de consulta a un parámetro de informe (Diseñador de informes)
Conceptos
Definir conjuntos de datos de informe
Otros recursos
Tutorial: Agregar parámetros a un informe tabular básico
Tutorial: Características avanzadas mediante el uso de parámetros
Definir orígenes de datos de informe
Vista de datos (Diseñador de informes)