功能树

功能树主要是用来编辑用户访问应用页面后左侧的树形结构，便于用户作导航式访问。可为节点设置用户权限、参数表单、超链接等等。除根节点外，其他节点均可以对用户进行授权，设置权限后可以对用户、机构进行管理，建立多层次的分类管理体系，并且可以控制不同用户、机构的权限，从而保证用户只能看到与自己相关的、被授权的报表信息，可靠地保证了企业的数据和信息安全。

功能树：

使用管理员登录，进入报表中心后，点击(插入子节点)/(同级插入节点)按钮，可在功能树中添加多种类型的节点。

功能树的节点类型包含：

(1)根节点：用户进入系统以后，首先看到的就是此节点关联的报表或一个页面；

(2)分类夹节点：此节点可对各种类型的文件按功能或用途进行分类组织，它本身不关联任何报表或页面链接；

(3)报表/填报表节点：此节点发布设计好的报表/填报表；

(4)统计表节点：此节点发布设计好的统计表；

(5)超链接节点：此节点用来发布系统中的一个页面；

(6)DQL明细查询节点：此节点用来发布对已有报表DQL Server服务做明细查询；

(7)DQL分组分析节点：此节点用来发布源数据，对数据做分组分析；

(8)业务填报节点：此节点用来发布业务填报；

只有前两类节点下可以设置子节点。

根节点

用户进入系统以后，首先看到的就是此节点关联的报表或一个页面，此节点不可以对用户设置访问权限，进入应用的人均可以看到根节点。

 

树名称：为根节点设置要显示的名称。

首页报表：选定点击此节点时要展现的报表/填报表，下拉列表会将报表管理中已上传的所有报表(组)/填报表类型的文件列出。

首页参数表单：选定需要用到的参数表单，参数表单的列表默认会将报表管理中已上传的参数模板文件列出。

缩放比例：设置展现时显示的报表/填报表的大小比例，默认为1.0。

固定表头：是否固定表头，默认为不固定。

固定表头后分页：设置报表/填报表固定表头后是否分页，默认为不分页。

超链接：选择超链接类型，默认首页/自定义/用户在线列表。默认首页代表直接访问程序内置的welcome.jsp页面；自定义代表用户可随意指定要链接的地址；用户在线列表代表直接访问程序内置的onLineUser.jsp，做在线人员统计。

输入url：输入下要访问的url地址。

分类夹

分类夹类型的节点主要用于对报表资源的分类管理，形成节点树，方便用户访问。使用时仅需新建节点选择节点类型为分类夹，然后给出节点名称即可。

报表 / 填报表

这里所说的报表/填报表文件是指已导入到报表中心系统中的文件。添加报表/填报表节点，必须先将报表导入到报表中心中，具体导入方法可参考创建报表小节。导入后可用树节点的方式将报表进行多层次的分类管理。

本章节仅介绍报表/填报表在报表中心的使用，更多关于报表/填报表的制作介绍可参考润乾报表《教程》和《填报教程》。

添加节点后可在节点类型中选择报表/填报表，然后如下图所示，对相应的属性进行配置。

上传：可通过上传按钮上传报表、报表组、填报表、大报表或参数表单，文件类型缺省为报表(组)/填报表、大报表或参数表单，此操作等同于报表管理中的添加操作。文件上传成功后对应报表下拉框和参数表单下拉框中自动列出上传文件。

刷新：通过刷新按钮加载同一时刻从其他地方或其他人上传的报表、报表组、填报表或参数表单。

对应报表：选定点击此节点时要展现的报表/填报表，下拉列表会将报表管理中已上传的所有报表(组)/填报表或大报表类型的文件列出。如报表未通过报表管理上传，还可直接点击上传按钮上传。

打印报表：选定点击此节点时要导出或打印的报表/报表组，相当于设置了printedRaq/printedRpg属性。

参数表单（默认）：选定需要用到的参数表单，参数表单的列表默认会将报表管理中已上传的参数模板文件列出。如参数表单未通过报表管理上传，还可直接点击上传按钮上传。

参数表单（手机端）：选定手机预览报表需要用到的参数表单，参数表单的列表默认会将报表管理中已上传的参数模板文件列出。如参数表单未通过报表管理上传，还可直接点击上传按钮上传。手机预览报表使用的参数模板会优先使用参数表单（手机端），若未设置，则会使用参数表单（默认）。

缩放比例：设置展现时显示的报表/填报表的大小比例，默认为1.0。

Match-report：设置报表显示在matchReport.jsp上，报表会充满界面。

固定表头：是否固定表头，默认为不固定。

固定表头后是否分页：设置报表/填报表固定表头后是否分页，默认为不分页。

树形报表：设置报表以OLAP式报表展现或者树形报表展现。

报表有参数时，可在用户管理设置报表参数，参数名需与报表中的参数名保持一致且唯一。同一张报表不同的用户设置不同的参数值可看到不一样数据。

统计表

添加统计表类型的节点可以对一个或多个文件目录下的填报文件全部进行汇总统计，不过必须保证所选目录下的填报文件结构相同。此处的填报文件是指使用填报表生成的数据文件，如业务填报小节保存的“李芳.json”文件，文件类型可以是.json或.btx二进制文件，btx时需使用含有集文件功能点的润乾报表授权。

例如按照不同权限角色填写的明细数据分别存放在不同的数据文件，使用统计表可以将这些一个或多个目录下的明细数据进行汇总分析。

统计表节点直接链接到一个统计表文件。首先在节点类型中选择统计表，然后如下图所示，对相应的属性进行配置。

上传：可通过上传按钮上传统计表，文件类型缺省为统计表，此操作等同于报表管理中的添加操作。文件上传成功后统计表下拉框中自动选出上传文件。

刷新：通过刷新按钮加载同一时刻从其他地方或其他人上传的统计表。

统计表：选定点击此节点时要展现的统计表，下拉列表会将报表管理中已上传的统计表类型的全部类型。如统计表未通过报表管理上传，还可直接点击上传按钮上传。

统计表中设置的基准表可使用绝对路径和相对路径，相对路径相对于统计表的目录。

选择目录：选择统计表要统计的填报数据文件所在的路径。

下拉中会将raqsoftConfig.xml中<Input/>标签里设置的<home/>目录下的文件夹全部列出。所选目录中必须只有填报文件，且结构一致。

填报文件目录：填报数据文件通常会存放在一个或多个目录，所以为了让选择目录更方便，这里会自动将每次选择的目录逐个追加到填报文件目录编辑框中。

统计文件类型：填报数据文件的类型，分别为json文本格式和binary二进制格式。

注意：所有选择路径中的填报文件必须结构一致。

关于填报数据文件和统计表的制作与使用说明可参考润乾报表《填报教程》业务填报与分析小节。

超链接

功能树除了可以发布各种类型的文件外，还可以将节点设置成超链接。使用超链接时不仅可以任意指定访问地址，还可以选择用户在线列表，便于查看统计当前报表中心在线的用户。

选择节点类型为超链接，然后在给出的下拉选项里进行选择。

超链接：选择超链接类型，自定义/用户在线列表。自定义时用户可随意指定要链接的地址，选择用户在线列表会直接访问程序内置的onLineUser.jsp，做在线人员统计。

用户在线列表：显示在线用户人数及用户名，此功能仅针对统计除超级管理员、管理员和访客外的其他普通用户。

拼接用户名参数：勾选后访问超链接时URL会自动拼接上用户名参数，默认是username，还可以在机构管理à设置处自定义用户名参数名称。

拼接邮箱参数：勾选后访问超链接时URL会自动拼接上邮箱参数email。

拼接手机参数：勾选后访问超链接时URL会自动拼接上手机参数phone。

拼接用户报表参数：勾选后访问超链接时URL会自动拼接当前访问用户的报表参数。

DQL 明细查询

DQL明细查询是指润乾报表WEB应用中内置的查询控件。本节仅介绍在报表中心如何添加明细查询类型的节点。

添加DQL明细查询节点，可通过传递DQL数据库、qyx文件(查询控件保存的文件)、字典等参数在查询分析页面展现对应的明细查询内容。添加DQL明细查询前必须保证报表DQL Server为启动状态，并且已在[安装根目录]/report/web/webapps/demo/WEB-INF/raqsoftConfig.xml中添加报表DQL Server服务类型的数据源。

在节点类型中选择DQL明细查询，然后如下图所示，对相应的属性进行配置。

DQL数据库：选定点击此节点时要展现的报表DQL Server服务。默认会将[安装根目录]/report/web/webapps/demo/WEB-INF/raqsoftConfig.xml中添加报表DQL Server服务类型的数据源全部列出。使用前必须保证报表DQL Server为启动状态。

qyx文件：选定点击此节点时要展现的qyx文件，选定qyx文件后则会忽略DQL数据库、dct文件和vsb文件的设置。不选择qyx文件时页面只呈现查询控件，用户可拖拽表或字段做明细查询。这里用到的qyx文件是指已导入到报表中心系统中的查询文件(qyx)。

dct文件：选定需要用到的字典文件。

vsb文件：选定需要用到的可视文件，可通过可视文件控制用户登录后对报表DQL Server表字段的权限。

表范围：选择DQL数据库后，表范围列表列出DQL数据库中的全部表，选择需要做明细查询的表，可以选择多个表。

注意：更多关于dct(字典文件)、vsb(可视文件)的制作和使用，以及明细查询的使用可参考《分析教程》。

DQL 分组分析

DQL分组分析是用于访问润乾报表WEB应用中内置分析控件，而添加的节点类型。

本节主要介绍在报表中心功能树中如何添加DQL分组分析类型的节点，以及在该节点中对每种分析类型的具体设置方法，方便用户学习如何对各种类型的数据集返回值做分组分析。

节点类型选择“DQL分组分析”，如下图所示，对相应的属性进行配置。

添加DQL分组分析节点时可以选择需要使用的分析类型，为不同的分析类型设置对应源文件即可。

DQL表：

DQL数据库：选择需要使用的报表DQL Server服务，默认会将[安装根目录]/report/web/webapps/demo/WEB-INF/raqsoftConfig.xml中添加报表DQL Server服务类型的数据源全部列出。使用前必须保证报表DQL Server为启动状态。

表范围：选择进入分组分析页面后要显示的表。默认会将DQL数据库中的所有表列出，可以对表范围中的具体表进行单选或多选（按住ctrl键或shift键进行多选）；

分析类型为DQL表的示例可参考多维分析页面小节。

 

填报文件：

需要分析的文件：指定需要分析的填报数据文件。默认会将“查询分析管理”中上传的.json/二进制文件全部列出。

填报文件：对选择的“需要分析的文件”进行多选拼接。

填报文件中的表：会列出填报文件中的多个表，选择一个表来进行数据分析。

分析类型为填报文件的示例可参考分析业务填报数据小节。

 

数据源+查询语句：

数据库：选择需要使用的数据源。默认会将[安装根目录]/report/web/webapps/demo/WEB-INF/raqsoftConfig.xml中添加的数据源全部列出。使用前必须保证数据库为启动状态。

查询语句：填写SQL/DQL语句

 

数据文件：

需要分析的文件：选择需要分析的数据文件，这里使用到的数据文件必须是已经导入到查询分析管理中的文件。文件类型支持txt、xls、xlsx、csv、btx、ctx。ctx和btx需使用含有集文件功能点的润乾报表授权。

 

spl文件(使用集算器设计器制作的后缀为.splx/.spl/.dfx的网格文件，这里简称spl文件)：

需要分析的文件：指定需要分析的spl文件，spl文件中需要使用return函数返回结果集。

spl参数：为spl文件传递参数值（等号后的整数、日期时间类型、字符串等类型不需要加单双引号）。

业务填报

在实际业务应用中用到填报时，如果我们的数据不是来自数据库，并且没有初始数据，也不回填数据库，那么我们就可以使用自动存取数据填报表，这种通常叫做业务填报。

报表中心中可直接在功能树添加业务填报类型的节点，链接到一个业务报表文件，并且还可为填报表设置参数表单等属性。这里所需使用的业务填报文件必须是已导入到报表中心系统中的文件。

在节点类型中选择业务填报，然后如下图所示，对相应的属性进行配置。

上传：可通过上传按钮上传业务填报表，文件类型缺省为业务填报表，此操作等同于报表管理中的添加操作。文件上传成功后对应报表下拉框中自动列出上传文件。

刷新：通过刷新按钮加载同一时刻从其他地方或其他人上传的业务填报表。

对应报表：选定点击此节点时要展现的业务填报表，下拉列表缺省会自动列出报表管理中类型为业务填报的.sht文件。如报表未通过报表管理上传，还可直接点击上传按钮上传。

数据保存类型：设置填报表提交后，系统自动保存的数据文件类型，包括json和binarg二进制类型。

数据保存目录：设置填报表提交的数据文件存放目录。下拉中会将raqsoftConfig.xml中<Input/>标签里设置的<home/>目录下的文件夹全部列出。填报提交的数据自动存放在该目录下与填报表同名的文件夹里，例如节点名称为编辑班级信息，数据保存目录设置为：inputBusinessFiles，则填报数据将会保存在[安装根目录]/report/web/webapps/demo/WEB-INF/reportFiles/inputBusinessFiles/编辑班级信息/下。数据文件以用户名为文件名。