集成方式

阅读(509) 标签: 集成,

关于多维分析的集成可使用如下四种方式:

(1)  通过Tag属性的使用来控制界面;可以与官方更新兼容。

(2)  编写javascript代码,修改一些界面控制参数,调用analyseApi里提供的方法执行界面操作;可以与官方更新兼容。

(3)  通过浏览器开发工具观察html元素,通过javascript改变图片和css样式;可以与官方更新兼容。

(4)  直接修改分析模块的js文件,对官方提供的功能进行修改;将失去和官方更新兼容的能力。

Tag 标签控制初始化界面

官方界面只是分析工具,不具备用户权限系统,客户把分析页面引入到自己的系统后,需要在jsp上部的java代码处根据当前用户准备不同的Tag属性值,达到权限控制的目的。Tag属性详细介绍请参考《程序员参考》中查询分析控件

示例:

假如客户系统中有两个用户rootguestroot用户权限最大;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如下图:

 

JS API 控制初始化界面

使用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/";//服务器上数据文件目录,txtcsvxlsxlsx

  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数据集名称,则展现不同的结果,:

URLhttp://localhost:6868/demo/raqsoft/guide/jsp/olap.jsp?sqlId=sqlId1

URLhttp://localhost:6868/demo/raqsoft/guide/jsp/olap.jsp?sqlId=sqlId2

js 对初始化后的界面进行修改

  通过Tag标签或者JS API都可以控制分析界面初始化的显示。但初始化之后,如果用户还需要修改一些样式或图片,那么可以通过浏览器的开发者工具找到页面元素的一些idclassName,通过这些属性可以直接对页面元素进行修改,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文件里的代码,主要的几个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二次开发,用户可以完全弃用官方界面