Parámetros de un informe paginado (Generador de informes)

Se aplica a: SQL Server 2016 (13.x) Reporting Services y versiones posteriores SharePoint

Se aplica a: SQL Server 2016 (13.x) Reporting Services y versiones posteriores

En este tema se describen los usos habituales de los parámetros de informes paginados, las propiedades que puede establecer y otros muchos aspectos. Los parámetros de informe le permiten controlar datos de informe, conectar informes relacionados y cambiar la presentación de los informes. Puedes usar parámetros de un informe en informes paginados que crees en --- título: include file description: include file author: maggiesMSFT ms.author: maggies ms.date: 12/06/2018 ms.service: ms.topic: include ms.custom: include fileReport Builder y en Report Designer, y también en informes móviles que crees en Publicador de informes móviles de SQL Server. Obtenga más información sobre Conceptos de parámetros de informe.

Nota

El Publicador de informes móviles de SQL Server está en desuso para todas las versiones de SQL Server Reporting Services posteriores a SQL Server Reporting Services 2019. Se interrumpe a partir de SQL Server Reporting Services 2022 y Power BI Report Server.

Para intentar agregar un parámetro a un informe por su cuenta, vea Tutorial: Agregar un parámetro a un informe (Generador de informes).

Usos comunes de los parámetros

Estos son algunos de los usos más comunes de los parámetros.

Control de datos de informes móviles y paginados

  • Filtre los datos del informe paginado en el origen de datos; para ello escriba las consultas del conjunto de datos que incluyen variables.

  • Filtrar datos desde un conjunto de datos compartido Cuando se agrega un conjunto de datos compartido a un informe paginado, no se puede cambiar la consulta. En el informe, podrá agregar un filtro del conjunto de datos que incluya una referencia al parámetro de informe creado por usted.

  • Filtre los datos de un conjunto de datos compartido en un informe móvil de SQL Server. Consulte Create mobile reports with SQL Server Mobile Report Publisher para obtener más información.

  • Permita a los usuarios especificar valores para personalizar los datos de un informe paginado. Por ejemplo, para proporcionar dos parámetros para la fecha de inicio y de finalización de los datos de ventas.

Conectar informes relacionados

  • Use parámetros para relacionar informes principales con informes detallados, así como a subinformes e informes vinculados. Cuando se diseña un conjunto de informes, cada informe se puede diseñar de tal modo que responda a determinadas preguntas. Cada informe puede aportar un punto de vista o un nivel de detalle distinto sobre la información relacionada. Para ofrecer un conjunto de informes interrelacionados, cree parámetros para los datos relacionados en los informes de destino.

    Para obtener más información, vea Informes detallados (Generador de informes y SSRS),Subinformes (Generador de informes y SSRS) yCrear un informe vinculado.

  • Personalizar conjuntos de parámetros para varios usuarios. Crear dos informes vinculados basados en un informe de ventas en el servidor de informes. Uno utilizará valores de parámetro predefinidos para los vendedores y el otro, para los directores de ventas. Ambos informes utilizan la misma definición de informe.

Cambiar la presentación de los informes

  • Envíe comandos a un servidor de informes a través de una solicitud URL, para personalizar la representación de un informe. Para más información, vea Acceso URL (SSRS) y Pasar un parámetro de informe en una dirección URL.

  • Permitir a los usuarios especificar valores para ayudarles a personalizar la apariencia de un informe. Por ejemplo, proporcionar un parámetro Boolean para indicar si se expandirán o contraerán todos los grupos de filas anidadas de una tabla.

  • Permita a los usuarios personalizar los datos y apariencia de un informe mediante la incorporación de parámetros en una expresión.

    Para más información, consulte Referencias a la colección de parámetros (Generador de informes y SSRS).

Ver un informe con parámetros

Al ver un informe que tiene parámetros, en la barra de herramientas del visor de informes se muestran todos los parámetros para que los usuarios puedan especificar valores de forma interactiva. En la siguiente ilustración se muestra el área de parámetros de un informe con los parámetros @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota y @SalesDate.

View report with parameters

  1. Panel Parámetros : la barra de herramientas del Visor de informes muestra un mensaje de petición de datos y un valor predeterminado para cada parámetro. Puede personalizar el diseño de los parámetros en el panel de parámetros. Para más información, vea Personalizar el panel Parámetros en un informe paginado (Generador de informes).

  2. Parámetro @SalesDate el parámetro @SalesDate es de tipo de datos DateTime. Se mostrará el mensaje Seleccionar la fecha junto al cuadro de texto. Para modificar la fecha, escriba una nueva en el cuadro de texto o utilice el control de calendario.

  3. Parámetro @ShowAll El parámetro @ShowAll es de tipo de datos Boolean. Utilice los botones de radio para especificar True o False.

  4. Identificador Mostrar u ocultar área de parámetros : en la barra de herramientas del Visor de informes, haga clic en esta flecha para mostrar u ocultar el panel de parámetros.

  5. Parámetro @CategoryQuota El parámetro @CategoryQuota es de tipo de datos Float, por lo que acepta un valor numérico. @CategoryQuota se establece para permitir varios valores.

  6. Ver informe Después de escribir los valores de los parámetros, haga clic en Ver informe para ejecutar el informe. Si todos los parámetros poseen valores predeterminados, el informe se ejecuta automáticamente en la primera vista.

Crear parámetros

Puede crear parámetros de informe de varias formas.

Nota

No todos los orígenes de datos son compatibles con los parámetros.

Consulta de conjunto de datos o procedimiento almacenado con parámetros

Agregue una consulta de conjunto de datos que contenga variables o un procedimiento almacenado de conjunto de datos que contenga parámetros de entrada. Los parámetros de conjunto de datos se crean para cada variable o parámetro de entrada y los parámetros de informe se crean para cada parámetro de conjunto de datos.

Report Builder Parameter Dataset Properties

En esta imagen del Generador de informes se muestra lo siguiente:

  1. Los parámetros del informe en el panel Datos de informe.

  2. El conjunto de datos con los parámetros.

  3. El Panel de parámetros.

  4. La lista de parámetros en el cuadro de diálogo Propiedades del conjunto de datos.

El conjunto de datos se puede incrustar o compartir. Cuando se agrega un conjunto de datos compartido a un informe, los parámetros de conjunto de datos que están marcados como internos no se pueden invalidar en el informe. Podrá invalidar parámetros de conjunto de datos que no estén marcados como internos.

Para obtener más información, vea Consultas de conjunto de datos en este tema.

Crear un parámetro de forma manual

Cree un parámetro manualmente desde el panel Datos de informe. Puede configurar parámetros de informe para que un usuario pueda especificar de forma interactiva valores que le permitan a personalizar el contenido o la apariencia de un informe. También puede configurar parámetros de informe para que un usuario no pueda cambiar los valores preconfigurados.

Nota

Puesto que los parámetros se administran de forma independiente en el servidor, al volver a publicar un informe principal con una nueva configuración de parámetros, no se sobrescribe la configuración de parámetros existente del informe.

Elemento de informe con un parámetro

Nota

Los elementos de informe están en desuso para todas las versiones de SQL Server Reporting Services a partir de SQL Server Reporting Services 2019 y todas las versiones de Power BI Report Server a partir de la versión de Power BI Report Server de septiembre de 2022.

Agregue un elemento de informe que contenga referencias a un parámetro o a un conjunto de datos compartido que contenga variables.

Los elementos de informe se almacenan en el servidor de informes y están disponibles para que otros usuarios los utilicen en sus informes. Los elementos de informe que representan parámetros no se pueden administrar en el servidor de informes. Puede buscar los parámetros en la galería de elementos de informe y una vez agregados, configurarlos en su informe. Para más información, consulte Elementos de informe (Generador de informes y SSRS).

Nota:

Los parámetros se pueden publicar como elemento de informe independiente para las regiones de datos que tienen conjuntos de datos dependientes con parámetros. Aunque los parámetros se enumeren como elemento de informe, no puede agregar un parámetro de elemento de informe directamente a un informe. En lugar de ello, agregue el elemento de informe y los parámetros de informe necesarios se generan automáticamente a partir de las consultas de conjunto de datos que se encuentran en el elemento de informe, o a las que este hace referencia. Para más información sobre los elementos de informe, vea Elementos de informe (Generador de informes y SSRS) y Elementos de informe en el Diseñador de informes (SSRS).

Valores de parámetros

A continuación, se presentan las opciones para seleccionar valores de parámetro en el informe.

  • Seleccione un único valor de parámetro de la lista desplegable.

  • Seleccione varios valores de parámetro en la lista desplegable.

  • Seleccione un valor de la lista desplegable para un parámetro, el cual determina los valores que están disponibles en la lista desplegable para otro parámetro. Se trata de parámetros en cascada. Los parámetros en cascada le permitirán filtrar sucesivamente los valores de parámetro para reducir los miles de valores posibles a un número más fácil de manejar.

    Para más información, vea Agregar parámetros en cascada a un informe (Generador de informes y SSRS).

  • Ejecute el informe sin necesidad de seleccionar antes un valor de parámetro porque se ha creado un valor predeterminado para el parámetro.

Propiedades de los parámetros del informe

Puede cambiar las propiedades del parámetro de informe si usa el cuadro de diálogo Propiedades del informe. En la siguiente tabla se resumen las propiedades que se pueden establecer para cada parámetro:

Propiedad Descripción
Nombre Escriba un nombre de parámetro con distinción de mayúsculas y minúsculas. El nombre debe comenzar por una letra y puede incluir letras, números y caracteres de subrayado (_). El nombre no puede contener espacios. En el caso de los parámetros generados automáticamente, el nombre coincide con el parámetro en la consulta de conjunto de datos. De forma predeterminada, los parámetros creados manualmente son similares a ReportParameter1.
Prompt El texto que aparece junto al parámetro en la barra de herramientas del Visor de informes.
Tipo de datos Un parámetro de informes debe ser de uno de los siguientes tipos de datos:

Booleano. El usuario selecciona True o False en un botón de opción.

Fecha y hora. El usuario selecciona una fecha en un control de calendario.

Entero. El usuario escribe valores en un cuadro de texto.

Flotante. El usuario escribe valores en un cuadro de texto.

Texto. El usuario escribe valores en un cuadro de texto.

Cuando se definen los valores disponibles para un parámetro, el usuario elige valores en una lista desplegable, aunque el tipo de datos sea DateTime.

Para obtener más información acerca de los tipos de datos de informe, vea RDL Data Types.
Permitir valor en blanco Seleccione esta opción si el valor del parámetro puede ser una cadena vacía o estar en blanco.

Si especifica los valores válidos de un parámetro, y desea que el valor en blanco sea uno de ellos, deberá incluirlo como uno de los valores que especifique. La selección de esta opción no incluye automáticamente el espacio en blanco entre los valores disponibles.
Permitir valor NULL Seleccione esta opción si el valor del parámetro puede ser un valor NULL.

Si especifica los valores válidos de un parámetro, y desea que el valor NULL sea uno de ellos, deberá incluirlo como uno de los valores que especifique. La selección de esta opción no incluye automáticamente NULL entre los valores disponibles.
Permitir varios valores Proporcione los valores disponibles para crear una lista desplegable que permita realizar selecciones a los usuarios. Esta es una buena forma de asegurarse de que solo se enviarán valores válidos en una consulta de conjunto de datos.

Seleccione esta opción si el valor del parámetro puede ser varios valores que se muestran en una lista desplegable. No se admiten valores NULL. Cuando esta opción está seleccionada, se agregan casillas a la lista de valores disponibles en una lista desplegable de parámetros. La parte superior de la lista incluye una casilla para Seleccionar todo. Los usuarios pueden activar los valores que desean usar.

Si los datos que proporcionan valores cambian rápidamente, podría darse el caso de que la lista que ve el usuario no sea la más actualizada.
Visible Seleccione esta opción si desea mostrar el parámetro de informe en la parte superior del informe al ejecutarse éste. Esta opción permite a los usuarios seleccionar los valores de los parámetros en tiempo de ejecución.
Hidden Seleccione esta opción si desea ocultar el parámetro de informe en el informe publicado. Los valores del parámetro de informe pueden continuar estableciéndose en una dirección URL de informe, en una definición de suscripción o en el servidor de informes.
Interno Seleccione esta opción para ocultar el parámetro de informe. En el informe publicado, el parámetro de informe solamente podrá verse en la definición de informe.
Valores disponibles Si ha especificado los valores disponibles de un parámetro, los valores válidos aparecerán siempre como una lista desplegable. Por ejemplo, si proporciona los valores disponibles para un parámetro DateTime , aparecerá una lista desplegable para las fechas en el panel de parámetros, en lugar de un control de calendario.

Para asegurarse de que exista una lista de valores coherente entre un informe y los subinformes, puede establecer una opción en el origen de datos para utilizar una transacción única para todas las consultas de los conjuntos de datos que estén asociadas a un origen de datos.

Nota de seguridad En cualquier informe que incluya un parámetro del tipo de datos Texto, asegúrese de utilizar una lista de valores disponibles (también conocida como lista de valores válidos) y asegúrese de que los usuarios que ejecuten el informe tengan solo los permisos necesarios para ver los datos en el informe. Para obtener más información, consulte Seguridad (Generador de informes).
Valores predeterminados Establezca los valores predeterminados a partir de una consulta o de una lista estática.

Los informes se ejecutan de forma automática en la primera vista cuando cada parámetro de informe tiene un valor predeterminado.
Avanzado Establecer el atributo de definición de informe UsedInQuery, un valor que indica si este parámetro afecta directa o indirectamente a los datos de un informe.

Determinar automáticamente cuándo actualizar
Elija esta opción si desea que el procesador de informes determine una configuración para este valor. El valor es True si el procesador de informes detecta una consulta de conjunto de datos con una referencia directa o indirecta a este parámetro o si el informe tiene subinformes.

Actualizar siempre
Elija esta opción cuando el parámetro de informes se utilice directa o indirectamente en una consulta de conjunto de datos o una expresión de parámetro. Esta opción establece UsedInQuery en True.

No actualizar nunca
Elija esta opción cuando el parámetro de informes no se utilice directa o indirectamente en una consulta de conjunto de datos o una expresión de parámetro. Esta opción establece UsedInQuery en False.

Precaución Use No actualizar nunca con precaución. En el servidor de informes, UsedInQuery se utiliza para ayudar a controlar las opciones de memoria caché para los datos de los informes y para los informes representados, y opciones de parámetros para instantáneas de informe. Si establece No actualizar nunca de manera incorrecta podría provocar que los datos de informes o los informes incorrectos se almacenen en memoria caché o provocar que una instantánea de informe tenga datos incoherentes. Para más información, vea Lenguaje RDL (Report Definition Language) (SSRS).

Consulta de conjunto de datos

Para filtrar los datos en la consulta de conjunto de datos, puede incluir una cláusula de restricción que limite los datos recuperados; para ello, deberá especificar los valores que se van a incluir o excluir del conjunto de resultados.

Use el diseñador de consultas para el origen de datos para generar una consulta con parámetros.

  • Para las consultas de Transact-SQL, los diferentes orígenes de datos admiten una sintaxis diferente para los parámetros. La compatibilidad varía para los parámetros que se identifican en la consulta por su posición o los que se identifican por su nombre. Para más información, vea los temas relacionados con los tipos de orígenes de datos externos específicos en Conjuntos de datos de informe (SSRS). En el diseñador de consultas relacional, debe seleccionar la opción de parámetro de un filtro para crear una consulta parametrizada. Para obtener más información, vea Interfaz de usuario del Diseñador de consultas relacionales (Generador de informes).

  • En las consultas basadas en un origen de datos multidimensionales, como Microsoft SQL Server Analysis Services, SAP NetWeaver BI o Hyperion Essbase, podrá especificar si desea crear un parámetro en función del filtro que haya especificado en el diseñador de consultas. Para más información, vea el tema sobre el diseñador de consultas en Herramientas de diseño de consulta (SSRS) que se corresponda con la extensión de datos.

Administración de parámetros para un informe publicado

Cuando diseñe un informe, los parámetros de informe se guardarán en la definición de informe. Cuando diseñe un informe, los parámetros de informe se guardarán y administrarán por separado, no con la definición de informe.

En un informe publicado, puede usar lo siguiente:

  • Propiedades de los parámetros del informe. Cambiar directamente los valores de los parámetros de informe en el servidor de informes independientemente de la definición de informe.

  • Informes almacenados en caché. Para crear un plan de memoria caché para un informe, cada parámetro debe tener un valor predeterminado. Para más información, vea Informes almacenados en caché (SSRS).

  • Conjuntos de datos compartidos en caché. Para crear un plan de memoria caché para un conjunto de datos compartido, cada parámetro debe tener un valor predeterminado. Para más información, vea Informes almacenados en caché (SSRS).

  • Informes vinculados. Puede crear informes vinculados con valores de parámetro preestablecidos para filtrar datos para los distintos destinatarios. Para obtener más información, consulte Crear un informe vinculado.

  • Suscripciones de informes. Puede especificar valores de parámetro para filtrar datos y entregar informes mediante suscripciones. Para más información, consulte Suscripciones y entrega (Reporting Services).

  • Acceso URL. Puede especificar valores de parámetro en una dirección URL a un informe. También puede ejecutar informes y especificar valores de parámetro mediante el acceso desde una dirección URL. Para obtener más información, consulte Acceso URL (SSRS).

Las propiedades de los parámetros para un informe publicado se conservan al volver a publicar la definición del informe. Si se vuelve a publicar la definición del informe como el mismo informe y no se modifican los nombres de los parámetros ni los tipos de datos, se conserva la configuración de las propiedades. Si se agregan o eliminan parámetros de la definición del informe, o si se cambia el tipo de datos o el nombre de un parámetro existente, quizás resulte necesario cambiar las propiedades de los parámetros del informe publicado.

No todos los parámetros pueden modificarse siempre que se desea. Si un parámetro de informe obtiene un valor predeterminado de una consulta de conjunto de datos, ese valor no se podrá modificar para un informe publicado y tampoco en el servidor de informes. El valor que se utiliza en tiempo de ejecución se determina cuando se ejecuta la consulta o, en el caso de parámetros basados en una expresión, cuando se evalúa la expresión.

Las opciones de ejecución del informe pueden incidir en el modo en que se procesan los parámetros. Un informe que se ejecute como instantánea no puede utilizar parámetros obtenidos de una consulta excepto si la consulta incluye valores predeterminados para los parámetros.

Parámetros de una suscripción

Puede definir una suscripción para un informe a petición o para una instantánea y especificar los valores de parámetro que se usarán durante el procesamiento de la suscripción.

  • Informes a petición Para un informe a petición, puede especificar un valor de parámetro diferente que el valor publicado para cada parámetro indicado en el informe. Por ejemplo, supongamos que tiene un informe de llamadas de servicio que utiliza un parámetro Período de tiempo para devolver las solicitudes de atención al cliente para el día, la semana o el mes actual. Si el valor de parámetro predeterminado para el informe se establece en hoy, la suscripción puede usar un valor de parámetro diferente (como semana o mes) para producir un informe que contenga cifras semanales o mensuales.

  • Instantánea. Para una instantánea, la suscripción debe usar los valores de parámetro definidos para la instantánea. La suscripción no puede reemplazar un valor de parámetro que se haya definido para una instantánea. Por ejemplo, supongamos que se va a suscribir a un informe de ventas para la región occidental que se ejecuta como instantánea de un informe, y la instantánea especifica Occidental como valor de parámetro regional. En este caso, si crea una suscripción a este informe, debe utilizar el valor de parámetro Occidental en la suscripción. Para proporcionar una indicación visual de que se omite el parámetro, los campos de parámetros de la página de suscripción se establecen en campos de solo lectura.

    Las opciones de ejecución del informe pueden incidir en el modo en que se procesan los parámetros. Los informes con parámetros que se ejecuten como instantáneas de informes utilizan los valores de parámetro definidos para la instantánea de informes. Los valores de parámetro se definen en la página de propiedades de parámetros del informe. Un informe que se ejecute como instantánea no puede utilizar parámetros obtenidos de una consulta excepto si la consulta incluye valores predeterminados para los parámetros.

    Si cambia un valor de parámetro en la instantánea de un informe después de que se haya definido la suscripción, el servidor de informes la desactiva. La desactivación de la suscripción indica que el informe se ha modificado. Para activarla, abra y guarde la suscripción.

Nota:

Las suscripciones controladas por datos pueden utilizar valores de parámetros que se obtienen a partir de un origen de datos de suscriptores. Para más información, vea Usar un origen de datos externo para obtener información de los suscriptores (suscripción controlada por datos).

Para más información, consulte Suscripciones y entrega (Reporting Services).

Parámetros y asegurar datos

Sea precavido cuando se distribuyan informes con parámetros que contengan información confidencial o delicada. Un usuario puede reemplazar fácilmente un parámetro de informe con un valor diferente y, sin pretenderlo, provocar la divulgación de la información.

Una alternativa segura al uso de parámetros para los datos de los empleados o el personal es seleccionar datos que se basen en expresiones que incluyan el campo UserID de la colección Users. La colección Users proporciona un método de obtener la identidad del usuario que ejecuta el informe y utiliza esa identidad para recuperar datos específicos de usuario.

Importante

En cualquier informe que incluya un parámetro del tipo de Cadena, asegúrese de usar una lista de valores disponibles (que también se conoce como una lista de valores válidos) y de que los usuarios que ejecuten el informe solo tengan los permisos necesarios para ver los datos del informe. 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 conjunto de datos 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 conjunto de datos 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, posteriormente, otro usuario visualiza el informe y hace clic en el contenido del parámetro representado, el usuario podría ejecutar accidentalmente el script o el vínculo malintencionados.

Para reducir el riesgo de ejecución accidental de scripts malintencionados, abra los informes representados exclusivamente desde orígenes de confianza. Para obtener más información sobre cómo proteger informes, vea Proteger informes y recursos.

Tutorial: Adición de un parámetro al informe (Generador de informes)

Conceptos de parámetros de informe

Ejemplos de informes (Generador de informes y SSRS)

Usar expresiones en informes (Generador de informes y SSRS)

Expresiones (Generador de informes y SSRS)

Filtrar, agrupar y ordenar datos (Generador de informes y SSRS)

Seguridad (Generador de informes)

Ordenación interactiva, mapas de documento y vínculos (Generador de informes y SSRS)

Obtención de detalles, informes detallados, subinformes y regiones de datos anidadas (Generador de informes y SSRS)