润乾 V4 升级至润乾 V2022 一般可分为两部分：报表文件的迁移、报表服务的升级。

第一部分 报表文件的迁移

准备工作：

在使用报表迁移时，数据集的环境必须一致。要求在润乾 V2022 设计器中，新增相同的数据源配置。

例如.raq 文件的数据集中使用的是名为 runqianDB 的 SQL 数据源，在迁移时如果 V2022 中没有相同配置且名为 runqianDB 的 SQL 数据源，则迁移过程中程序没法计算数据集，会出现不识别函数名的问题。

迁移操作：

我们可以使用润乾 V2022 设计器中自带的迁移工具实现 raq 报表文件的升级。

依次点击 “工具”—-“报表迁移”，在报表迁移配置页面完成 raq 到 rpx 文件的转化，本工具不仅支持单个报表文件的迁移，同时支持目录整体的迁移

迁移后的结果为：将 raq 文件转化为 rpx 文件

以迁移单个报表文件为例（操作也可查看下方图片），依次点击“工具”—“报表迁移”，在弹出的报表迁移配置页面点击“选择文件”，选择自己需要进行迁移升级的 raq 文件（可同时选择多个报表文件，也可以点击“不选文件”移除 raq 文件），然后点击下方“迁移到目录”的路径选择按钮，选择保存 rpx 文件的路径，最后点击开始迁移，当弹出“报表迁移成功”的提示时，表示已迁移成功，我们就可以去 rpx 保存路径中查看升级后的报表文件了。

配置页面说明：

<1> 文件迁移

使用缺省参数迁移：勾选该选项后，报表中如设置了参数，则缺省参数就是默认值。否则会弹出参数编辑框

删除迁移成功的源文件：勾选该选项文件迁移成功后可自动将源文件删除

迁移到目录：指定迁移后文件所在的目录

<2> 目录迁移

目录迁移可直接选择文件夹，对文件夹中的.raq 文件和子目录中的.raq 文件 (可选) 进行迁移。

报表迁移过程中的常见问题可参见附录部分的内容。

PS：

润乾 V3.5 迁移至润乾 V2022 操作步骤：

先通过润乾 V4 设计器的迁移工具，将 3.5 版本的报表转化成 V4 报表文件，然后再通过 V2022 版本的迁移工具，将 V4 报表文件转化为 rpx 报表文件

集算报表、润乾 V5 迁移至润乾 V2022 操作步骤：

rpx 报表文件可通用，无须做报表迁移转化操作

第二部分 报表服务的升级

1 单独部署报表服务升级

可直接将 V2022 安装目录下的 demo 作为报表服务进行单独部署，然后将原来的 V4 报表服务废弃掉就可以

此时，需要注意以下几点：

1）需要申请 xml 授权文件

2）raqsoftconfig.xml 的配置，例如数据源、授权等的配置

3）展现报表的 jsp 配置，例如增加之前做的二次修改代码

4）二次开发内容的重新编写配置

2 集成报表服务升级

需要将原来 V4 报表服务的文件删除掉，然后按照 V2022 安装目录下的 demo 结构重新放置文件

V2022 核心文件为 raqsoft、WEB-INF 目录

此时，需要注意以下几点：

1）需要申请 xml 授权文件

2）web.xml 内容的合并

3）raqsoftconfig.xml 的配置，例如数据源、授权等的配置

4）展现报表的 jsp 配置，例如增加之前做的二次修改代码

5）检查 WEB-INF\lib 下的 jar 包是否有冲突

6）二次开发内容的重新编写配置

PS：

润乾 V3.5 服务升级至润乾 V2022 操作步骤：

可参照 V4 报表服务升级至 V2022 操作步骤

集算报表、润乾 V5 服务升级至润乾 V2022 操作步骤：

1）可参照 V4 报表服务升级步骤操作

其中，润乾 V5 版本也可以只更新 dm.jar、raqsoftreport.jar

2）需要申请 xml 格式授权文件

------------------------------------------------------- 附录 ------------------------------------------------------------------

报表迁移过程中的常见问题：

一、统计表

1 数据集

1）数据源

当 V2022 设计器中没有配置对应数据源，由于迁移过程中程序没法计算数据集，会出现不识别函数名的问题。

2）参数

数据集中使用了参数，且参数是必传参数，若迁移时没有给参数指定参数值，那么也会出现由于没法计算数据集而报错提示不识别函数名的问题

解决方法：

当迁移过程中出现类似“未知的函数：ds2.select”的警告信息时，优先检查数据源配置以及参数相关的配置，保证数据集能正常执行计算，然后再重新执行迁移操作。

3 ） 自定义数据集

由于 V2022 和 V4 的类路径不同，所以自定义数据集是不支持直接迁移的。

解决方法：

首先在 v4 中删除原表的自定义数据集；然后按照自定义数据集的数据表结构内建数据集；然后将此报表进行迁移操作；最后使用 V2022 的接口进行自定义数据集的编写和配置

2 统计图

V4 版本中有“统计图”和“新统计图”两种：

目前只支持“统计图”的迁移，对于“新统计图”的迁移不支持。

新统计图迁移会报错：com/raq/chartengine/params/ParamValues

解决方法：

删除 raq 文件中新统计图的配置，然后再进行 raq 文件的迁移操作，最后，升级成功后的 rpx 文件可以改用 V2022 内置统计图实现或者 echarts 统计图实现对应效果

3 单元格函数

V2022 版本中对部分函数做了修改完善，部分函数用法与 V4 不一样

V2022 和 V4 函数对照表参考：http://doc.raqsoft.com.cn/report/preference/hanshuduizhoa.html

Don’t worry，迁移工具本身已经做了函数转化处理，大部分差异函数可以正确转化为 V2018 的函数用法。

4 多数据源报表

在 V2022 设计器下将 V4 中报表文件涉及的数据源都配置一下，保证数据集能正常计算即可，例如 raq 中用到了两个数据源：test ceshi

那么在进行迁移操作前，需要在 V2022 设计器中增加相同的数据源配置即可正常迁移，即 V2018 设计器数据源配置页面中有相同的两个数据源配置：

5 报表组

先将报表组中涉及的各个 raq 文件进行迁移操作，保存到对应目录，然后再进行报表组的迁移，例如：

V4 报表组 baobiaozu.rpg 中引用到了 aa.raq ceshi3.raq，如下图所示：

升级操作步骤为：

先将 ceshi3.raq aa.raq 迁移为 ceshi3.rpx aa.rpx，且 rpx 保存路径为 V2018 的报表默认保存路径

然后将 baobiaozu.rpg 迁移为 5_baobiaozu.rpg 文件，此时可以正确查看报表组效果

PS：建议报表组中报表都配置为相对路径

二、填报表

由于 V2022 和 V4 的填报机制不同，所以对于填报表或者填报表组而言，需要在 V2022 中重新制作。