导出与打印

阅读(6922) 标签: echarts导出, 打印,

为方便用户能够更好的在报表中使用Echarts图形,产品提供了对Echarts图形的导出与打印。服务器端配置导出与打印时依赖于slimerjsfirefox,因此使用导出与打印前需要先按照如下章节所讲的步骤将服务器端环境先部署好,以下安装及配置步骤都是在服务器端进行,对客户端没有任何要求,支持任何浏览器。

第一步:获取并安装slimerjs

步骤1: 获取slimerjs安装包

SlimerJS是服务器端的JavaScriptAPI工具。可以将它理解为是无界面的可编程操作的浏览器。这样,润乾报表就可以用 Javascript 脚本操纵网页,实现对页面图形的捕获网络监控等操作。

SlimerJS已经被加入润乾报表安装包中,放在润乾报表【安装根目录】\report\web\webapps\demo\raqsoft\slimerjs-0.10.3.zip

当然也可以从SlimerJS官方网站https://slimerjs.org/download.html下载。

步骤2:安装

zip安装包解压到电脑硬盘中即可,不同操作系统安装方法都一样。

第二步:安装firefox

由于SlimerJS基于火狐的Gecko内核,因此使用SlimerJS时还需要安装与它匹配的FireFox浏览器版本。然后在报表服务器端可以利用SlimerJS返回的API程序,把网页中画出的Echarts统计图转换成一张图片,然后加载到报表单元格里进行打印、导出。

可从firefox官方网站http://www.firefox.com.cn/download/下载安装与操作系统对应版本的火狐浏览器即可。

目前slimerjs只能支持firefox 38-52或者更低版本,所以不要下载安装最新版本。以后新版slimerjs可能会支持更高的firefox版本。

以下是更低版本下载建议地址:

firefox49.0版:http://ftp.mozilla.org/pub/firefox/releases/49.0/

firefox50.0版:http://ftp.mozilla.org/pub/firefox/releases/50.0/

 

注意事项:

Firefox安装完成后,需要手动关闭下自动更新功能,否则再次启动Firefox的时候可能会自动更新到最新版本,就会和slimerjs不匹配了,导出echarts时就会异常。

第三步:设置环境变量

*windows操作系统下:

以下环境变量配置过程以win10系统为例

1.在资源管理器中鼠标右键点击“此电脑”,选择属性,弹出如下窗口:

2.点击高级系统设置,弹出窗口后点击环境变量,再弹出如下窗口:

3.选择新建环境变量,在弹出窗口中设置变量名为SLIMERJSLAUNCHER,变量值为firefox的安装路径。

*linux/ MacOS操作系统下:

在命令行执行如下命令:变量值为firefox执行文件的全路径。

export SLIMERJSLAUNCHER=/usr/bin/firefox

用户也可以在本机的.profile或者 .bashrc文件中设置此环境变量。

第四步:复制calcEcharts.js

如果用户是在slimerjs官方网站下载的安装包则需要在安装报表以后找到【安装根目录\report\web\webapps\demo\raqsoft\calcEcharts.js文件,然后复制到slimerjs的安装目录下。

注:若使用报表系统提供的slimerjs安装包,不必进行此步操作。

第五步:授权文件可执行权限

注:windows中不需要此步操作

在命令行中进入到slimerjs的安装目录,然后执行如下命令:

chmod 777 ./slimerjs

chmod 777 ./calcEcharts.js

第六步:IDE配置

打开报表,点击【工具-选项】文件配置窗口,设置slimerjs的安装目录。

注:IDEslimerjs安装目录的设置仅支持绝对路径。

第七步:WEB应用配置

WEB-INF/raqsoftConfig.xml中增加了两项配置。

<property name="slimerjsDir" value="e:\slimerjs-0.10.3"/>

<property name="echartsJSUrlPrefix" value="http://localhost:6868/demo/raqsoft"/>

1、  slimerjsDir配置slimerjs的安装目录。

注:独立启动应用时,若未配置此项,则应用不具备打印和导出echarts的功能。

slimerjsDir属性配置slimerjs的安装目录支持绝对路径和相对路径。如果采用相对路径,则相对于webroot目录。

2、  echartsJSUrlPrefix配置echarts图形的js所在的父目录的访问地址,即下图中所示的raqsoft目录:

用户可以将其配置成文件绝对路径的形式,也可以配成http方式。

注:当应用以war包方式发布时,必须配置此项。不是以war包方式发布时,可以不用配置此项,程序会自动设置此项。