Cómo utilizar editor de consultas Active Query Builder en el diseñador de informes FastReport.Net

FastReport.Net ofrece a sus usuarios una gran variedad de posibilidades de personalizar su diseñador de informes.

En este artículo vamos a echar un vistazo a cómo remplazar el incorporado editor de consultas SQL por Active Query Builder.

1. Para empezar, tiene que descargar la última versión de Active Query Builder para .Net desde el sitio web del desarrollador: http://www.activequerybuilder.com/. A la fecha de publicación del presente artículo, es la versión 3.4.9.1086. Instale la biblioteca con la ayuda del instalador descargado.
2. Para la demostración, cree una aplicación WindowsForms. Añadimos referencias a las librerias Active Query Builder en el proyecto. Necesitará las siguientes bibliotecas que encontrará en la carpeta con el programa instalado (C:\Program Files\ActiveDBSoft\Active Query Builder 3 .NET\assemblies):

• ActiveQueryBuilder.AdvantageMetadataProvider;
• ActiveQueryBuilder.Core;
• ActiveQueryBuilder.DB2MetadataProvider;
• ActiveQueryBuilder.FirebirdMetadataProvider;
• ActiveQueryBuilder.MSSQLCEMetadataProvider;
• ActiveQueryBuilder.InformixMetadataProvider;
• ActiveQueryBuilder.MSSQLMetadataProvider;
• ActiveQueryBuilder.MySQLMetadataProvider;
• ActiveQueryBuilder.ODBCMetadataProvider;
• ActiveQueryBuilder.OLEDBMetadataProvider;
• ActiveQueryBuilder.OracleMetadataProvider;
• ActiveQueryBuilder.OracleNativeMetadataProvider;
• ActiveQueryBuilder.PostgreSQLMetadataProvider;
• ActiveQueryBuilder.SQLiteMetadataProvider;
• ActiveQueryBuilder.SybaseMetadataProvider;
• ActiveQueryBuilder.UniversalMetadataProvider;
• ActiveQueryBuilder.View;
• ActiveQueryBuilder.View.WinForms;
• ActiveQueryBuilder.View.WPF;
• ActiveQueryBuilder.VistaDB5MetadataProvider.

Además, se necesitarán las siguientes bibliotecas:

• FastReport;
• FastReport.Bars;
• FastReport.Editor.

Ahora añadimos en el proyecto un archivo, complemento para trabajar con ActiveQueryBuilder. Está situado aquí: <J:\Program Files (x86)\FastReports\FastReport.Net\Extras\Misc\ActiveQueryBuilder\ActiveQBForm.cs>.

Para hacerlo, haga clic con el botón derecho en el nombre del proyecto en Solution Explorer y seleccione <Add → Existing Item…>.

Como nuestra aplicación es demo, el formulario tendrá solo un botón:

Ahora creamos un manipulador de eventos de presionar botón haciendo doble clic en este:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

using FastReport.Forms;
using FastReport.Design;
using FastReport;
…
private void button1_Click(object sender, EventArgs e)
 {
 Report report = new Report();
 FastReport.Utils.Config.DesignerSettings.CustomQueryBuilder += new FastReport.Design.CustomQueryBuilderEventHandler(DesignerSettings_CustomQueryBuilder);
 report.Design();
 }
 
 private void DesignerSettings_CustomQueryBuilder(object sender, CustomQueryBuilderEventArgs e)
 {
 using (ActiveQBForm form = new ActiveQBForm())
 {
 form.Connection = e.Connection;
 form.SQL = e.SQL;
 if (form.ShowDialog() == DialogResult.OK)
 e.SQL = form.SQL;
 }
 }

Al presionar el botón se crea un objeto de informe, luego se redirige el llamador de compilador de informes. Invocamos el diseñador de informes.

Debajo hemos creado un llamador de compilador de informes personalizado. Como puede ver, simplemente invocamos el objeto ActiveQBForm añadido al proyecto anteriormente.

Ahora arranque la aplicación. Presionamos el único botón y vemos el diseñador de informes. Si quiere editar el informe existente, después de crear el objeto Report, hay que cargar el informe en este

1

report.Load("С:/Program Files (x86)/FastReports/FastReport.Net/Demos/Reports/Image.frx");

Ahora añada al informe una fuente de datos con el botón:

Para seguir utilizando el complilador de consultas SQL, tenemos que crear una conexión con un SGBD que soporte lenguaje SQL.

En el siguiente paso del asistente para la creación una nueva fuente de datos se nos piede seleccionar tablas de la base de datos que necesitemos.

Pero en la esquina inferior derecha está el botón Add SQL query ... que lanza el asistente para la creación de consultas. En el primer paso de crear una consulta tiene que dar nombre a la nueva vista que resulta de aplicar la consulta que creamos. a

Y en el segundo paso podemos introducir el texto de una consulta SQL a mano.

Sin embargo, en la esquina inferior derecha vemos el botón Query Builder ... que lanzará Report Builder. Presiónelo.

También vemos el compilador de informes que hemos creado a base de ActiveQueryBuilder. Para añadir una tabla al espacio de trabajo, arrástrela desde la área de datos por la derecha. O haga clic con el botón derecho en el espacio de trabajo del compilador y seleccione Add en el menú de contexo:

Manteniendo presionada la tecla Ctrl, seleccione una tabla de la base de datos:

A continuación, presionamos el botón Add Selected Objects y vemos las tablas asociadas en el compilador:

En la pie de la ventana podemos ver el texto de la consulta SQL generado automáticamente. Y en la etiqueta Result, el resultado de la consulta. Digamos que estamos satisfechos con la consulta creada. Para aceptarla, haga clic en el icono verde en la parte superior de la ventana. Para cancelarla, seleccione el icono rojo.

El texto de la consulta SQL que hemos creado se pasa al sistente de consultas:

Finalizamos la creación de la consulta presionando el botón Next y Finish. Asi pues, finalizamos la creación de la fuente de datos.

Ahora en el diseñador de informes aparece una fuente de datos:

De esta manera, hemos utilizado un complemento para remplazar el compilador de consultas SQL normal.