Crear parámetros de informe y establecer sus propiedades
Nuevo: 17 de julio de 2006
Los parámetros de informe se definen de forma global para el informe. Se crean automáticamente si la consulta de informe incluye parámetros. También se pueden crear de forma manual. Una vez creado un parámetro de informe, es necesario establecer las propiedades que lo identifican y que controlan la forma en que se utiliza en el informe.
Para trabajar con parámetros antes de la publicación de un informe, utilice el cuadro de diálogo Parámetros del informe del Diseñador de informes. Para obtener más información, vea Cómo agregar, editar o eliminar un parámetro de informe (Diseñador de informes).
Una vez publicado el informe, puede modificar muchas de las propiedades de los parámetros de informe en el Administrador de informes o en SQL Server Management Studio. Para obtener más información acerca de la modificación de las propiedades de los parámetros y las consideraciones de seguridad, vea Establecer las propiedades de los parámetros de un informe publicado.
Parámetros de informe
Aunque los parámetros de informe se crean automáticamente para los parámetros de consulta, nunca se eliminan automáticamente cuando se elimina un parámetro de consulta.
Para abrir el cuadro de diálogo Propiedades del informe, cambie a la vista Diseño o Datos del Diseñador de informes y, en el menú Informe, seleccione Propiedades del informe. Verá una lista de parámetros de informe en el panel izquierdo. Seleccione el parámetro que desea modificar.
Nombre y tipo de datos
Los nombres de los parámetros son obligatorios y deben ser únicos en el informe. De manera predeterminada, un tipo de datos de parámetro se establece en String. También se puede seleccionar un tipo de datos diferente en la lista desplegable. Si el parámetro de informe se basa en un parámetro de consulta, asegúrese de que el tipo de datos del parámetro de informe coincide con el del parámetro de consulta. Reporting Services no detecta los tipos de datos del parámetro de consulta, así que debe ajustar el tipo de datos por sí mismo.
Los nombres deben cumplir los estándares sobre caracteres y mayúsculas y minúsculas de la especificación CLS (Common Language Specification). Para obtener más información, busque "Common Language Specification" en https://msdn.microsoft.com.
Mensaje
Por lo general, en un informe publicado, los parámetros aparecen como cuadros de texto en un área de entrada de parámetros, en la parte superior del informe. La cadena de mensaje define la etiqueta que identifica el parámetro en el área de entrada. El mensaje puede ser el nombre del parámetro o instrucciones para el usuario, por ejemplo, "Año" o "Seleccione un año". Si el mensaje se deja en blanco, pero se especifica un valor de parámetro predeterminado, se utiliza el valor predeterminado y no se muestra el cuadro de entrada del parámetro cuando el usuario ejecuta el informe. Cuando el mensaje se deja en blanco y no se especifica ningún valor de parámetro predeterminado, no puede ejecutarse el informe. Si no desea pedir los valores de los parámetros al usuario, marque los parámetros correspondientes como Oculto o Interno.
Parámetros ocultos e internos
Puede establecer opciones que controlen la visibilidad del parámetro en el informe publicado. La selección de las opciones Oculto e Interno proporciona diferentes niveles de visibilidad. Puede ocultar el parámetro en el área de entrada de parámetros del informe publicado al mismo tiempo que establece valores para ese parámetro en una dirección URL de informe o en la definición de la suscripción. Si establece un parámetro como sólo interno, no se expone de ninguna forma excepto en la definición del informe.
Parámetros de uno y varios valores
Puede definir un parámetro de varios valores si selecciona la opción Multivalor en el cuadro de diálogo Parámetros del informe. Si no se activa esta casilla, el parámetro será de un solo valor. Cuando se especifica la opción Multivalor, se agregan casillas a los valores disponibles en una lista desplegable de parámetros del informe publicado. Los usuarios pueden seleccionar los valores que deseen; por ejemplo, en el informe de ejemplo Sales Reason Comparisons, pueden seleccionar varios productos para ver sus datos de ventas combinados.
Cuando especifique los valores disponibles, puede proporcionar una lista estática de cadenas o utilizar una consulta para recuperar los valores disponibles de un origen de datos. Un parámetro de varios valores debe incluir al menos un valor. No se admiten valores NULL. La opción Seleccionar todo se crea automáticamente y sólo se muestra si hay más de un valor.
[!NOTA] En SQL Server 2005, si se utiliza un origen de datos de Analysis Services, no se debe seleccionar la opción Seleccionar todo. La opción Seleccionar todo puede mermar el rendimiento cuando se procesan consultas MDX. Si desea seleccionar todos los valores, seleccione la lista de miembros Todos.
Permitir valor en blanco
Cuando cree una lista de valores disponibles, si desea que se permita el valor <En blanco> como válido, debe incluirlo en la lista de valores válidos.
Permitir valores NULL
Permitir valores NULL es una opción para los parámetros de un solo valor. No se puede seleccionar este valor para parámetros con varios valores. Si selecciona Permitir valores NULL, permite que el parámetro tenga un valor NULL. De forma predeterminada, muchos lenguajes de consulta no devuelven valores NULL en un conjunto de resultados.
Valores disponibles
Cuando se define un parámetro de informe, es necesario definir los valores que se pueden utilizar con el informe. Estos valores se denominan valores disponibles o válidos. Las listas de valores disponibles contienen un conjunto de pares de valor y etiqueta. Cuando se ejecuta el informe, lo que el usuario ve es la etiqueta. Cuando selecciona una, se utiliza el valor correspondiente como valor del parámetro. Los valores disponibles se pueden predefinir como una lista estática o expresión, o se pueden recuperar a partir de un conjunto de datos:
- Una lista no consultada es una lista estática de pares de valor y etiqueta. La lista al completo se incluye en la definición de parámetros del informe. Cada valor y etiqueta pueden ser un valor estático o bien generarse a partir de una expresión.
- Una lista consultada hace que el servidor de informes recupere un conjunto de valores y etiquetas de un conjunto de datos cuando se ejecuta el informe. Cuando se especifica una lista de este tipo, se selecciona el conjunto de datos y los campos que se utilizarán para el valor y para la etiqueta.
Cuando se especifica una lista de valores disponibles consultada, es recomendable crear un conjunto de datos simplificado para que lo utilice específicamente el parámetro, en lugar de usar uno más complicado que utilicen también las regiones de datos del informe. El hecho de utilizar el mismo conjunto de datos tanto para la lista de valores válidos como para las regiones de datos del informe puede dar lugar a resultados imprevistos en la lista de valores válidos.
Valor predeterminado
Es posible definir un valor predeterminado para el parámetro. Si todos los parámetros de un informe tienen valores predeterminados, el informe se procesará inmediatamente cuando el usuario lo abra u obtenga una vista previa en el Diseñador de informes. Si al menos uno de los parámetros no dispone de valor predeterminado, el informe únicamente mostrará los datos cuando el usuario haya acabado de proporcionar los valores de todos los parámetros y ejecute el informe.
Puede utilizar un valor consultado o no consultado como predeterminado. Un valor predeterminado no consultado puede ser un valor estático o una expresión. Un valor predeterminado consultado es una expresión que señala a un campo de un conjunto de datos. Si la consulta devuelve varias filas, se utiliza el valor de la primera fila del conjunto de datos devuelto.
También puede optar por no especificar ningún valor predeterminado. Para ello, debe especificar un mensaje.
[!NOTA] Si utiliza un parámetro de varios valores y la consulta devuelve más de una fila, se utilizan todas las filas como predeterminadas.
Vea también
Otros recursos
Tutorial: Agregar parámetros a un informe tabular básico
Tutorial: Características avanzadas mediante el uso de parámetros
Trabajar con parámetros en Reporting Services
Parámetros del informe (Diseñador de informes)