V4升级V5解决方案

   本文档适用于原系统使用V4开发，现需要将系统升级至V5的用户。升级后V4与V5全面兼容。报表既可以使用V4设计器进行编辑，也能够在V5中进行编辑，以及使用V5中的新功能进行报表设计和展现输出。

 

升级步骤：

一、     安装V5产品

 

获取最新版本V5安装程序，在服务器上安装V5平台（请注意安装至服务器）。

 

二、     升级V4设计器

 

    为了使V4设计器和V5设计制作出来的报表全面兼容，需要对V4设计进行升级。使V4设计器能够正常对V5中制作或修改后的报表进行编辑。

 

升级操作：

1.         将reportmis\下的appletPath.jar拷贝至：\reportHome\designer\web\WEB-INF\lib下。

2.         拷贝reportmis\WEB-INF下的reportStyleConfig.xml和globalTemp.css至\reportHome\designer\tmp。

 

注意：

完成以上操作后可以使用V4设计器编辑和预览大部分报表，对特殊功能的兼容性支持说明如下：

1.      使用V4设计器对V5编辑过的报表在web端发布和applet打印，参见：附表一。

2.       V5 Flash统计图报表不能使用V4设计器进行修改，参见：附表二。

3.       V4中设计的旧版统计图需要使用V5设计器进行编辑时的升级操作，参见：附表三。

 

三、     在V5中编辑原V4系统中制作好的报表文件

 

    可以通过报表登记功能将V4中制作好的报表、报表组文件登记到资源中心下，再资源中心下进行报表编辑、展现。

登记方法：访问V5平台，使用root账户登录，在【系统管理】 > 【v4报表登记】菜单下选择【从服务器选择】在弹出窗口中选择报表存放的目录，即可。具体参见平台用户手册

    用户也可以不进行报表登记，通过另外两种方式来实现V5设计器对原V4中的报表的编辑。

    a.资源中心下新增raq报表，选择需要进行编辑、展现的报表。

    b.直接用V5设计器打开报表文件。 

四、     展现、打印、导出方式升级

 

    用户可以根据需要选择是否对原系统中的展现、打印及导出方式进行升级以及选择升级的方式。

    升级后可以使用V5中报表展现、打印和导出的新功能。例如：展现报表时可以拖拽调整列宽；可以使用flash打印；可以更加灵活、方便的根据需求进行展现效果、导出方式的控制等。

 

方式一：

   直接升级至V5中的报表统一展现输出程序showReport，以下简称SR。升级至SR的优点在于：

、 此页面可以直接用于所有类型报表展现，无需用户进行修改。例如：浏览报表、填报表、报表组、大数据报表、需要支持数据折叠的报表等。

、 此页面可以通过界面设置或参数，轻松的进行展现、输出方式和效果的控制。

 、此页面用户可以根据需要进行一些自定义的修改。

 

此方式适用于，原系统本身是在统一的页面进行报表展现的情况下。使用这种方式可以很轻松地完成升级。如果，原系统的报表展现比较分散，使用了很多的JSP进行报表展现，则这种方式会带来较大的工作量。但从系统结构的合理性和易维护性角度，强烈建议用户直接将展现程序升级至统一的页面SR进行报表的展现。

升级操作：使用集成工具，选择【SR模块】集成至原系统。集成后，使用../reportmis/mis2/reportCenter/showReport1.jsp进行报表展现即可。

 

方式二：

 

使用系统现有的JSP进行报表的展现，仅将报表的展现的标签库进行升级。升级后用户可以使用V5中与V4兼容的标签库进行报表展现。从而在不修改原有程序（或者在必要地方增加使用V5新增标签）的情况下能够快速地在需要的地方应用V5的新特性。

升级操作：

·   使用集成工具，选择【VR模块】进行集成，集成后。

·   拷贝…/WEB-INF/tld/目录下的viewReport.tld文件中的内容至../WEB-INF/runqianReport4.tld中。

·   修改展现报表的JSP，配置标签appletJarName= appletJarName="runqianReport4Applet.jar,dmGraphApplet.jar,appletPath.jar"。

 

方式三：

 

    自定义JSP调用V5提供的新的报表展现标签来进行报表的展现输出，即用户自己调用V5的标签进行展现，比方式一更灵活，比方式二功能更强。适用于用户原有调用标签展现的程序比较集中，改动量较小。

   

注意事项

1.       V5复杂设计器不能直接对原V4报表中的数据集进行编辑。需要在数据管理中添加相应数据源数据集后，再在报表中引入。（后续版本提供直接在报表中编辑数据集）

2.       报表运算取数时，既可以通过与V4相同的方式，配置数据库连接池来进行取数，也可以通过数据管理来进行数据源的配置。

3.       如果V4设计器中的report4.jar、runqianRepor4Applet.jar不是最新版本，请拷贝V5中的同名report4-1.0.jar和runqianRepor4Applet.jar进行替换。

4.        

附表一：使用V4设计器在WEB端发布V5报表升级说明

                       i.              将reportmis\appletPath.jar拷贝至：\reportHome\webapps\demo\WEB-INF\lib、

\reportHome\webapps\demo、\reportHome\designer\web。

                     ii.              拷贝reportmis\WEB-INF下的reportStyleConfig.xml和globalTemp.css至\reportHome\webapps\demo\WEB-INF。

                    iii.              在reportConfig.xml文件中增加以下节点：

       CSSFile
       /WEB-INF/reportStyleConfig.xml

                    iv.              在展现报表的JSP中，设置appletJarName标签的属性值为：

 

 

附表二：V4设计编辑V5 Flash统计图解决办法

（涉及到的文件很多，后续会提供专门的升级工具，以免拷贝大量的文件）

    V4设计器本身不支持对V5中制作的flash统计图进行编辑和查看的功能，如果希望能够使用V4设计器来编辑和预览V5中带Flash统计图的报表时，需要对V4设计器进行相应的升级操作。

具体步骤如下：

Ø  文件拷贝

·   将reportmis\mis2\reportcenter\res\flexdesigner\reportFiles\complex文件夹下 flash统计图对应的xml文件拷贝至\reportHome\webapps\demo\mis2\reportcenter\res\flexdesigner\reportFiles\complex文件路径不存在时，请新建相应目录。

·   将reportmis\mis2\Charts文件夹拷贝至reportHome\mis2\Charts。

·   将reportmis\WEB-INF\lib下的以下jar包拷贝至…\reportHome\designer\

web\WEB-INF\lib和\reportHome\webapps\demo\WEB-INF\lib。

·   jdom-1.0.jar、json-1.0.jar、gez_common_rqLib-1.0.jar、gez_dataManager-1.0.jar、gez_fastpivot-1.0.jar、rqlic-1.0.jar。

·   将reportmis下的appletPath.jar拷贝至demo文件夹下。

·   将GlobalServer.xml和misInitConfig.xml拷贝至WEB-INF文件夹下。

 

Ø  修改配置文件

 

         在WEB-INF/web.xml中增加以下配置（注意：servlet-mapping需在servlet之后）：

FlashChartServlet

com.runqian.report5.flash.FlashChartServlet

2

 

commonServlet

com.runqianapp.common.servlet.CommonServlet

0

commonServlet

/commonServlet

 

FlashChartServlet

/flashChartServlet

附表三 V4旧版统计图升级至新版统计图说明

    包含V4旧版本统计图的报表在V5设计器中不能进行编辑，能正常展现。如果需要使用V5设计器来编辑时，需要将包含V4旧版统计图的报表升级至新版统计图。升级操作可使用统计图升级工具来完成。

下面简单说明下升级工具的使用方法：

1、解压统计图升级工具包，其目录下的文件如下：

2、运行test.bat命令，弹出如下界面：

3、添加要升级的报表文件或者文件夹（批量升级），点击升级按钮，选择升级方式（覆盖或另存）

4、升级工具运行过程中会输出日志信息

5、通过以上简单的几步操作就可以完成统计图的升级，这样就可以在V5中灵活的编辑该报表了。