Compartir a través de


Ejecutar un informe con parámetros

Un informe con parámetros es un informe que usa 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 Parámetros (Generador de informes 3.0 y SSRS). 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 hospedar 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 usar 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 solamente 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 usa 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 elegir.

Para establecer las propiedades de parámetro (incluso los valores predeterminados) en un informe publicado, use Administrador de informes. Para obtener más información, vea Parámetros (Generador de informes 3.0 y SSRS) 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&region=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&region=east&region=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 Utilizar parámetros de acceso URL.