Comparteix a través de

Diseñar informes paginados de Reporting Services con el Diseñador de informes (SSRS)

  • Article

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

Puede usar el Diseñador de informes para crear informes paginados de SQL Server Reporting Services (SSRS) y soluciones de informes completos. El Diseñador de informes proporciona:

  • Una manera de definir orígenes de datos, conjuntos de datos y consultas.
  • Funcionalidades para diseñar y personalizar el diseño de las regiones y campos de datos.
  • Características interactivas, como parámetros y conjuntos de informes que funcionan juntos.

El Diseñador de informes es una característica de SQL Server Data Tools (SSDT), un entorno de Microsoft Visual Studio para crear soluciones de inteligencia empresarial.

Instalación de SSDT

SSDT no se incluye con SQL Server. Es necesario instalarlo por separado. Para instrucciones, vea Instalación de SSDT con Visual Studio.

Para usar plantillas del Diseñador de informes, también debe instalar una extensión de SSRS para Visual Studio. Para instrucciones, vea Instalación de extensiones para Analysis Services, Integration Services y Reporting Services.

Ventajas de Proyectos de informe

En Diseñador de informes, puede usar proyectos para organizar informes. La característica Proyectos de informe actúa como contenedor para las definiciones y los recursos de informe. Puede usar proyectos para las siguientes tareas:

  • Organizar los informes y elementos relacionados en un contenedor.
  • Probar soluciones de informe que incluyen informes y elementos relacionados localmente.
  • Implementar conjuntamente los elementos relacionados. Puede usar las propiedades del proyecto y la administración de configuración para implementar elementos en varios entornos.
  • Conservar un conjunto de copias principales para informes y elementos relacionados, ya que después de la implementación, los informes publicados se pueden modificar accidentalmente.

Puede usar la información de este artículo para diseñar informes paginados y elementos relacionados para un solo proyecto de informe en una solución de SSDT. Para más información sobre soluciones y proyectos múltiples en SSDT, vea Reporting Services en SQL Server Data Tools (SSDT).

Orígenes de datos compartidos y conjuntos de datos compartidos

SSDT proporciona una manera de definir e implementar orígenes de datos compartidos y conjuntos de datos compartidos para una solución de informes.

  • Para implementar un origen de datos compartido independientemente de otros elementos de un proyecto, puede usar las propiedades OverwriteDataSources y TargetDataSourceFolder.
  • Para implementar un conjunto de datos compartido independientemente de otros elementos de un proyecto, puede usar las propiedades OverwriteDatasets y TargetDatasetFolder.

Para más información, vea Establecer propiedades de implementación (Reporting Services).

En el Diseñador de informes, se trabaja en el panel Datos de informe y en el Explorador de soluciones para definir los orígenes de datos y los conjuntos de datos compartidos que usa en un informe. Para más información, consulte panel Datos de informe.

Si un origen de datos está publicado en un servidor de informes o en un sitio de SharePoint, pero no incluido en la solución de SSDT, no puede usar SSDT para abrir ese origen de datos. De forma similar, no puede usar SSDT para abrir los conjuntos de datos publicados directamente desde un servidor de informes o un sitio de SharePoint. Para abrir un origen de datos o un conjunto de datos en estos escenarios, puede usar Report Builder. Para obtener más información, consulte Entorno de creación del Generador de informes (SSRS). En el caso de los conjuntos de datos, use ese entorno en modo de conjunto de datos compartido.

SSDT es una herramienta cliente. Puede usarlo para:

  • Probar la solución de informes localmente en el equipo.
  • Probar la solución de servidor mediante la implementación de la solución de informes en un entorno de prueba.
  • Implementar una solución de informes en un entorno de producción.
  • Ayudar a crear y probar los resultados de la consulta localmente mediante las funcionalidades de vista previa de los diseñadores de consultas de SSDT.

Después de la implementación:

Para más información sobre cómo incluir orígenes de datos en informes paginados, consulte Creación de cadenas de conexión de datos en Report Builder.

Informes paginados

Los informes paginados son archivos que se almacenan en un proyecto de informe. Puede usar un archivo de informe paginado como un informe independiente, un subinforme o como destino para las acciones de obtención de detalles de los informes principales. Para implementar un informe independientemente de otros elementos de un proyecto, puede usar la propiedad TargetReportFolder y otras propiedades. Para más información, vea Establecer propiedades de implementación (Reporting Services).

Nota:

Si publica en un servidor de informes en modo de SharePoint, no puede probar algunas características de solución de informes en el proyecto de Diseñador de informes. Las referencias a los informes, subinformes e informes detallados solo deben usar las direcciones URL completas que se probaron una vez que se implemente el proyecto de informe. Para obtener más información, vea Ejemplos de dirección URL para los elementos de un servidor de informes: modo de SharePoint.

Si instala la extensión SSRS en Visual Studio, como se explicó anteriormente en Instalación de SSDT, puede usar la plantilla de proyecto del servidor de informes para crear un nuevo proyecto. A continuación, puede agregar informes a un proyecto de las maneras siguientes:

  • Utilice el Asistente para informes. Se puede crear un informe de forma gradual dirigida. El Asistente para informes simplifica la definición de datos y el diseño de un informe, con una serie de pasos que dan como resultado un informe terminado. Puede agregar estilos para personalizar el asistente para su propia organización. Para obtener más información, vea Agregar un nuevo informe mediante el Asistente para informes.

  • Agregue un nuevo elemento de tipo informe. Se abre un informe en blanco en el Diseñador de informes. Para más información, vea Agregar un nuevo informe en blanco.

  • Agregar un elemento existente. Se abre un archivo de definición del informe existente (.rdl) en el Diseñador de informes. Al abrir un informe o un proyecto desde una versión anterior de SSRS puede actualizar automáticamente el proyecto a la versión actual y el informe al esquema actual. Para más información, consulte Actualizar informes (SSRS).

  • Importar un informe de Microsoft Access El proceso de importación importa todos los informes de una base de datos de Access (.mdb, .accdb) o el archivo de proyecto (.adp). El Diseñador de informes convierte cada informe de una base de datos o archivo de proyecto en lenguaje RDL (Report Definition Language) y lo guarda en el proyecto de informe. No todas las funcionalidades de un informe de Access se transfieren a un archivo de definición del informe (.rdl). Para más información, vea Importar informes desde Microsoft Access (Reporting Services).

    Nota:

    Para poder usar la característica de importación, debe tener instalado Access 2002 o una versión posterior en el mismo equipo donde está instalado el Diseñador de informes. El origen de datos de los informes de Access debe estar disponible cuando se importan los informes.

  • Trabaje directamente en un archivo RDL. El informe se guarda en formato XML como un archivo RDL. Este archivo se puede modificar en el Diseñador de informes, en un editor de texto o en cualquier editor de XML.

    Cuando modifica el origen de la definición del informe en el Diseñador de informes, trabaja en el esquema actual de RDL para la versión de SQL Server desde la que instaló las herramientas de desarrollo. Al compilar un proyecto, la versión de esquema puede cambiar según las propiedades de implementación. Para obtener más información, vea Implementación y compatibilidad de versiones en SQL Server Data Tools (SSDT).

    Si modifica el archivo RDL directamente, es posible que el informe resultante no se pueda publicar en el servidor de informes o no se pueda ejecutar. Como en cualquier archivo XML, asegúrese de codificar correctamente los caracteres específicos de XML que usa en los elementos. Cuando se publica el informe, el servidor de informes usa el esquema para validar el código XML del archivo RDL.

    Para incluir elementos que no forman parte del esquema RDL, colóquelos en un elemento personalizado. Las extensiones de representación personalizadas pueden leer elementos personalizados. Sin embargo, las extensiones de representación que proporciona SSRS omiten el elemento. Por ejemplo, puede usar un elemento personalizado para almacenar comentarios en el informe.

    Para más información, vea Lenguaje RDL (Report Definition Language) (SSRS).

Elementos de informe

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.

En Diseñador de informes, puede crear tablas, gráficos y otros elementos de informe paginados en un proyecto. Después de crearlos, puede publicarlos como elementos de informes en un servidor de informes o en un sitio de SharePoint integrado con un servidor de informes. Esta acción permite a usted y a otros reutilizarlos en otros informes. Para obtener más información, vea Elementos de informe en el Diseñador de informes (SSRS).

Para implementar elementos de informe independientemente de otros elementos de un proyecto, puede usar la propiedad TargetReportPartFolder y otras propiedades. Para más información, vea Establecer propiedades de implementación (Reporting Services).

Recursos

Puede agregar al proyecto archivos relacionados con el informe, pero no procesados por el servidor de informes. Por ejemplo, puede agregar imágenes o puede agregar archivos de formas de Environmental Systems Research Institute, Inc. (ESRI) para datos espaciales. Para obtener más información, consulte Recursos.

Diseño de informe paginado

Para crear el diseño del informe, arrastre los elementos del informe y las regiones de datos desde el cuadro de herramientas del Diseñador de informes hasta la superficie de diseño y organícelos. Al arrastrar los campos de conjunto de datos a los elementos en la superficie de diseño, puede agregar datos al informe. Para organizar los datos en grupos dentro de una región de datos Tablix, arrastre los campos de conjunto de datos hasta el panel de agrupación. Dado que las herramientas de creación de informes son básicamente una manera de crear definiciones de informe, el enfoque del diseño de informe es similar en el Generador de informes y el Diseñador de informes.

Vista previa de un informe paginado

Puede usar la Vista previa para comprobar los datos del informe y el diseño del informe. Al obtener la vista previa de un informe, el procesador de este valida el esquema de definición del informe y la sintaxis de sus expresiones. También enumera los problemas en la ventana de salida.

Nota:

Cuando se obtiene una vista previa de un informe, los datos de ese informe se almacenan en la caché en un archivo del equipo local. Cuando se obtiene de nuevo una vista previa del mismo informe mediante la misma consulta, los mismos parámetros y las mismas credenciales, el Diseñador de informes recupera la copia en caché en lugar de volver a ejecutar la consulta. El archivo de datos se guarda como <report-name>.rdl.data en el mismo directorio que el archivo de definición de informe. El archivo no se elimina cuando se cierra el Diseñador de informes.

Puede obtener una vista previa de un informe de varias maneras:

  • Mostrar la Vista previa. Si selecciona la pestaña Vista previa, el informe se ejecuta localmente. Usa la misma funcionalidad de procesamiento y representación de informes que proporciona el servidor de informes. El informe que se muestra es una imagen interactiva. Puede seleccionar parámetros, seleccionar vínculos, ver el mapa del documento, así como expandir y contraer las áreas ocultas del informe. También puede exportar el informe con cualquiera de los formatos de representación instalados.

  • Vista previa independiente. Puede ejecutar el informe local en un navegador. Con una configuración de depuración, también puede usar este modo para depurar los ensamblados personalizados que escriba. Existen tres modos de ejecutar un proyecto en modo de depuración:

    • En el menú Depurar, puede seleccionar Iniciar depuración.
    • En la barra de herramientas estándar de Visual Studio, puede seleccionar el botón Inicio.
    • Puede seleccionar F5.

    Si utiliza una configuración de proyecto que genera el informe pero no lo implementa, el informe especificado en la propiedad StartItem de la configuración actual se abrirá en una ventana de vista previa distinta.

    Nota:

    Para usar el modo de depuración, debe establecer un elemento de inicio. Para establecer un elemento de inicio, vaya a Explorador de soluciones, haga clic con el botón derecho en el proyecto de informe y seleccione Propiedades. A continuación, en StartItem, seleccione el nombre del informe que se va a mostrar.

    Si desea obtener una vista previa de un informe determinado que no es el elemento de inicio del proyecto, puede seleccionar una configuración que compile el informe, pero no la implemente. Por ejemplo, puede usar la configuración DebugLocal. A continuación, haga clic con el botón derecho en el informe y seleccione Ejecutar. Debe seleccionar una configuración que no implemente el informe. De lo contrario, el informe se publica en el servidor de informes en lugar de mostrarlo localmente en una ventana de vista previa.

  • Vista previa de impresión. La primera vez que se ve un informe en el modo de vista previa o en la ventana de vista previa, la vista del informe se asemeja a un informe que genera la extensión de representación en HTML. La vista previa no es HTML, pero el diseño y la paginación del informe son similares a la salida con formato HTML.

    Para cambiar la vista de manera que represente un informe impreso, cambie al modo de vista previa de impresión. Al seleccionar Vista previa de impresión en la barra de herramientas Vista previa, el informe se muestra como si estuviera en una página física. Esta vista se asemeja a la salida que se obtiene mediante las extensiones de representación en imágenes y en PDF. La vista previa de impresión no es un archivo de imagen ni un archivo PDF, pero el diseño y la paginación del informe son similares a la salida con estos formatos. Puede elegir el tamaño de la imagen del informe, por ejemplo, y establecer el ancho de la página.

    La vista previa de impresión le ayuda a identificar los problemas de representación que podría encontrar si imprimiera el informe. Entre los problemas de representación comunes se incluyen:

    • Páginas en blanco adicionales porque el informe es demasiado ancho para el tamaño de papel especificado para el informe.
    • Páginas en blanco adicionales porque el informe contiene una matriz que se expande dinámicamente y supera el ancho del papel especificado.
    • Saltos de página entre grupos que no funcionan de la manera deseada.
    • Encabezados y pies de página que no aparecen como se esperaba.
    • Diseños de informes que necesitan modificaciones para que aparezcan mejor en un formato impreso.

Guardado e implementación de informes paginados

En el Diseñador de informes, puede guardar informes y otros archivos del proyecto localmente o implementarlos en un servidor de informes o en un sitio de SharePoint. Los orígenes de datos compartidos, conjuntos de datos compartidos, informes, recursos de informes y elementos de informe se pueden implementar de forma independiente o conjuntamente en función de las propiedades de implementación del proyecto que configure. Para más información, consulte Propiedades de configuración e implementación.

En el Diseñador de informes, diseñe un informe mediante el esquema de definición del informe que admite la versión actual de SSRS en SSDT. Puede establecer las propiedades de implementación del proyecto para un servidor de informes específico o un sitio de SharePoint. Cuando guarda el informe, el Diseñador de informes guarda la definición de informe en el directorio de compilación del esquema que coincide con la versión del servidor de informes de destino. Para crear informes que se pueden publicar en un servidor de informes que usa una versión anterior de SSRS, el Diseñador de informes quita los elementos de informe que no existen en el esquema de destino. Esto ocurre automáticamente y sin pedir confirmación. Cuando esto sucede, la definición de informe original se mantiene en la carpeta del proyecto. La definición del informe modificada que implementa el Diseñador de informes está en la carpeta de compilación.

Nota:

Para depurar expresiones y errores de implementación, debe visualizar la definición de informe en la carpeta de compilación. No use Ver código en el menú contextual del archivo de informe para ver la definición del informe en este caso. Al seleccionar Ver código, abra el origen de la definición del informe desde la carpeta del proyecto.

Para obtener más información, vea Implementación y compatibilidad de versiones en SQL Server Data Tools (SSDT).

Guardar un informe localmente

Cuando trabaje en informes u otros elementos de proyecto en el Diseñador de informes, los archivos se guardarán en el equipo local o en un recurso compartido de archivos de otro equipo al que tenga acceso.

Si usa el software de control de código fuente, al guardar un informe podría comprobarlo en el servidor de control de código fuente. Para obtener más información, consulte Control de código fuente.

Implementación o publicación de informes paginados

En SSDT, puede implementar informes u otros elementos de proyecto en varias versiones de los servidores de informes de SSRS. Use las configuraciones de proyecto para controlar la actualización de las definiciones del informe en las versiones de esquema compatibles con los servidores de informes de destino. Las configuraciones de proyecto controlan algunas propiedades, entre las que se incluyen el servidor de informes de destino, la carpeta donde el proceso de compilación almacena temporalmente las definiciones del informe para la vista previa e implementación, y los niveles de error. Para más información, vea Propiedades de configuración e implementación y Establecer propiedades de implementación (Reporting Services).

Exportación de un informe a un formato de archivo diferente

Los informes se pueden exportar a varios formatos. Estos formatos determinan el funcionamiento de algunas de las características interactivas y de diseño del informe. Para más información sobre las consideraciones de diseño de varios formatos de salida, vea Exportación de informes paginados (Generador de informes).

Validación de informes y niveles de error

Los informes se validan antes de la vista previa y durante la implementación. Se pueden producir varios problemas al compilar los informes. Por ejemplo, los informes pueden contener cadenas como expresiones o consultas que son incompatibles con la versión de SSRS que la configuración de proyecto especifica.

Use la propiedad ErrorLevel para administrar las advertencias y los errores de compilación. Puede asignar un valor de 0 a 4 (ambos incluidos) a la propiedad ErrorLevel. El valor determina qué problemas de generación se notifican como errores y cuáles como advertencias. El valor predeterminado es 2. Las advertencias y los errores se escriben en la ventana de salida de SSDT.

Los problemas con niveles de gravedad menores o iguales que el valor ErrorLevel se notifican como errores. Otros problemas se notifican como advertencias.

En la tabla siguiente se enumeran los niveles de error.

Nivel del error Descripción
0 Problemas de compilación más graves que impiden la vista previa y la implementación de los informes.
1 Problemas de compilación graves que cambian el diseño del informe drásticamente.
2 Problemas de compilación menos graves que cambian el diseño del informe significativamente.
3 Problemas de compilación poco importantes que cambian el diseño del informe de una manera insignificante que podría no ser apreciable.
4 Advertencias sobre problemas de publicación

Puede intentar previsualizar o implementar un informe que contenga elementos de informe que no se admiten en la versión de SSRS. Pero esos elementos de informe a veces se quitan del informe y se emite un error de nivel 2. Si la propiedad ErrorLevel se establece en el valor predeterminado de 2, se produce un error en la compilación en este caso.

Para solucionar este problema, cambie el valor ErrorLevel a 0 o 1. A continuación, cuando se quita el elemento, se emite una advertencia y el proceso de compilación continúa.

Contenido relacionado