1.概述
1.1 版本
| 报表服务器版本 | JAR 包 |
|---|---|
| 10.0.12 | 2020-12-28 |
1.2 应用场景
大部分系统生成的 Log 文件都是文本文件，例如网站的浏览访问量，每个页面的停留时间等等。
那么报表系统对文本文件的分析就必不可少。用户可以通过服务器数据集导入文本文件作为数据源。
1.3 功能简介
文本数据集，就是指数据源是一系列的 TXT 文本文件。
管理员可以将这些文件作为数据来源，用 FineReport 来呈现这些数据，并做相应的数据分析。
2. 准备文本文件
TXT 文件的内容由「文本」和「分隔符」构成。
支持的文本编码类型有：GBK、BIG5、ISO-8859-1、UTF-8、UTF-16、EUC_JP、EUC_KR、CP850。默认为空。
支持的文本分隔符有：制表符、空格、逗号、其他自定义分隔符。默认为空格。
例如：准备的文本文件如下，编码格式为无，分隔符为逗号。
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
3. 添加权限
超级管理员默认可从数据决策系统添加服务器数据集。普通用户如需添加，需要超管授予权限。
超级管理员登录数据决策系统，点击「管理系统>权限管理>全局设置」，打开「分级授权」和「数据连接控制」，点击「保存」。如下图所示：
超级管理员登录数据决策系统，点击「管理系统>权限管理>权限配置」，选择权限载体「部门/角色/用户」，选择具体项，打开「管理系统>数据连接>查看权限」。如下图所示：
4. 调用文本文件
服务器数据集支持三种方法调用文本文件，用户可根据自身情况进行选择。
1）服务器文件：文本文件存储在报表工程的%FR_HOME%\webroot\WEB-INF\reportlets目录下。
2）本地文件：文本文件存储在用户电脑上，调用后自动存储至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets\txt目录下。
3）远程 URL 文件：文本文件存储在某个服务器端，调用该文件的访问 URL 即可。
4.1 服务器文件
将第 2 章准备的文本文件上传至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets目录下。如下图所示：
拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：
1）设置数据集名称，名称不可为空，不可与已有数据集重复。
2）选择文件类型为 TXT。
3）文件来源选择「服务器文件」，选择 reportlets 目录下的文本文件。
4.2 本地文件
本地文件上传前，需要关闭「管理系统>安全管理>安全防护>文件上传校验」，否则上传按钮灰化。如下图所示：
拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：
1）设置数据集名称，名称不可为空，不可与已有数据集重复。
2）选择文件类型为 TXT。
3）文件来源选择「本地文件」，选择本地电脑准备好的文本文件。上传成功后跳出提示框：TXT上传成功！
已上传的文件自动存储至报表工程的%FR_HOME%\webroot\WEB-INF\reportlets\txt目录下。如下图所示：
注：若该目录下存在同名文件，则无法成功上传。
4.3 远程 URL 文件
将文本文件存储在某个服务器下，获得该文件的访问 URL。
注：请确保报表工程可成功访问该文件，否则将调用失败。
拥有权限的用户登录报表工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：
1）设置数据集名称，名称不可为空，不可与已有数据集重复。
2）选择文件类型为 TXT。
3）文件来源选择「URL」，输入 URL 地址，点击「测试连接」。连接成功后跳出提示框：连接成功！
注：URL地址中若包含中文，必须先进行 URL转码 ，在平台填写转码后的路径，方可正常访问。
5. 数据集设置
1）用户可自定义设置数据集函数。
2）用户可选择文本的编码类型。
3）用户可选择调用的文本文件第一行是否包含标题。
4）用户可选择文本文件的分隔符。
5）若存在连续分隔符，用户可选择将连续分隔符视为单个处理。
点击保存，即保存服务器数据集。