Adición de parámetros en cascada a un informe paginado (Generador de informes)

Se aplica a: Generador de informes de Microsoft (SSRS) Generador de informes de Power BI Diseñador de informes en SQL Server Data Tools

Los parámetros en cascada permiten administrar grandes cantidades de datos en un informe paginado. Es posible definir un conjunto de parámetros relacionados de manera que la lista de valores de uno de ellos dependa del valor seleccionado en otro parámetro. Por ejemplo, el primer parámetro es independiente y podría presentar una lista de categorías de productos. Cuando el usuario selecciona una categoría, el segundo parámetro depende del valor del primer parámetro. Sus valores se actualizan con una lista de subcategorías para la categoría elegida. Cuando el usuario ve el informe, los valores de los parámetros de categoría y subcategoría se usan para filtrar los datos del informe.

Nota:

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

Para crear parámetros en cascada, primero debe definir la consulta del conjunto de datos e incluir un parámetro de consulta para cada parámetro en cascada que necesite. También debe crear un conjunto de datos independiente para que para cada parámetro en cascada proporcione los valores disponibles. Para más información, vea Agregar, cambiar o eliminar los valores disponibles para un parámetro de informe (Generador de informes).

El orden es importante para los parámetros en cascada, dado que la consulta del conjunto de datos de un parámetro que aparece más adelante en la lista incluye una referencia a cada parámetro que aparece antes en la lista. En tiempo de ejecución, el orden de los parámetros en el panel Datos de informe determina el orden en que aparecen las consultas de parámetros en el informe. Por lo tanto, el orden en el que un usuario elige cada valor de parámetro sucesivo.

Para obtener información sobre la creación de parámetros en cascada con varios valores e incluso la función Select All, vea Tener un parámetro en cascada con varios valores y Select All.

  1. En el panel Datos de informe, haga clic con el botón derecho en un origen de datos y, después, seleccione Agregar conjunto de datos.

  2. En Nombre, introduzca el nombre del conjunto de datos.

  3. En Origen de datos, elija el nombre del origen de datos o seleccione Nuevo para crear uno.

  4. En Tipo de consulta, elija el tipo de consulta para el origen de datos seleccionado. En este artículo, se supone que el tipo de consulta es Texto.

  5. En Consulta, introduzca la consulta que se debe usar para recuperar los datos para este informe. La consulta debe incluir las partes siguientes:

    1. Una lista de campos del origen de datos. Por ejemplo, en una instrucción Transact-SQL, la instrucción SELECT especifica una lista de nombres de columnas de la base de datos de una tabla o vista determinada.

    2. Un parámetro de consulta para cada parámetro en cascada. Un parámetro de consulta limita los datos recuperados del origen de datos especificando determinados valores para incluirlos o excluirlos de la consulta. Normalmente, los parámetros de consulta se sitúan en una cláusula de restricción de la consulta. Por ejemplo, en una instrucción SELECT de Transact-SQL, los parámetros de consulta se sitúan en la cláusula WHERE.

  6. Seleccione Ejecutar (!). Una vez incluidos los parámetros de la consulta y ejecutada la consulta, automáticamente se crean parámetros de informe correspondientes a los parámetros de la consulta.

    Nota:

    El orden que tienen los parámetros de la consulta la primera vez se ejecuta una consulta determina el orden en que se crean en el informe. Para cambiar el orden, vea Cambiar el orden de un parámetro de informe (Generador de informes).

  7. Seleccione Aceptar.

A continuación, cree un conjunto de datos que proporciona los valores para el parámetro independiente.

Crear un conjunto de datos para proporcionar los valores para un parámetro independiente

  1. En el panel Datos de informe, haga clic con el botón derecho en un origen de datos y, después, seleccione Agregar conjunto de datos.

  2. En Nombre, introduzca el nombre del conjunto de datos.

  3. En Origen de datos, compruebe que el nombre es el nombre del origen de datos que eligió en el paso 1.

  4. En Tipo de consulta, elija el tipo de consulta para el origen de datos seleccionado. En este artículo, se supone que el tipo de consulta es Texto.

  5. En Consulta, introduzca la consulta que se debe usar para recuperar los valores para este parámetro. Las consultas para los parámetros independientes normalmente no contienen los parámetros de la consulta. Por ejemplo, para crear una consulta para un parámetro que proporciona los valores de todas las categorías, podría usar una instrucción Transact-SQL similar al siguiente bloque:

    SELECT DISTINCT <column name> FROM <table>  
    

    El comando SELECT DISTINCT quita los valores duplicados del conjunto de resultados para que obtenga cada valor único de la columna y la tabla especificadas.

    Seleccione Ejecutar (!). El conjunto de resultados muestra los valores disponibles para este primer parámetro.

  6. Seleccione Aceptar.

A continuación, establezca las propiedades del primer parámetro que se debe usar en este conjunto de datos para rellenar sus valores disponibles en tiempo de ejecución.

Establecer los valores disponibles para un parámetro de informe

  1. En la carpeta Parámetros del panel Datos de informe, haga clic con el botón derecho en el primer parámetro y, después, seleccione Propiedades del parámetro.

  2. En Nombre, compruebe que el nombre del parámetro es correcto.

  3. Seleccione Valores disponibles.

  4. Seleccione Obtener valores de una consulta. Aparecen tres campos.

  5. En Conjunto de datos, en la lista, seleccione el nombre del conjunto de datos que creó en el procedimiento anterior.

  6. En el campo Valor, seleccione el nombre del campo que proporciona el valor del parámetro.

  7. En el campo Etiqueta, seleccione el nombre del campo que proporciona la etiqueta del parámetro.

  8. Seleccione Aceptar.

A continuación, cree un conjunto de datos que proporcione los valores para el parámetro dependiente.

Crear un conjunto de datos para proporcionar los valores para un parámetro dependiente

  1. En el panel Datos de informe, haga clic con el botón derecho en un origen de datos y, después, seleccione Agregar conjunto de datos.

  2. En Nombre, introduzca el nombre del conjunto de datos.

  3. En Origen de datos, compruebe que el nombre es el nombre del origen de datos que eligió en el paso 1.

  4. En Tipo de consulta, elija el tipo de consulta para el origen de datos seleccionado. En este artículo, se supone que el tipo de consulta es Texto.

  5. En Consulta, introduzca la consulta que se debe usar para recuperar los valores para este parámetro. Las consultas para los parámetros dependientes normalmente incluyen parámetros de consulta para cada parámetro del que depende este parámetro. Por ejemplo, puede crear una consulta para un parámetro que proporciona todos los valores de subcategoría (parámetro dependiente) para una categoría (parámetro independiente). Para ello, puede usar una instrucción Transact-SQL similar al bloque siguiente:

    SELECT DISTINCT Subcategory FROM <table>   
    WHERE (Category = @Category)  
    

    En la cláusula WHERE, Categoría es el nombre de un campo de <table> y @Category es un parámetro de la consulta. Esta instrucción genera una lista de subcategorías para la categoría especificada en @Category. En tiempo de ejecución, este valor se rellena con el valor elegido por el usuario para el parámetro de informe que tiene el mismo nombre.

  6. Seleccione Aceptar.

A continuación, establezca las propiedades del segundo parámetro que se debe utilizar en este conjunto de datos para rellenar sus valores disponibles en tiempo de ejecución.

Establecer los valores disponibles para el segundo parámetro

  1. En la carpeta Parámetros del panel Datos de informe, haga clic con el botón derecho en el primer parámetro y, después, seleccione Propiedades del parámetro.

  2. En Nombre, compruebe que el nombre del parámetro es correcto.

  3. Seleccione Valores disponibles.

  4. Seleccione Obtener valores de una consulta.

  5. En Conjunto de datos, en la lista, seleccione el nombre del conjunto de datos que creó en el procedimiento anterior.

  6. En el campo Valor, seleccione el nombre del campo que proporciona el valor del parámetro.

  7. En el campo Etiqueta, seleccione el nombre del campo que proporciona la etiqueta del parámetro.

  8. Seleccione Aceptar.

Probar los parámetros en cascada

  1. Seleccione Ejecutar.

  2. En la lista del primer parámetro, el parámetro independiente, elija un valor.

    El procesador de informes ejecuta la consulta del conjunto de datos para el parámetro siguiente y le pasa el valor que eligió para el primer parámetro. La lista del segundo parámetro se rellena con los valores disponibles basados en el valor del primer parámetro.

  3. De la lista del segundo parámetro, el parámetro dependiente, elija un valor.

    El informe no se ejecuta automáticamente después de elegir el último parámetro para que pueda cambiar su elección.

  4. Seleccione Ver informe. El informe actualiza la presentación basándose en los parámetros que eligió.

Agregar, cambiar o eliminar parámetros de informe (Generador de informes)
Parámetros de informe (Generador de informes y Diseñador de informes)
Tutorial: Incorporación de un parámetro al informe (Generador de informes)
Tutoriales del Generador de informes
Usar filtros de conjunto de datos, filtros de región de datos y filtros de grupo (Generador de informes)
Conjuntos de datos insertados y compartidos de informe (Report Builder)