Crear parámetros de informe y establecer sus propiedades
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, cambiar o eliminar parámetros de informe (Reporting Services).
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 ServerManagement 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
Los parámetros de informe se crean automáticamente para los parámetros de consulta al guardar una consulta de conjunto de datos, aunque también se pueden crear manualmente. Después de crear un parámetro de informe, es posible que necesite ajustar los valores predeterminados de sus propiedades para obtener la funcionalidad que desea. Por ejemplo, podría necesitar cambiar el tipo de datos, crear un conjunto de datos para proporcionar una lista de valores disponibles, crear un conjunto de datos para los valores predeterminados o establecer si los valores pueden estar en blanco o ser valores NULL.
Si desea que un parámetro permita varios valores, debe cambiar la consulta de conjunto de datos para que permita también varios valores. Para obtener más información, vea Usar parámetros de un solo valor y de varios valores. Además, si incluye un parámetro de varios valores en una expresión, necesita saber cómo debe escribir la expresión para tener acceso a los valores que desea. Para obtener más información, vea Usar referencias a la colección de parámetros en expresiones (Reporting Services).
Para crear o modificar un parámetro de informe, haga clic con el botón secundario en el nodo Parámetros del panel de datos y abra el cuadro de diálogo Propiedades de parámetro de informe.
[!NOTA]
Cuando se quita un parámetro de consulta o se cambia su nombre, no se quita ni se cambia automáticamente el parámetro de informe correspondiente. Si cambia el nombre de un parámetro de consulta, al guardar la consulta, se crea un nuevo parámetro de informe que corresponde al nombre cambiado. Puede cambiar el nombre del parámetro de informe para que coincida con el nuevo nombre del parámetro de consulta y actualizar las propiedades del parámetro de conjunto de datos para vincular el parámetro de consulta al parámetro de informe. Si quita un parámetro de consulta y no necesita el parámetro de informe correspondiente, deberá eliminarlo manualmente.
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 está basado en un parámetro de consulta, asegúrese de que el tipo de datos del parámetro de informe coincide con el tipo de datos del parámetro de consulta. Reporting Services no detecta los tipos de datos de los parámetros de consulta, motivo por el cual es el usuario quien debe realizar el ajuste de dichos tipos.
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, vea 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 solicitar al usuario valores de parámetro, seleccione 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 Interno, éste no se expone de ningún modo, excepto en la definición del informe. Un parámetro interno debe tener un valor predeterminado, que puede ser NULL si la opción Permitir valor NULL está seleccionada.
Parámetros de uno y varios valores
Puede definir un parámetro de varios valores con la opción Multivalor del 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 o usar 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 Reporting Services, 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, en el diseñador de consultas, seleccione la lista de miembros Todos de MDX.
Permitir valor en blanco
Cuando cree una lista de valores disponibles, si desea permitir el valor <En blanco> como válido, deberá 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 en parámetros de varios valores. Si selecciona Permitir valores NULL, permite que el parámetro tenga un valor NULL. De forma predeterminada, algunos 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 usa un parámetro de varios valores y la consulta devuelve más de una fila, se utilizan todas las filas para el valor predeterminado.
Vea también