Ejecutar un informe con parámetros
Actualizado: 17 de julio de 2006
Un informe con parámetros es un informe que utiliza valores de entrada para completar su procesamiento. Algunos ejemplos familiares de informes con parámetros son aquéllos que filtran por valores regionales, categorías de productos o identificadores. Los parámetros suelen utilizarse para completar una consulta que selecciona datos del informe. Si administra o ejecuta un informe con parámetros, es importante que comprenda de qué modo inciden las selecciones de los parámetros en el informe con el que trabaja.
[!NOTA] El autor del informe es quien define los parámetros que se utilizarán en un informe. Una vez publicado el informe, es posible modificar algunas propiedades de los parámetros para cambiar los valores que se utilizarán y cómo se obtendrán. Para obtener más información acerca de la creación de parámetros, vea Trabajar con parámetros en Reporting Services. Para obtener más información acerca de la administración de parámetros, vea Establecer las propiedades de los parámetros de un informe publicado.
Almacenar y solicitar valores de parámetro
Para obtener un valor de parámetro en tiempo de ejecución, puede almacenar un valor predeterminado junto con el informe o bien solicitar al usuario que escriba o seleccione un valor. Almacenar un valor de parámetro junto con el informe resulta útil si desea que el informe se procese siempre con un valor concreto. Por ejemplo, imagine una oficina regional que cuente con un sitio Web dedicado. En estas circunstancias, podría alojar en el sitio Web un informe de ventas regional que utilizara siempre un código de región específico.
También puede solicitar a los usuarios que escriban o seleccionen el valor que deseen utilizar cuando abran el informe. Si se configura un informe para que solicite valores de parámetro, también se incluirán campos de entrada para que el usuario pueda escribir los valores específicos. Después de escribir los valores, el usuario sólo tiene que hacer clic en Ver informe para ejecutarlo. El informe se mostrará si los valores son válidos. Si no lo son, aparecerá un mensaje de error o un informe vacío. Si utiliza valores de parámetro almacenados, el informe se abrirá sin mostrar campos de entrada ni tampoco el botón Ver informe. Todos los usuarios que ejecuten el informe utilizarán el mismo valor de parámetro.
Si el informe incluye parámetros basados en consultas, y el origen de datos requiere que cada usuario inicie la sesión, el sistema lle solicitará al usuario que indique sus credenciales antes de mostrar en la página los campos de entrada de parámetros. En este caso, es imprescindible proporcionar las credenciales para recuperar los valores de parámetro.
Para ejecutar un informe con parámetros, por lo general debe conocer los valores que se deben escribir. Un informe puede incluir listas desplegables de valores válidos que se pueden seleccionar.
Utilice el Administrador de informes o SQL Server Management Studio para establecer las propiedades de los parámetros (incluidos los valores predeterminados) de un informe publicado. Para obtener más información, vea Crear parámetros de informe y establecer sus propiedades y Establecer parámetros en una suscripción.
Establecer los parámetros de la dirección URL de un informe
Otra forma de ejecutar un informe con parámetros es a través de una dirección URL. Puede especificar uno o varios parámetros en pares codificados de nombre-valor, utilizando el carácter (&) para separarlos.
Los parámetros con valor NULL utilizan una sintaxis especial y debe especificarse isnull para este tipo de valores. Si especifica un valor NULL para un parámetro, todos los demás valores especificados para ese mismo parámetro se omiten. El siguiente ejemplo muestra varios parámetros de valores NULL y constantes:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder®ion=west&sales:isnull=true
Los parámetros con varios valores se especifican mediante la repetición del nombre del parámetro. Por ejemplo:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders®ion=east®ion=west
Los parámetros Boolean se especifican con un valor 0 o 1.
Los parámetros Float deben incluir el separador decimal correspondiente a la configuración regional del servidor.
Los parámetros de DateTime deben especificarse con el formato YYYY-MM-DDTHH:MM:SS, basado en el estándar 8601 de la Organización internacional de normalización (ISO). Para obtener más información sobre cómo establecer parámetros en una dirección URL, vea Using URL Access Parameters.
Historial de cambios
| Versión | Historial |
|---|---|
17 de julio de 2006 |
|
Vea también
Tareas
Cómo abrir y cerrar un informe (Administrador de informes)
Cómo abrir y cerrar un informe (Management Studio)
Conceptos
Establecer las propiedades de los parámetros de un informe publicado
Informes con parámetros
Ver informes
Buscar y ver informes en el Administrador de informes
Otros recursos
Administrar y trabajar con informes publicados