关于多维分析的集成可使用如下四种方式:
(1) 通过Tag属性的使用来控制界面;可以与官方更新兼容。
(2) 编写javascript代码,修改一些界面控制参数,调用analyseApi里提供的方法执行界面操作;可以与官方更新兼容。
(3) 通过浏览器开发工具观察html元素,通过javascript改变图片和css样式;可以与官方更新兼容。
(4) 直接修改分析模块的js文件,对官方提供的功能进行修改;将失去和官方更新兼容的能力。
官方界面只是分析工具,不具备用户权限系统,客户把分析页面引入到自己的系统后,需要在jsp上部的java代码处根据当前用户准备不同的Tag属性值,达到权限控制的目的。Tag属性详细介绍请参考《程序员参考》中查询分析控件。
示例:
假如客户系统中有两个用户root和guest。root用户权限最大;guest用户只有部分权限,因此两个用户查看的分析文件不同。那么我们就可以通过使用变量传递不同的Tag属性值达到权限控制的目的。
java代码判断,如果当前用户是root则通过Tag属性传递如下值:
String olap = request.getParameter( " olap " );
olap = "WEB-INF/files/olap/ROOT.olap";
如果当前用户是guest则通过Tag属性传递如下值:
String olap = request.getParameter( " olap " );
olap = "WEB-INF/files/olap/GUEST.olap";
<raqsoft:analysev2
olap="<%= olap %>"
dataSource=""
fixedTable=""
ql=""
inputFiles=""
/>
root用户的分析页面demo如下图:
guest用户的分析页面demo如下图:
使用Tag标签属性只是可以对一些初始的指标数据的显示做控制,但如果要对分析界面的样式做修改,那么就需要通过润乾报表提供的JS API来实现了。
JS API缺省在[安装根目录]/report/web/webapps/demo/raqsoft/guide/jsp/olap.jsp的尾部,如下所示:
/*这些参数可以控制分析页面的初始状态
guideConf.maxDataSize = '10000';//报表数据集最大的条数,因为在全内存,这个不易过大,被分析的原始数据集可以无限大,过多的数据将被弃用
guideConf.maxReportSize = '50000';//限制报表的行*列,超出这个数量报错,不能生成报表;提示减少分组/弃用交叉报表重新生成报表
guideConf.outerCondition = "";//对dql表设置隐含的条件
guideConf.queryPage = "";//设置查询界面,用来跳转回查询界面重新查询,多表查询默认跳转至raqsoft/guide/jsp/groupQuery.jsp,单表查询默认跳转至raqsoft/guide/jsp/qyx.jsp
guideConf.reportPage = "raqsoft/guide/jsp/showReport.jsp";//查询界面,用来跳转回查询结果重新查询
guideConf.dataFileType = 'text';//binary是二进制文件,会以游标方式读取,能支持超出内存的数据集
//不同种类报表单元格的显示属性设置
guideConf.style = [{"name":"标题","backColor":-1641217,"color":-16777216,"hAlign":-47},{"name":"分组","backColor":-1641217,"color":-16777216,"hAlign":-47},{"name":"指标1","backColor":-1,"color":-16777216,"hAlign":-48},{"name":"指标2","backColor":-853778,"color":-16777216,"hAlign":-48}];
guideConf.canEditDataSet = 'yes';//是否出现编辑数据集的按钮
guideConf.canEditReport = 'yes';//是否出现报表配置的区域
guideConf.showHistoryRpx = 'no';//重新进入分析界面时,假如已经存在历史报表,是否直接显示老报表,否则重新计算报表
guideConf.showToolBar = 'no';//是否显示上部工具条
guideConf.defaultWidth = 50;//报表单元格的默认宽度
guideConf.defaultHeight = 20;//报表单元格的默认宽度
//根据数据类型自动的显示风格
guideConf.formatExp = 'if(ifnumber(if(value()==null,"",value())),"#.##",if(ifdate(if(value()==null,"",value())),"yyyy/MM/dd",""))';
guideConf.showZongji = "yes";//报表里是否显示总计
guideConf.defaultSaveName = "";//保存olap默认的名称
guideConf.fileDataFolderOnServer = "/WEB-INF/files/fileData/";//服务器上数据文件目录,txt、csv、xls、xlsx
guideConf.olapFolderOnServer = "WEB-INF/files/olap/";//服务器上olap文件的根目录,默认/WEB-INF/files/olap/
guideConf.dataFolderOnServer = "WEB-INF/files/data/";//服务器上缓存数据文件的根目录,默认/WEB-INF/files/data/
guideConf.dfxFolderOnServer = "WEB-INF/files/dfx/";//服务器上dfx文件的根目录,默认/WEB-INF/files/dfx/
guideConf.inputFileFolderOnServer = "WEB-INF/files/inputFile/";//服务器上填报数据文件的根目录 ,默认/WEB-INF/files/inputFile/
guideConf.rpxFolderOnServer = "WEB-INF/files/rpx/";//服务器上报表模板的根目录,默认/WEB-INF/files/rpx/,关于报表模板的制作可参考报表自定义模板小节
guideConf.sqlId="<%=sqlId%>";//通过脚本添加不需要缓存数据的sql数据集,给定一个sql,然后界面使用这个sql查询出来的字段进行拖拽,拖拽后拼成一个最终的sql直接去数据库执行,如select f1 , sum(f2) from (${原始sql}) t where ... group by .... having ....。这种方式始终利用数据库的计算能力,不缓存数据,和DQL Server无关
var sqlDatasets = [
{
sqlId:"sqlId1" //指定数据集名称,不可重复
,dataSource:"demo" //指定SQL语句所使用的数据源
,sql:"select * from 客户" //指定数据集SQL语句
,fields:null
}
]
guideConf.resultRpxPrefixOnServer = "WEB-INF/files/resultRpx/";//服务器上保存结果报表文件的文件前缀,默认/WEB-INF/files/resultRpx/;当设置"/WEB-INF/files/resultRpx/user1_"时,user1_是文件名的一部分,不是目录
guideConf.dimDataOnServer = "WEB-INF/files/data/temp/dimData.json";//维值数据,多层的维会自动生成树状数据;默认/WEB-INF/files/data/temp/dimData.json,没有这个文件的时候,根据当前dql数据源自动生成,生成后用户可以根据自己的需求自己再修改这些数据
guideConf.analyseButs = "1,2,3,4,5,6";//工具栏八个按钮的显示隐藏,默认显示前6个
guideConf.filter="default";//设置缺省需要使用的权限条件
guideConf.dct="";//设置字典文件
guideConf.vsb="";//设置可视文件
guideConf.autoReloadDimDataOnServer="yes";//每次进入jsp,是否重新生成dimData.json
guideConf.scanRow=1000; //自动判断序表字段的数据类型时,扫描多少行数据
*/
示例1:
例如在分析界面demo上方会显示默认toolbar工具条,用户如果不想显示toolbar工具条则可通过在<script/>标签中添加如下js代码实现。
guideConf.showToolBar = 'no';
效果如下图:
示例2:
例如用户如果想在分析界面demo上方的toolbar工具条上添加一个名为"自定义保存按钮"的保存olap的按钮,则可通过如下代码实现:
<input type="button" onclick="analyseApi.openOlap()" style="color:#fe4164;vertical-align:20px;text-decoration: none;" value="自定义打开按钮">
在[安装根目录]\report\web\webapps\demo\raqsoft\guide\jsp\template.jsp中,添加位置为id="analyseView"的<div>标签下的class='ui-layout-north'的<div>标签里面,刷新页面后即可看到效果。
效果如下图:
示例3:
分析控件中添加数据集时,通常需要将数据集的结果缓存,对报表进行分析时会自动从缓存文件中取数分析。但当用户不想从缓存中获取分析数据,而是想拖拽后实时通过拖拽生成SQL语句到数据库查询,此时则可以通过如下方式添加SQL数据集实现该需求:
在分析页面中添加如下代码:
<script>
…
guideConf.sqlId="<%=sqlId%>";
var sqlDatasets = [
{
sqlId:"sqlId1" //指定数据集名称,不可重复
,dataSource:"demo" //指定SQL语句所使用的数据源
,sql:"select * from 客户" //指定数据集SQL语句
},
{
sqlId:"sqlId2" //指定数据集名称,不可重复
,dataSource:"dqldemo" //指定SQL语句所使用的数据源
,sql:"select * from 回款单" //指定数据集SQL语句
}
]
</script>
访问分析页面,传递不同的SQL数据集名称,则展现不同的结果,:
URL:http://localhost:6868/demo/raqsoft/guide/jsp/olap.jsp?sqlId=sqlId1
URL:http://localhost:6868/demo/raqsoft/guide/jsp/olap.jsp?sqlId=sqlId2
通过Tag标签或者JS API都可以控制分析界面初始化的显示。但初始化之后,如果用户还需要修改一些样式或图片,那么可以通过浏览器的开发者工具找到页面元素的一些id、className,通过这些属性可以直接对页面元素进行修改,js代码可写在 [安装根目录]\report\web\webapps\demo\raqsoft\guide\jsp目录下的olap.jsp的尾部。
示例1:
$(document).ready(function(){
//修改页面上的title
document.title = "测试";
//把页面demo上部的工具条的背景色改成红色
$('.ui-layout-north').css('background-color','red');
});
效果如下图:
示例2:
//增加打开按钮
$(document).ready(function(){
$('body').append('<a href="javascript:analyseApi.openOlap();" style="position:absolute;top:20px;left:765px;z-index:50000;;color:#DFDFE3">打开</a>');
});
效果如下图:
示例3:
//自定义数据分析设置器的显示位置和状态
$(document).ready(function(){
var ac2 = $("#analyseConf2");
var ac1 = $("#analyseConf1");
ac1.css('display','none');
setTimeout(function(){
ac1.css('display','block');
$(ac2.find("img")[1]).click();
},3500);
setTimeout(function(){
$(ac2.find("img")[0]).click().css('display','none');
},1000);
setTimeout(function(){
ac1.css('right','');
ac1.css('left','30px');
ac1.css('top','10px');
},1500);
});
在[安装根目录]\report\web\webapps\demo\raqsoft\guide\jsp目录下的olap.jsp中添加上述代码后,访问页面即可,效果如下图:
示例4:
//使用函数在id="dataSetBut"的页面元素前插入内容test
$(document).ready(function(){
var test = $('<a style="color:#FF00FF;vertical-align:20px;text-decoration: none;" href="javascript:void(0);"><img style="vertical-align:-7px;margin:0 10px;" src="/demo/raqsoft/guide/img/guide/save.png">保存</a>');
$('#dataSetBut').before(test);
test.click(function(){
alert(' test ');
});
});
将示例代码添加到[安装根目录]\report\web\webapps\demo\raqsoft\guide\jsp\olap.jsp中,刷新页面后点击红框中的内容即可,效果如下图:
选择使用这种集成方式的用户需要有比较强的前端开发能力,能读懂并且直接修改官方的核心js文件里的代码,主要的几个js文件及目录如下:
/raqsoft/guide/js/dqlreport.js,分析模块主要功能
/raqsoft/guide/js/query.js,查询模块主要功能
/raqsoft/guide/js/where.js,条件编辑子模块
/raqsoft/guide/js/common.js,公共基础的一些js工具
/raqsoft/guide/js/raqsoftApi.js,查询、分析模块定义的js api
/raqsoft/guide/js/artDialog/,第三方的弹出框控件
/raqsoft/guide/js/dqlApi.js,查询分析模块页面数据模型,基于此API二次开发,用户可以完全弃用官方界面