文本 文件数据集

1.1 版本

1.2 应用场景

大部分系统生成的 Log 文件都是文本文件，例如网站的浏览访问量，每个页面的停留时间等等。

那么 BI 系统对文本文件的分析就必不可少。用户可以通过服务器数据集导入文本文件作为数据源。

1.3 功能简介

文本数据集，就是指数据源是一系列的 TXT 文本文件。

管理员可以将这些文件作为数据来源，用 FineBI 来呈现这些数据，并做相应的数据分析。

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

超级管理员默认可从数据决策系统添加服务器数据集。普通用户如需添加，需要超管授予权限。

超级管理员登录数据决策系统，点击「管理系统>权限管理>全局设置」，打开「分级授权」和「数据连接控制」，点击「保存」。如下图所示：

超级管理员登录数据决策系统，点击「管理系统>权限管理>权限配置」，选择权限载体「部门/角色/用户」，选择具体项，打开「管理系统>数据连接>查看权限」。如下图所示：

服务器数据集支持三种方法调用文本文件，用户可根据自身情况进行选择。

1）服务器文件：文本文件存储在 BI 工程的%BI_HOME%\webroot\WEB-INF\reportlets目录下。

2）本地文件：文本文件存储在用户电脑上，调用后自动存储至 BI 工程的%BI_HOME%\webroot\WEB-INF\reportlets\txt目录下。

3）远程 URL 文件：文本文件存储在某个服务器端，调用该文件的访问 URL 即可。

4.1 服务器文件

将第 2 章准备的文本文件上传至 BI 工程的%BI_HOME%\webroot\WEB-INF\reportlets目录下。如下图所示：

拥有权限的用户登录 BI 工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 TXT。

3）文件来源选择「服务器文件」，选择 reportlets 目录下的文本文件。

4.2 本地文件

本地文件上传前，需要关闭「管理系统>安全管理>安全防护>文件上传校验」，否则「本地文件」按钮灰化。如下图所示：

拥有权限的用户登录 BI 工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 TXT。

3）文件来源选择「本地文件」，选择本地电脑准备好的文本文件。上传成功后跳出提示框：TXT上传成功！

已上传的文件自动存储至 BI 工程的%BI_HOME%\webroot\WEB-INF\reportlets\txt目录下。如下图所示：

注：若该目录下存在同名文件，则无法成功上传。

4.3 远程 URL 文件

将文本文件存储在某个服务器下，获得该文件的访问 URL。

注：请确保 BI 工程可成功访问该文件，否则将调用失败。

拥有权限的用户登录 BI 工程，点击「管理系统>数据连接>服务器数据集」，选择「创建数据集>文件数据集」，如下图所示：

1）设置数据集名称，名称不可为空，不可与已有数据集重复。

2）选择文件类型为 TXT。

3）文件来源选择「URL」，输入 URL 地址，点击「测试连接」。连接成功后跳出提示框：连接成功！

注：URL地址中若包含中文，必须先进行 URL转码 ，在平台填写转码后的路径，方可正常访问。

1）用户可自定义设置数据集函数。

2）用户可选择文本的编码类型。

3）用户可选择调用的文本文件第一行是否包含标题。

4）用户可选择文本文件的分隔符。

5）若存在连续分隔符，用户可选择将连续分隔符视为单个处理。

点击保存，即保存服务器数据集。

6.1 本地文件上传失败

问题描述：

本地文件上传失败，提示：XXX文件已经存在，但此时系统「服务器数据集>文件数据集」中未使用该文件。如下图所示：

原因分析：

用户曾经使用本地文件的方法调用过同名文件。

本地文件在调用后会自动存储至 BI 工程，并且在「管理系统>服务器数据集」页面中删除该文件数据集时，不会删除 BI 工程下的该文件。

因此，再次上传时，会因为同名文件的存在而导致上传失败。

解决方案：

前往 BI 工程%BI_HOME%\webroot\WEB-INF\reportlets\txt文件夹下找到原同名文件，删除/重命名原同名文件后，重新上传文件即可。