Breaking

Post Top Ad

Your Ad Spot

domingo, 15 de diciembre de 2019

Usar parámetros de valores múltiples en SSRS

Este artículo cubre el uso y las características detalladas del parámetro de valores múltiples en SSRS.

Introducción

SQL Server Reporting Service, también conocido como SSRS, es una herramienta de informes de Microsoft que ayuda a desarrollar varios tipos de informes. Además, hace unos meses, Microsoft anunció el primer candidato de lanzamiento de SQL Server 2019 Reporting Service . Esto significa que SSRS sigue siendo una herramienta poderosa en el mercado y, al mismo tiempo, desempeña un papel clave para las empresas que necesitan crear informes personalizados e informes móviles.
Report Builder es una herramienta liviana que ayuda a desarrollar informes para SQL Server Reporting Service. En los ejemplos de este artículo, usaremos Report Builder. Puede consultar la introducción y el artículo tutorial del Generador de informes SSRS para obtener más detalles sobre el generador de informes SSRS.
Ahora, centrémonos en el tema principal de que los informes parametrizados nos brindan más flexibilidad y proporcionan una experiencia de usuario mejorada. A partir de este punto de vista, aprenderemos los parámetros de valores múltiples para desarrollar informes más avanzados.

¿Cuál es el parámetro de valores múltiples?

El parámetro de valores múltiples nos permite pasar uno o más del valor de entrada al informe. Además, ofrece una opción "Seleccionar todo" que ayuda a seleccionar todos los valores de los parámetros. Ahora, crearemos un ejemplo del parámetro de valores múltiples en SSRS.

Escenario de ejemplo

El departamento de recursos humanos de Adventureworks requirió un informe sobre los empleados que trabajan en la empresa. Quieren ver el número de identidad, la fecha de nacimiento, el estado civil y el género del empleado en el informe. Además, quieren filtrar a los empleados según sus títulos de trabajo. Enviaron un borrador sobre el informe que se ilustra a continuación:
Informe borrador

Crear una fuente de datos en el Generador de informes

Como primer paso, iniciaremos el Generador de informes y luego seleccionaremos la opción Informe en blanco en la ventana Introducción:
Informe en blanco en el Generador de informes
Esta opción nos ayuda a abrir rápidamente una pantalla de diseñador de informes vacía. Una pequeña desventaja de esta opción es establecer algunas opciones manualmente. Por este motivo, crearemos una fuente de datos y un conjunto de datos del informe manualmente.
En SSRS, las fuentes de datos almacenaron información detallada y credenciales sobre las conexiones. En la ventana principal de Repor Builder, las fuentes de datos se colocan en el lado derecho de la pantalla, haremos clic con el botón derecho y seleccionaremos la opción Agregar fuente de datos para agregar una nueva fuente de datos:
Agregar fuente de datos al Generador de informes
En la ventana Propiedades del origen de datos, podemos encontrar varios tipos de conexión que se pueden usar en los informes. Utilizaremos el tipo de conexión de Microsoft SQL Server para nuestro informe y seleccionaremos Usar una conexión incrustada en mi informe y le daremos HRReportDataSourcename :
Configuración de conexión de origen de datos en el Generador de informes
Podemos llenar el cuadro de texto Cadena de conexión manualmente o podemos usar la opción Construir para generar una cadena de conexión. Haremos clic en el botón Construir y configuraremos las credenciales de la cadena de conexión:
Crear configuración de conexión en el Generador de informes
Después de configurar la cadena de conexión, haremos clic en el botón Probar conexión para asegurarnos de haber establecido la configuración adecuada:
la conexión creó un mensaje exitoso
Si vemos el mensaje "La conexión se creó con éxito", podemos descubrir que todas las opciones están configuradas correctamente para la fuente de datos.

Crear un conjunto de datos en el Generador de informes

El conjunto de datos se utiliza para representar el conjunto de resultados de la consulta en los informes del Generador de informes. Almacena información detallada sobre el conjunto de resultados, como la cadena de consulta, los nombres de columna, los tipos de datos de las columnas, etc. Sin embargo, el conjunto de datos nunca almacena el conjunto de resultados real de la consulta.
Para nuestro ejemplo, haremos clic con el botón derecho en la carpeta Conjuntos de datos en la pestaña Datos de informe y haremos clic en la opción Agregar conjunto de datos :
Agregar un nuevo conjunto de datos en el Generador de informes
En la ventana Propiedades del conjunto de datos, elegiremos la opción Usar un conjunto de datos incrustado en mi informe para que el conjunto de datos creado en el paso anterior aparezca en el cuadro combinado Fuente de datos. Seleccionaremos la fuente de datos HRReportDataSource para este conjunto de datos y le daremos un nombre que es HRReportReportDataset :
Ventana de propiedades de origen de datos
Después de esta configuración, utilizaremos el siguiente script para obtener datos de SQL Server:
Como puede ver en lo anterior, el script contiene una variable que se define como @JobTitleParam . Este parámetro se puede usar para proporcionar información para el informe, de modo que podamos filtrar y controlar los conjuntos de resultados de la consulta. Particularmente para este informe, filtró la consulta de acuerdo con el JobTitle. Como último paso, haremos clic en Actualizar campos y haremos clic en Aceptar :
Editar consulta en la fuente de datos
Después de completar este paso, @JobTitleParam aparecerá en la carpeta Parámetros y las columnas del informe también aparecerán en la carpeta Conjunto de datos :
Pestaña Datos del informe del generador de informes

El parámetro de valores múltiples en Report Builder

El parámetro @JobTitleParam se ha creado automáticamente, sin embargo, debemos asociarlo a los valores de la columna JobTitle de la tabla HumanResources.Employee . Para hacer esto, crearemos un nuevo conjunto de datos y asociaremos los valores de retorno a @JobTitleParam para que podamos filtrar la consulta HRReportReportDataset de acuerdo con estos valores. Agregaremos un nuevo conjunto de datos cuyo nombre es HRReportParameterDataset y usaremos la siguiente consulta:
Un conjunto de datos del parámetro de valores múltiples en el Generador de informes
Haremos clic con el botón derecho en el parámetro @JobTitleParam y elegiremos Propiedades del parámetro en el menú contextual:
Propiedades de parámetros de valores múltiples
Haremos clic en la opción Permitir valores múltiples en la pestaña General para que podamos determinar el parámetro como un parámetro de valores múltiples y luego cambiar el campo Preguntar. Este cambio afectará el nombre que muestra el parámetro en el informe. Después de esta configuración, haremos clic en la pestaña Valores disponibles :
Permitir valores múltiples para parámetros de valores múltiples

A través de esta pestaña, asociaremos una relación entre los valores y parámetros de los resultados de la consulta del conjunto de datos. Al principio, seleccionaremos los valores de Obtener de una consulta para poder crear una conexión entre el conjunto de datos y el parámetro. En el segundo paso, podemos determinar el campo de valor y el campo de etiqueta para el parámetro.
  • El campo de valor especifica los valores que se pasan a las consultas
  • El campo de etiqueta especifica los valores que se muestran en el informe
Para nuestro ejemplo, configuraremos estas opciones como se muestra en la imagen a continuación:
Obtener valores de una opción de consulta para parámetros de valores múltiples

Diseño de informe en Report Builder

En esta parte, diseñaremos un informe muy básico que se describe en nuestro escenario:
  • Haga clic en Insertar en el menú Generador de informes
  • Haga clic en el botón Tabla y seleccione la opción Insertar tabla en el menú
  • Arrastre y suelte las columnas HRReportReportDataset a la tabla
  • Cambiar el pie de página del informe como Informe detallado del empleado
Diseñar un informe del Generador de informes
Finalmente, haremos clic en el botón Ejecutar para ver el informe. Si hacemos clic en las opciones (Seleccionar todo), seleccionará todos los valores de parámetros o podremos hacer selecciones de valores de parámetros individuales. La opción Ver informe se utiliza para ejecutar el informe:
Ejecutar el informe del Generador de informes
Resultado del informe Generador de informes
El operador IN se utiliza para especificar múltiples valores en la consulta. La consulta ejecutada se puede encontrar en el generador de perfiles y será la siguiente:
Parámetros de valores múltiples ejecutados detalles de la consulta

Establecer valores predeterminados para parámetros de valores múltiples

En algunos casos, necesitamos completar los valores de los parámetros con los valores predeterminados. Por ejemplo, si queremos acceder al valor del Administrador de cuentas para que sea el predeterminado para @ JobTitleParam , podemos determinarlo en la pestaña Valores predeterminados . Al principio, elegimos la opción Especificar valores y luego la escribimos en el campo de valor:
Establecer valores predeterminados del parámetro de valores múltiples
Después de estos ajustes, el resultado del informe será el siguiente:
Usar parámetros de valores múltiples en un informe
Si queremos establecer la opción Seleccionar todo como un parámetro predeterminado, debemos seguir los siguientes pasos:
  • Elija Obtener valores de una consulta en la pestaña Valores predeterminados
  • Establezca HRReportParameterDataset en el cuadro combinado de conjunto de datos
  • Establecer el campo JobTitle en el campo Valor
Establecer valores predeterminados del parámetro de valores múltiples desde una consulta
Si ejecutamos el informe, podemos ver que todos los valores se seleccionan en la primera ejecución del informe.

Mostrar los valores seleccionados del parámetro de valores múltiples

Las expresiones se utilizan para generar funciones personalizadas en los informes SSRS con la ayuda de las funciones integradas y los códigos personalizados. Para mostrar las selecciones del parámetro de valores múltiples, utilizaremos expresiones. La función de unión se puede usar para concatenar los valores seleccionados del parámetro de valores múltiples. Si seguimos los pasos a continuación, podemos mostrar la selección del parámetro de valores múltiples:
  • Agregar un cuadro de texto al informe
  • Haga clic derecho en el cuadro de texto y seleccione el elemento del menú Expresión
    Establecer la expresión en el cuadro de texto
  • Rellene el campo de valor con la siguiente expresión:
    Mostrar las selecciones de parámetros de valores múltiples con ayuda de la expresión
Si seleccionamos más de un valor en el parámetro de valores múltiples, el resultado del informe será el siguiente:
Mostrar las selecciones de parámetros de valores múltiples en el informe del Generador de informes

Conclusión

En este artículo, aprendimos a diseñar un informe básico en Report Builder, y también aprendimos a usar un parámetro de valores múltiples con configuraciones avanzadas.

Ver más

No hay comentarios.:

Publicar un comentario

Dejanos tu comentario para seguir mejorando!

Post Top Ad

Your Ad Spot

Páginas