润乾 V5 如何升级到润乾 V2018

 

常见问题:

1. 新版本有哪些改动 ?
    授权机制改变:授权文件后缀从  .lic 改为了 .xml  ,xml 格式便于查看授权信息。
2. 什么情况下需要升级 ?   
    1). 使用到了润乾 V2018 中包含的新功能或者设置 , 比如:echart 打印导出 slimerjs 设置相对路径、报表中心等
    2). 当前使用版本现有功能有问题的。
3. 如何升级 ?
    一般情况下更换润乾 v2018 下的 dm.jar 和 raqsoftReport.jar,同时申请更新 xml 授权文件。
在 raqsoftconfig.xml 中将授权加载改为 xml 授权加载路径

具体升级操作步骤:

方案一:直接使用 V2018 版本

一、设计器升级

设计器从官网下载最新版本,并重新申请 xml 授权:http://www.raqsoft.com.cn/download/download-jsbb

二、项目升级

1. 单独部署
直接将设计器安装目录下的 demo 作为一个常规 web 应用进行部署操作即可

2. 项目集成
以 WEB-INF 为基准,放置 demo 下的 raqsoft 和 WEB-INF 中的内容,其中 web.xml 需要手动合并,如需要使用自带的 jsp 展现报表,那么可以从 demo\reportJsp 中拷贝展现报表的 jsp 文件直接使用
由于产品是向下兼容的,所以不需要修改报表设计,直接将原来版本中制作的 rpx、rpg、sht、dfx 等文件拷贝到对应目录下即可

方案二:在原有 V5 基础上升级到 V2018 版本

一、设计器升级

主要更新 dm.jar 和 raqsoftReport.jar,一个用于授权解析,一个是核心处理包
更新完对应文件后,重新启动设计器生效,最后按照指示重新指定 xml 授权文件即可正常使用

PS:
1 如 flash 打印有问题,则需要同步更新 raqsoft\flashPrint 下的内容以及 itext2_rq.jar
2 如 excel 导出有问题,则需要同步更新 poi 开头的几个 jar 包,并将老版本的 jar 包删掉
3 如 dql 有问题,则需要同步更新 raqsoft\guide 下的内容以及 guide.jar

设计器配置新授权常见问题:
1). 如润乾 v5 直接更新润乾 v2018 下的 dm.jar 和 raqsoftReport.jar,启动设计器出现如下报错

imagepng

点击确定,然后会弹出 打开文件框  找到对应报表的 xml 格式授权,选中,点击打开。

imagepng

到这里报表的授权设置完成,下面是集算器授权的设置可根据需要选择设置,非必设项。
如果需要使用集算器的功能可以在其后的弹出框中设置集算器的授权文件,  如下

imagepng

同样点击“确定”,然后会弹出 打开文件框  找到对应集算器的 xml 格式授权,选中,点击打开

imagepng

操作完此步,授权设置完成即可使用;

如果不需要使用集算器的功能可以直接点击取消,但是会出现如下错误提示:

imagepng

出现此错误的原因是润乾 V2018 中缺省有一个内置的集算器授权,此时有 2 中解决办法:
1. 设置集算器授权;
2. 将润乾 V2018 版安装…\demo\WEB-INF\classes 文件夹下的 esproc4report.xml 拷贝至对应润乾 v5 下即可。

二、项目升级

主要更新 dm.jar 和 raqsoftReport.jar,一个用于授权解析,一个是核心处理包
修改 WEB-INF\raqsoftconfig.xml 中关于授权的配置,将 lic 授权加载改为 xml 授权加载
更新完对应文件后,重启 web 服务生效

PS:
1 如 flash 打印有问题,则需要同步更新 raqsoft\flashPrint 下的内容以及 itext2_rq.jar
2 如 excel 导出有问题,则需要同步更新 poi 开头的几个 jar 包,并将老版本的 jar 包删掉
3 如 dql 有问题,则需要同步更新 raqsoft\guide 下的内容以及 guide.jar