使用查询引擎制作报表案例之二

易语言使用Grid++Report起步教程概述：在本教程中，首先介绍用 Grid++Report 的报表设计器应用程序设计一个简单的清单式报表，我们最后会得到一个与 Grid++Report 例子模板中的‘简单列表.grf’类似的报表模板。

接下来我们学习怎样让‘简单列表.grf’例子模板在易语言程序中运行起来。

首先实现报表的打印与打印预览功能，通过本部分的学习我们可以得到一个类似本教程附带的‘打印与打印预览报表.e’程序。

然后我们学习利用Grid++report 的查询显示器控件实现报表在窗口中的查询显示，我们会创建一个类似本教程附带的‘在查询显示控件中显示报表.e’程序。

通过本教程的学习，你将对 Grid++Report 报表模板设计与在易语言中使用 Grid++Report 有一个初步与直观的了解，开启你用 Grid++Report 在易语言中开发报表的大门，为你更进一步学习奠定了良好的开端。

具备一定的数据库方面的知识对开发报表非常重要，因为报表一般都需要从数据库中取数据,然后由报表工具生成出来，你应该对数据库方面的一些基本概念有所了解，能够写出基本的 SQL 查询语句。

如果你具备这些基础知识，你学习用 Grid++Report 在易语言中开发报表会非常容易，如果你觉得这方面有所欠缺，建议你加强这方面的学习。

本教程适用于第一次接触 Grid++Report 或对 Grid++Report 在易语言中使用还没有入门的易语言开发者。

完成本教程的学习之后，建议你浏览并运行一遍 Grid++Report 自带的全部易语言例子，对 Grid++Report 的功能有所了解。

使用本教程你必须安装易语言的4.0或以上版本。

必须安装 Grid++Report 报表组件，可以去下载最新的 Grid++Report。

为了顺利完成本教程，你应该将 Grid++Report 安装在 C:\Program Files\Grid++Report 3 目录下。

dataBeanList.add(produce("Manisha", "India")); dataBeanList.add(produce("Dennis Ritchie", "USA")); dataBeanList.add(produce("V.Anand", "India")); dataBeanList.add(produce("Shrinath", "California"));
</title>
<columnHeader>
<band height="23">
<staticText>
<reportElement mode="Opaque" x="0" y="3"
width="535"
height="15"
backcolor="#70A9A9" />
<box>
<bottomPen lineWidth="1.0"
try { JasperFillManager.fillReportToFile( sourceFileName, parameters, beanColDataSource);
} catch (JRException e) { e.printStackTrace();
} } } POJO 文件的内 容 C:\tools\jasperreports-5.0.1\test\src\com\yiibai\DataBean.java 如下所 示：

报表数据概述通常开发报表的过程是报表开发者首先用报表设计器设计出报表样式，也即报表模板文件，在 Grid++Report 中模板文件的扩展名通常为.grf。

然后开发者将报表模板应用在自己开发的程序中，并在程序中为报表加载数据，这些数据通常都是动态的，在不同的运行场景下，其产生的报表都不一样。

在设计报表时，通过设置报表的明细数据库查询参数为报表提供明细数据，明细数据通常是有多笔记录的数据，Grid++Report根据明细记录伸展产生报表表格。

根据明细数据库查询参数可以自动创建报表字段。

参考：定义明细数据库连接串与查询SQL。

在设计报表时，通过设置报表的参数数据库查询参数为报表提供参数数据，参数数据通常只有一笔记录数据，Grid++Report也只会应用第一笔记录。

这里所指参数数据不仅仅是指报表参数的数据，同时也包括各种部件框的数据。

根据参数数据库查询参数获取的数据将根据名称匹配方法，自动将字段的数据加载到同名参数或部件框上。

根据参数数据库查询参数可以自动创建报表参数。

参考：定义参数数据库连接串与查询SQL。

报表在运行时，通常会根据不同的场景产生不同的报表数据，这就要求开发者在程序中为报表按场景提供动态数据，如按条件动态构建查询SQL语句，将程序中读到的数据加载到报表中。

后面的主题将就报表动态数据进行说明。

动态设置报表参数数据库连接串与查询SQL在设计时设定的数据库连接串与查询SQL有可能不能适应报表运行时的要求，如软件部署后其数据库连接串很难与设计时一致，而查询SQL也需要根据不同的查询条件进行数据查询，这些情况都需要用程序代码去进行动态设置，其设置代码类同如下：根据参数数据库连接串与查询SQL从数据库查询出来的数据将自动加载到与SQL字段同名的报表参数或部件框中。

如果报表明细记录集上的数据库连接串已经设置，这里的参数数据库连接串可以不设置，在运行时将应用报表明细记录集上的数据库连接串。

用代码设置参数的数据用 ParameterByName 方法根据参数名称找到对应报表参数对象，然后就可以给参数设置各种数据类型的值。

UniEAP™ Report最佳实践之——几种特殊参数的使用方法基础软件事业部东软集团（大连）有限公司更改履历注：状态可以为N-新建、A-增加、M-更改、D-删除目录第1章概述 (3)第2章特殊场景参数的用法 (3)2.1可能为空的参数处理方法 (3)2.2实现in类型的参数 (5)2.2.1方法一 (5)2.2.2方法二 (7)2.3模糊查询的实现方法 (9)2.4如何给checkbox类型的参数传值 (10)第1章概述UniEAP Report的参数有多种类型,可以实现很多复杂的查询条件,如包含关系、模糊查询、自动替换空参数等应用场景。

【注意】本文所述方法不适用于业务制表特性。

第2章特殊场景参数的用法2.1可能为空的参数处理方法参数经常要用到SQL数据集中，在SQL语句中充当条件，甚至充当查询列名。

有些参数要求用户必须填写，为必填参数，有些参数允许用户不填，为非必填参数（可能为空），当存在非必填参数时，使用方法有所不同。

UniEAP Report引擎在处理空参数的逻辑是将该参数所在的条件表达式替换为一个始终为真的表达式,如1=1,但在一些较为复杂的SQL中很难在程序中确定参数所在的完整表达式,当传入参数为空时就可能会出现替换出错的情况,导致SQL无法执行.。

针对这种情况的存在报表提供两种标识符---{# #}和{@ @},手动来标识出一个参数所在的完整条件表达式,在报表引擎发现参数为空时就可以准确的找出这个表达式,并对其进行替换。

简单来说，参数为空时{#... #}在实际运行中被替换为“1=1”，{@...@}在实现运行中被替换为“”。

使用时，可以根据此原则来写SQL语句。

下面用例子说明。

图2-1数据集定义又例如：select * from employee where {# $a=1 #} and {# birthday <to_date($b,’yyyy-MM-dd’) #} {@group by {@ $employeeId,@}{@$name@}@}。