jasperreport教程:[2]报表字段

报表字段是代表数据源和报表模板之间的数据映射元素。

字段可以在报告中的表达式进行组合,以获得所需的输出。报表模板可以包含零个或更多的<field>元素。当声明报表字段,数据源应提供相应的数据到所有在报告模板中定义的字段。

字段声明做如下:

<fieldname="FieldName"class="java.lang.String"/>

name属性

<field>元素的name属性是强制性的。它通过名称引用的报表表达的字段。

class属性

class属性指定的字段值的类名。它的默认值是java.lang.String。

这是可以改变的,以在运行时可用任何类。不论一个报表字段的类型,引擎采用铸造于该 $F{}标记用于报表表达式,从而使手工投射不必要。

字段描述

<fieldDesciption>元素是可选元素。

实现自定义的数据源,例如,当这是非常有用的。我们可以存储一个密钥或一些信息,使用它我们可以在运行时自定义数据源中检索字段的值。通过使用<fieldDesciption>元素而不是字段名,

可以检索从数据源中的字段值时容易克服字段命名约定的限制。

下面是一段代码从我们现有的jrxml文件(第二章报告的设计)。在这里我们可以看到name,class和fieldDescription元素的使用。

<fieldname="country"class="java.lang.String">

<fieldDescription><![CDATA[country]]></fieldDescription>

</field>

<fieldname="name"class="java.lang.String">

<fieldDescription><![CDATA[name]]></fieldDescription>

</field>

排序字段

数据的排序是必要的,数据源实现不支持它(如CSV数据源),JasperReports的支持在内存领域为基础的数据源排序。排序可以使用的报表模板的一个或多个<sortField>元素来完成。

如果指定ATLEAST1排序字段,在报告填充过程中的数据源传递给JRSortableDataSource实例。

这反过来从获取数据源中的所有记录,根据指定的字段进行排序的内存中,并替换原来的数据源。

排序字段名称应该是相同的报表字段名称。

用于排序的字段应该具有实现java.util.Comparable类型。

进行自然顺序排序的所有字段除外java.lang.String类型

(对于字符串类型,对应报告的填充区域自动分页使用)。

当有多个排序字段指定,排序将使用的字段进行中它们出现在报告模板的顺序排序键。下面的例子demonstartes显示排序功能。

同为比较常用的报表工具,FineReport在报表实现过程中所需的代码量远少于jasperreport,大部分的报表代码细节被隐藏,呈现出的是是可视化的设计过程,

在FineReport中,定义好数据源之后,设计器会自动读取数据库中的字段,不需要二次定义,以excel导入行式报表为例进行说明,如下:

1.示例1-位置匹配(7.0.4)

如下图,可以看到Excel中的列标题与FineReport模板的列标题完全不一致,但是位置却保持一致:

注:行式报表根据位置匹配的前提是标题完全匹配不上,如果有一个标配能匹配得上,那么就会使用根据标题匹配。

另:若要导入的是Excel2007需要将poi2007_fat.jar拷贝至%FR_HOME%WebReportWEB-INFlib下。

1.1模板制作

上图中我们可以看到,Excel中第一行数据在B3~K3中,在填报模板中,导入数据的单元格也要在B3~K3,单元格从上到下

1.2报表填报属性设置

在报表填报属性中,只需要将第一行单元格与数据表的数据列进行绑定即可。

该例中,Excel中的原始数据供应商和类别都是具体的名字,若用户希望Excel导入的是名字,但实际入库的是ID怎么办呢?

此时可以在报表填报属性中使用map函数转换,以下具体介绍。

· 定义map函数需要的数据集

增加数据集ds1,SQL语句为:SELECT*FROM[供应商],查询出供应商ID与供应商名字的对应关系;

再增加数据集ds2,SQL语句为:SELECT*FROM[产品类别],

查询出产品类别ID与类别名字的对应关系。

·报表填报属性中使用map函数

Excel导入的是名字,使用map函数转换,如下图: