Trabajar con parámetros en Reporting Services

Actualizado: 17 de julio de 2006

En Reporting Services, los parámetros se utilizan para especificar los datos que se emplearán en un informe, conectar informes relacionados y cambiar la presentación de éstos. En un informe existen dos tipos de parámetros: de consulta y de informe.

• Cuando se define una consulta de conjunto de datos que incluye variables, Reporting Services crea los parámetros de consulta correspondientes. Los parámetros de consulta se utilizan para limitar los datos recuperados del origen de datos a tan solo los necesarios para el informe.
• Los parámetros de informe aparecen en la barra de herramientas del informe y permiten a sus lectores seleccionar o escribir valores que se utilizarán cuando se procese éste. En el Diseñador de informes, los parámetros de informe se crean automáticamente a partir de los parámetros de consulta. En el Generador de informes, los parámetros de informe se crean cuando se establece un mensaje en una cláusula de filtro. También es posible definir parámetros de informe que no estén vinculados a parámetros de consulta. En las expresiones, es posible incluir referencias a parámetros de informe mediante la colección global Parameters. Puesto que las expresiones se pueden utilizar durante la definición de un informe a fin de controlar su contenido o aspecto, los parámetros de informe constituyen una forma eficaz de personalizar un informe.

En la lista siguiente se resumen brevemente los aspectos principales de los parámetros y la forma en que se utilizan en Reporting Services:

• Los parámetros de informe son procesados por el servidor de informes, mientras que los parámetros de consulta se procesan en el servidor de orígenes de datos.
• Cada valor de parámetro de consulta se asigna de forma predeterminada al valor correspondiente de parámetro de informe. Esto permite a los usuarios seleccionar valores para los parámetros de informe y pasarlos a la consulta a fin de limitar los datos recuperados del origen de datos.
• Los parámetros de informe que no están enlazados a parámetros de consulta se utilizan para cambiar la presentación, filtrar datos, controlar la agrupación y la ordenación y modificar las propiedades de los cuadros de texto. Para ello, se escriben expresiones que incluyen parámetros. Cuando se procesa el informe, las expresiones se evalúan mediante la configuración de parámetros actual. De este modo, es posible utilizar los parámetros de informe para influir en cualquier aspecto de un informe que permita especificar una expresión.
• Es posible establecer propiedades de parámetros de informe que determinen si los parámetros son de uno o varios valores, si son visibles en tiempo de ejecución, si utilizan una lista de valores válidos estáticos o basados en consulta, si tienen valores predeterminados o si admiten valores nulos o en blanco. Los parámetros de varios valores permiten seleccionar más de un valor.
• Es posible crear parámetros en cascada que definan la lista de valores válidos para otros parámetros del informe (por ejemplo, seleccionar una categoría de producto concreta determina la lista de productos disponibles).
• Puede utilizar parámetros para conectar un informe primario a uno de obtención de detalles o uno integrado incrustado.
• Después de publicar un informe, puede administrar las propiedades de los parámetros del informe publicado de modo independiente de la definición del parámetro original. Según la forma en que configure el parámetro del informe en tiempo de diseño, los administradores del servidor de informes podrán modificar muchas propiedades de los parámetros en el informe publicado. Para obtener más información, vea Establecer las propiedades de los parámetros de un informe publicado.
• Los parámetros se pueden establecer en las suscripciones. Cada uno de los usuarios que se suscribe a un informe puede especificar valores de parámetro que se almacenan junto con la suscripción y son utilizados por ésta. Para obtener más información, vea Establecer parámetros en una suscripción.
• Los parámetros se pueden establecer mediante acceso URL. Para obtener más información, vea Using URL Access Parameters.

Nota de seguridad:

En cualquier informe que incluya un parámetro de tipo String, asegúrese de utilizar una lista de valores disponibles (también conocida como lista de valores válidos) y de que los usuarios que ejecuten el informe sólo dispongan de los permisos necesarios para ver los datos del mismo. Cuando se define un parámetro de tipo String, el usuario ve un cuadro de texto que admite cualquier valor. Una lista de valores disponibles limita los valores que se pueden especificar. Si el parámetro de informe está asociado a un parámetro de consulta y no se utiliza una lista de valores disponibles, un usuario del informe podría escribir sintaxis SQL en el cuadro de texto y exponer el informe y el servidor a un ataque por inyección de código SQL. Si el usuario tiene permisos suficientes para ejecutar la nueva instrucción SQL, podría provocar resultados no deseados en el servidor. Si un parámetro de informe no está asociado a un parámetro de consulta y los valores de parámetro están incluidos en el informe, un usuario del informe podría escribir sintaxis de expresiones o una dirección URL en el valor de parámetro y representar el informe en Excel o HTML. Si, después, otro usuario ve el informe y hace clic en el contenido del parámetro representado, existe la posibilidad de que ejecute inconscientemente la secuencia de comandos o el vínculo malintencionados. Para mitigar el riesgo de ejecutar secuencias de comandos malintencionadas por accidente, sólo deben abrirse informes representados que procedan de fuentes de confianza. Para obtener más información sobre cómo proteger los informes, vea Proteger informes y recursos.

En esta sección

• Usar parámetros para controlar los datos de los informes
  Describe el uso de los parámetros para controlar los datos de un informe.

• Usar parámetros para controlar el aspecto de los informes
  Describe el uso de los parámetros para controlar el aspecto de los informes, incluidas las propiedades de visibilidad, orden, filtrado, color y cuadros de texto.

• Usar parámetros para conectarse a otros informes
  Describe el uso de los parámetros para vincular a informes de obtención de detalles, informes integrados e informes vinculados.

• Usar parámetros de uno y varios valores
  Describe el uso de los parámetros de uno y varios valores.

• Crear parámetros de informe y establecer sus propiedades
  Describe la creación y el establecimiento de propiedades en un parámetro de informe.

• Usar parámetros en expresiones
  Describe la inclusión de parámetros en una expresión, incluida sintaxis para parámetros de uno y varios valores.

Vea también

Tareas

Cómo agregar un filtro (Diseñador de informes)
Cómo asociar un parámetro de consulta a un parámetro de informe (Diseñador de informes)
Cómo agregar, editar o eliminar un parámetro de informe (Diseñador de informes)

Conceptos

Trabajar con datos en un diseño de informe
Agregar características interactivas
Filtrar datos en un informe
Establecer las propiedades de los parámetros de un informe publicado

Otros recursos

Tutorial: Agregar parámetros a un informe tabular básico
Tutorial: Características avanzadas mediante el uso de parámetros
Parámetros del informe (Diseñador de informes)

Ayuda e información

Obtener ayuda sobre SQL Server 2005