Crear orígenes de datos para un informe

Artículo
10/07/2008

El modo de procesamiento de un control ReportViewer determina el tipo de datos que podrá utilizar como base del informe.

En el modo de procesamiento remoto, en el que los informes se procesan en un servidor de informes de SQL Server 2005, las extensiones de procesamiento de datos del servidor de informes determinan los tipos de orígenes de datos que puede utilizar. Existen extensiones de procesamiento de datos predeterminadas para SQL Server, Analysis Services, SQL Server Integration Services, Oracle, SAP NetWeaver® Business Intelligence XML, ODBC y OLE DB. Las conexiones con los orígenes de datos y las consultas que recuperan datos para un informe se especifican en una definición de informe en tiempo de diseño durante la creación del informe en Business Intelligence Development Studio (esta es la herramienta de diseño de informes que se incluye en SQL Server 2005). Los campos que devuelve la consulta pueden utilizarse en el diseño del informe arrastrándolos a la superficie de diseño del informe. Para obtener más información sobre cómo trabajar con los datos de un informe de servidor, vea Conectar con un origen de datos (Reporting Services) en los Libros en pantalla de SQL Server.

En el modo de procesamiento local, en el que los informes los procesa el control dentro de la aplicación, puede especificar orígenes de datos y campos de Visual Studio para definir los datos en los que se basa el informe. Las conexiones con el origen de datos y las consultas que recuperan los datos para un informe se definen en el proyecto de aplicación en tiempo de diseño. Un informe de cliente puede utilizar datos de cualquier origen siempre que puedan ser suministrados como un objeto DataTable de ADO.NET o como una colección enumerable de objetos Business. La tabla de datos o el objeto comercial devuelve una lista de campos que pueden utilizarse para el informe. Los campos contienen un puntero a un campo de base de datos y una propiedad de nombre. Puede arrastrar campos desde la ventana Origen de datos hasta el diseño del informe.

Enlazar datos de un informe

Las definiciones de informes utilizan regiones de datos para enlazar datos al informe. Puede elegir entre diversas regiones de datos para admitir distintas estructuras de datos en un informe. Por ejemplo, en una definición de informe puede emplear regiones de datos como las siguientes: tabla, matriz, gráfico y lista. Para enlazar los datos de un informe, debe hacer lo siguiente:

Defina los orígenes de datos y los conjuntos de datos que desea utilizar en el informe (puede emplear la información y los vínculos incluidos en este tema para aprender a hacerlo). La ventana Origen de datos muestra los orígenes de datos y los campos que puede utilizar.
Arrastre las regiones de datos que desea utilizar desde el cuadro de herramientas de informes hasta la superficie de diseño.
Arrastre campos desde la ventana Origen de datos hasta la región de datos.

Cada región de datos puede utilizar campos de un solo conjunto de datos. Ni el control ReportViewer ni el servidor de informes pueden realizar combinaciones entre distintos conjuntos de datos. Por ejemplo, si está utilizando objetos Business, la combinación debe realizarse dentro del objeto Business. Para obtener más información acerca de las regiones de datos, vea Agregar regiones de datos a un informe (Diseñador de informes de Visual Studio).

Cómo agregar orígenes de datos para informes de ReportViewer

Se recomiendan los enfoques siguientes para configurar un origen de datos de manera que pueda ser utilizado en una definición de informe de cliente.

Agregue un origen de datos al proyecto de aplicación y configure la conexión de datos con los datos subyacentes. Para un almacén de datos subyacentes, seleccione los datos específicos que desea utilizar. Los datos que desee utilizar en el informe deben estar disponibles en la ventana Orígenes de datos. Para una tabla de datos, el origen de datos muestra nombres de columna devueltos por una consulta. Para una colección enumerable de objetos Business, el origen de datos muestra una lista de propiedades públicas de tipos de datos simples que expone el objeto Class.
Para crear una tabla de datos, agregue un conjunto de datos al proyecto y utilice el Asistente para la configuración de TableAdapter a fin de configurar la tabla de datos. El Asistente para la configuración de TableAdapter proporciona un generador de consultas y una característica de vista previa de datos para que pueda confirmar los resultados de la consulta inmediatamente.
Para crear objetos Business, utilice el comando Agregar nuevo elemento del menú Proyecto y seleccione el objeto Class. Proporcione implementaciones que expongan propiedades públicas de tipos de datos simples para uso en tiempo de diseño. Proporcione métodos para devolver colecciones enumerables de propiedades para uso en tiempo de ejecución.

Tras la configuración de un origen de datos, los datos enlazables aparecen en una jerarquía, en la ventana Origen de datos. Para enlazar datos a un informe, arrastre los nodos de la jerarquía expandida hasta los cuadros de texto o las regiones de datos en un diseño de informe. Si luego modifica los conjuntos de datos tras la definición de informe, deberá actualizar los enlaces de datos en el informe y control. Para obtener más información, vea Actualizar y reenlazar referencias de orígenes de datos (Diseñador de informes de Visual Studio).

Puede tener cualquier cantidad de orígenes de datos en el proyecto. Para ver la lista de orígenes de datos que realmente utiliza un informe, elija Orígenes de datos en el menú Informe. Para obtener una vista previa del informe y los datos de su aplicación, debe generar o implementar la aplicación para comprobar que el informe contenga los datos esperados. Para obtener más información acerca de la configuración del control y la definición del diseño de informe, vea Configurar ReportViewer para el procesamiento local y Crear archivos de definición de informe de cliente (.rdlc).

Si desea comenzar inmediatamente, utilice las visitas guiadas siguientes para aprender a agregar cada tipo de origen de datos a un proyecto:

Usar objetos Business

Un objeto Business es cualquier aplicación que expone propiedades públicas de tipos de datos simples. Los ejemplos de objetos Business incluyen una colección de objetos Customer provenientes de un almacén de datos subyacentes, una matriz de objetos Book Title que crea la aplicación o una lista de objetos Channel proveniente de un origen RSS XML.

Para que se pueda tener acceso como origen de datos, la colección debe admitir IEnumerable. Los datos enlazables aparecen en una vista jerárquica de la ventana Orígenes de datos. Para los objetos Business, el origen de datos muestra una lista de propiedades públicas de tipos de datos simples que expone el objeto Class. Puede enlazarlos a las regiones de datos y cuadros de texto en una definición de informe.

Para proporcionar una colección de objetos Business, puede agregar una clase o una referencia al ensamblado para una clase del proyecto.

Usar tablas de datos

Una DataTable, como parte de un DataSet de ADO.NET, se puede agregar con facilidad al proyecto desde el menú Proyecto al seleccionar Agregar elemento nuevo. Para configurar la conexión de datos, inicie el Asistente para la configuración de TableAdapter. En el menú Datos, seleccione Agregar y, a continuación, seleccione TableAdapter. También puede definir una consulta para limitar el conjunto de resultados. Una vez finalizado el asistente, se puede tener acceso a las columnas de DataTable a través de la ventana Orígenes de datos de manera que pueda enlazarlas a regiones de datos y cuadros de texto en una definición de informe de cliente.

Definir orígenes de datos para controles de servidor web ReportViewer

Los controles de orígenes de datos proporcionan compatibilidad para extraer el nivel de acceso a los datos de manera que los controles de una página web se enlacen a un origen de datos que, a su vez, se enlaza a los datos reales. Esto le permite cambiar con eficacia el origen de datos sin tener que reenlazar cada control a cada dato.

Cuando está diseñando una página web, la sección Datos del cuadro de herramientas enumera los distintos controles de orígenes de datos, como SqlDataSource y XmlDataSource. Algunos controles de orígenes de datos proporcionan compatibilidad con memoria de página en páginas web y otros controles utilizan datos compartidos. Los informes no utilizan memoria de página y, por lo tanto, la mejor elección para un control de servidor web ReportViewer es utilizar el control ObjectDataSource. Este control proporciona un puente entre los objetos con caché en memoria (colecciones de objetos DataTables o Business) y las regiones de datos del informe. Cuando agrega un control ReportViewer a una página web, se agrega y configura automáticamente un control ObjectDataSource.

Para minimizar la necesidad de escribir un código adicional, la compatibilidad de ASP.NET con páginas web proporciona un procesamiento extra en segundo plano para detectar colecciones que suministran objetos Business enlazables. Cuando agrega una clase al proyecto que devuelve una colección de objetos que se pueden identificar como objetos Business, la colección se agrega automáticamente a la ventana Orígenes de datos de sitios web.

Vea también

Compartir a través de

Crear orígenes de datos para un informe

Enlazar datos de un informe

Cómo agregar orígenes de datos para informes de ReportViewer

Usar objetos Business

Usar tablas de datos

Definir orígenes de datos para controles de servidor web ReportViewer

Vea también

Referencia

Conceptos

Otros recursos

Recursos adicionales