表格软件FineReport教程：[8]文件数据集

文件数据集是指以txt文本文件、Excel文件和XML文件中的数据为数据集，将这些文件中的数据加载进行，并以二维表的结构展示在数据集当中，以供模板使用，下面就通过表格软件FineReport来简单介绍一下。

工具/原料

表格软件FineReport7.1.1

大小：148.2M 适用平台：windows/linux

文本数据集

1、文本数据集，就是指数据源是一系列的文本文件。如：噩荜务圃网站的浏览访问量，每个页面的停留时间等等，这种系统生芤晟踔肿成的log文件一般来说都是文本文件。而我们就是要将这些文件作为数据来源，用FineReport来呈现这些数据，并做相应的数据分析。假设当前报表环境\WebReport\WEB-INF\reportlets目录下已经存在datasource.txt，其内容如下，下面我们来看下文本数据集的制作步骤：Name,Capital,Continent,Area,Population Argentina,Buenos Aires,South America,2777815.00,32300003.00 Bolivia,La Paz,South America,1098575.00,7300000.00 Brazil,Brasilia,South America,8511196.00,150400000.00 Canada,Ottawa,North America,9976147.00,26500000.00 Chile,Santiago,South America,756943.00,13200000.00 Colombia,Bagota,South America,1138907.00,33000000.00 Cuba,Havana,North America,114524.00,10600000.00 Ecuador,Quito,South America,455502.00,10600000.00 El Salvador,San Salvador,North America,20865.00,5300000.00 Guyana,Georgetown,South America,214969.00,800000.00 Jamaica,Kingston,North America,11424.00,2500000.00 Mexico,Mexico City,North America,1967180.00,88600000.00 Nicaragua,Managua,North America,139000.00,3900000.00 Paraguay,Asuncion,South America,406576.00,4660000.00 Peru,Lima,South America,1285215.00,21600000.00 United States of America,Washington,North America,9363130.00,249200000.00 Uruguay,Montevideo,South America,176140.00,3002000.00 Venezuela,Caracas,South America,912047.00,19700000.00

2、定义文本数据集下面我们来为大家介绍下如何定义文本数据集。点击数据集下面的加号，选择文件数据集，如下图：

3、然后弹出文件数据集对话框，将文件类型选择：Txt，点击本地文件后面的选择按钮，选择已经存在的datasource.txt文件，然后按照下图进行设置：注：上述txt中数据之间的分隔符是逗号，故在上面面板选项中的分隔符需要选择逗号。

4、选择文本后，会弹出文本数据集对话框，选择对应的文件目录，文件名称，具体设置如下图：点击预览可以看到数据如下：

5、设置完后，可以看到模板数据集中会增加一个名为'File1'的数据集，如下图：

Excel数据集

1、Excel数据集，就是指数据源是一系列的xl衡痕贤伎s文件。而我们就是要将这些文件作为数据来源，用FineReport来呈现这些数据，并做相应的剞麽苍足数据分析。假设当前报表环境\WebReport\WEB-INF\reportlets目录下已经存在datasource.xls，其内容如下，下面我们来看下文本数据集的制作步骤：

2、定义Excel数据集下面我们来为大家介绍下如何定义Excel数据集。点击数据集下面的加号，选择文件数据集，如下图：

3、然后弹出文件数据集对话框，将文件类型选择：Excel，点击本地文件后面的选择按钮，选择已经存在的datasource.xml文件，然后按照下图进行设置：

4、点击预览可以看到数据如下：

5、设置完后，可以看到模板数据集中会增加一个名为'File1'的数据集，如下图：注：Excel数据集默认不支持Excel2007及以上版本，如果要使用Excel2007及以上版本，需要导入poi2007_fat.jar至%FR_HOME%\WebReport\WEB-INF\lib 下，导入完成之后重启设计器。

6、动态的Excel数据集在文件数据集中选择Excel，然后按照下图进行设置：双击定义好的File1数据集，会弹出参数输入框，输入已经存在的excel文件名称datasource，其效果和上图的设置后效果相同。

7、远程Excel数据集在报表中无法直接调用Excel数据集，需要通过jsp中调用对应的Excel文件，然后通过URL访问的方式调用对应的jsp文件便可将对应的excel文件作为数据集。

XML数据集

1、XML数据集，就是指数据源是一系列的xml文件。而我们就是要将这些文件作为数据来源，用FineReport来呈现这些数据，矣喾动痞并做相应的数据分析。假设当前报表环境\WebReport\WEB-INF\reportlets目录下已经存在frtest.xml.，其内容如下，下面我们来看下文本数据集的制作步骤：

2、定义文件数据集下面我们来为大家介绍下如何定义文件数据集。点击数据集下面的加号，选择文件数据集，如下图：

3、选择xml文件然后弹出文件数据集对话框，将文件类型选择：xml，点击本地文件后面的选择按钮，选择已经存在的frtest.xml文件，右侧的关键节点面板即会自动刷新获取xml中的所有节点信息，并将节点以树状结构的形式显示出来，如下图：

4、注：若一节点，有多个同名同级子节点，但各个子节点的叶子节点不同（存储数据的节点标志），取叶子节点的并集，如下图所示：另：如果xml数据集中有2个根节点，那么FineReport会自动在顶部添加一个没有名字的空根节点。

5、节点选择FineReport的xml文件数据集支持将文件中的所有节点以树状结构显示出来，但是不能像存储过程一样返回多个结果集，将每个节点的数据均显示在一个数据集中，一次只能返回一个子节点中的所有数据，想要显示哪个子节点的信息就选中该子节点即可，最后数据来源于选中节点的子节点、子节点的子节点直至叶子节点。其返回数据集中的数据遵循以下五个规则：1、选中节点只有叶子节点，则叶子节点的并集为数据集字段；

6、选中节点只有一个非叶子节点的子节点，则此子节点的叶子节点为数据集字段，如选中PickDetail，效果与选中PrintPickDetailEntity一致；

7、选中节点有多个子节点（非叶子节点），此时按第一个子节点来计算。如选中pactDetail，有多个子节点（PrintPackEntity和Other），此时按照第一个子节点“PrintPackEntity”来计算

8、选中节点既有叶子节点，又有普通子节点（非叶子节点），此情况为一对多，(其中叶子节点为“一”，普通子节点的叶子节点为“多），则数据集字段为所有叶子节点加第一个普通子节点的叶子节点，数据内容：其中“一”跟随“多”来扩展，如选中根节点PickBillPrintEntity，他有三个叶子节点和两个子节点（pickDetail和PacDetail，选第一个），数据如下图，显示其三个叶子节点和第一个子节点中的数据：

9、若同一叶子节点有多个值，用“；”隔开，如下图，author这个字段的值为：James McGovern;Per Bothner;Kurt Cagle;James Linn;Vaidyanathan Nagaraian。注：必须选中一个节点，不选中节点，点击确定，预览为空。

10、示例中只有一个子节点Customers，我们这里选中父节点frtest，子节点Customers或者叶子节点的任何一个，其返注回的结果都一样，那么就选中Customers子节点，点击预览按钮，如下图：

11、效果查看设置完后，可以看到模板数据集中会增加一个名为'File1'的数据集，如下图：