查询分析控件
本章主要介绍DQL明细查询控件、DQL分组分析控件和和Dashboard分析控件的原理、用途及详细说明。
原理和用途：
通过定义tag标签的属性及其值，在不需用户调用润乾报表API情况下，用Tag标签完成对数据的查询与解析运算，并按用户配置的属性要求将html文件流输出到客户端。
DQL 明细查询控件详细说明
实例请参考《分析教程》基础查询章节
html 明细查询界面在 JSP 文件中用<prefix: detailQuery>标签展示， prefix 是用户在 JSP 文件头指定 tag 定义文件时指定的前缀名。该定义语句如下所示：
<%@ taglib uri="/WEB-INF/raqsoftQuery.tld" prefix="raqsoft" %>
此定义语句必须写在 JSP 的开头，其中 prefix 的值可以自己指定，但tag 标签中的前缀必须与其保持一致。
然后在要展现界面的地方用上面介绍的 tag 标签来发布，如：
<raqsoft:detailQuery name=”…”…./>
此标签的属性说明见下表：
(属性名都是大小写相关，属性值必须放在双引号中)
|
属性名 |
是否必填 |
属性含义 |
属性取值 |
默认值 |
|
qyx |
否 |
指定绝对路径或相对路径下的qyx文件或qyx文件内容 |
见注1 |
|
|
dataSource |
否 |
数据库数据源 |
数据源名称 |
|
|
sqlType |
否 |
设置写有适应不同数据源过滤语句语法的.properties |
|
default |
|
visibility |
否 |
设置可视文件.vsb |
见注1 |
|
|
dictionary |
否 |
设置字典文件.dct |
见注1 |
|
注1：使用相对路径时是相对【应用根目录】/WEB-INF/guideConf.properties的取值：
注2：qyx和dataSource属性名必须存在其中一个不为空，当qyx存在时，dataSource设置无效。
DQL 分组分析控件详细说明
实例请参考《分析教程》基础分析章节
html分析界面在JSP文件中用<prefix: analysev2>标签展示，prefix是用户在JSP文件头
指定tag定义文件时指定的前缀名。该定义语句如下所示：
<%@ taglib uri="/WEB-INF/raqsoftAnalyse.tld" prefix="raqsoft" %>
此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。
然后在要展现界面的地方用上面介绍的tag标签来发布，如：
<raqsoft:analysev2 name=”…”…./>
此标签的属性说明见下表：
(属性名都是大小写相关，属性值必须放在双引号中)
注1：使用相对路径时是相对【应用根目录】/WEB-INF/guideConf.properties的取值：
Dashboard 分析控件详细说明
html DBD分析界面在JSP文件中用<prefix: dashboard>标签展示，prefix是用户在JSP文件头
指定tag定义文件时指定的前缀名。该定义语句如下所示：
<%@ taglib uri="/WEB-INF/raqsoftAnalyse.tld" prefix="raqsoft" %>
此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。
然后在要展现界面的地方用上面介绍的tag标签来发布，如：
<raqsoft:dashboard name=”…”…./>
此标签的属性说明见下表：
(属性名都是大小写相关，属性值必须放在双引号中)
|
属性名 |
是否必填 |
属性含义 |
属性取值 |
默认值 |
|
olap |
否 |
相对于应用根目录的olap文件或olap文件内容 |
见注1 |
|
|
dbd |
否 |
相对于应用根目录的dbd文件或dbd文件内容 |
见注1 |
|
|
dataSource |
否 |
数据库数据源 |
数据源名称 |
|
|
ql |
否 |
查询语句 |
sql或dql语句 |
|
|
splFile |
否 |
相对于应用根目录的spl文件 |
见注1 |
|
|
splScript |
否 |
spl脚本 |
|
|
|
splParams |
否 |
spl参数，多个参数用逗号隔开 |
|
|
|
inputFiles |
否 |
指定要分析的填报文件(.json)，相对于应用根目录，多个以分号隔开 |
|
|
|
reportPage |
否 |
设置用来展现报表用的界面 |
|
|
|
maxDataSize |
否 |
报表数据集最大记录数（明细数据集或分组聚合后的数据集），超出这个数量的数据将不被处理，得到的是不完整结果 |
|
10000 |
|
maxReportSize |
否 |
报表最大容量（最细粒度左表头数量*最细粒度上表头数量），超出这个数量报错，不能生成报表，提示减少分组/弃用交叉报表重新生成报表 |
|
50000 |
|
olapFolderOnServer |
否 |
服务器上olap文件的根目录 |
见注1 |
WEB-INF/files/olap/ |
|
dataFolderOnServer |
否 |
服务器上缓存数据文件的根目录 |
见注1 |
WEB-INF/files/data/ |
|
splFolderOnServer |
否 |
服务器上spl文件的根目录 |
见注1 |
WEB-INF/files/spl/ |
|
inputFileFolderOnServer |
否 |
服务器上填报数据文件(.json)的根目录 |
见注1 |
WEB-INF/files/inputFile/ |
|
rpxFolderOnServer |
否 |
服务器上报表模板的根目录 |
见注1 |
WEB-INF/files/rpx/ |
|
resultRpxPrefixOnServer |
否 |
服务器上保存结果报表文件的文件前缀 |
当设置"/WEB-INF/files/resultRpx/user1_"时，user1_是文件名的一部分，不是目录 |
WEB-INF/files/resultRpx/ |
|
fixedTable |
否 |
使用报表DQL Server类型的数据源时，指定需要分析的表名（多个表以逗号分隔） |
|
|
|
dimDataOnServer |
否 |
维值数据，多层的维会自动生成树状数据 |
|
WEB-INF/files/data/temp/dimData.json，没有这个文件时，根据当前DQL数据源自动生成，生成后用户可以根据自己的需求自己再修改这些数据 |
|
dataFileType |
否 |
缓存数据文件类型 |
text或者binary。text采用全内存操作，默认text；binary采用游标操作，需使用含有集文件功能点的润乾报表授权 |
text |
|
styleRpx |
否 |
自定义报表显示样式的rpx文件，通过修改这个rpx里的样式改变分析报表的默认样式 |
|
WEB-INF/files/style.rpx，路径相对于应用根目录 |
注1：使用相对路径时是相对【应用根目录】/WEB-INF/guideConf.properties的取值：