1. 概述
1.1 版本
报表服务器版本 | 功能变更 |
---|---|
11.0 | - |
11.0.6 | 1)新增次级管理员支持「资源迁移」功能 2)超管进行「资源导出」时「同时导出权限配置」变更为默认不勾选 |
1.2 应用场景
使用 FineReport 数据决策系统时,一般先在测试环境系统上进行开发部署,确认无误后再迁移到正式系统中。
FineReport 支持将「服务器数据集」从测试系统增量迁移到正式系统。
1.3 功能简介
超管登录数据决策系统,点击「管理系统>智能运维>资源迁移」,分为「资源导出」、「资源导入」两部分。
本文仅介绍迁移资源类型为「服务器数据集」时的操作方法。
1.4 注意事项
1)资源迁移功能仅支持超级管理员,次级管理员。
2)次管在进行「资源导出」时不支持「同时导出权限配置」。
3)正式工程需购买「智能运维」功能点才可使用「资源迁移」功能。
4)请确保在资源迁移过程中,没有其他人使用超级管理员账号,否则部分执行请求可能被取消。
5)不建议在个人 PC 端工程开发模板后,再以资源迁移的形式同步到公司工程。
因为个人 PC 端没有管理员维护,经常会因为 JAR 包不同步或资源以及配置不同步的问题导致资源迁移失败,运维成本会很高。
2. 准备工作
2.1 确认版本
资源迁移之前,请确保资源导入和导出的 FineReport 工程使用的版本一致(包括 JAR 包时间)。
管理员可在「管理系统>注册管理>报表模块」下查看 JAR 包时间,如下图所示:
若版本不一致,可通过升级来确保版本一致。
注:在资源导入时,若上传资源对应的工程和当前工程版本不一致,则无法上传。
提示:无法导入,即将导入的资源需要的工程版本:XXX。当前工程版本:XXX。请确保工程版本一致!
2.2 系统备份
资源导入前建议对测试系统和正式系统均进行 系统备份,如下图所示:
注:备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
2.3 确认插件和驱动
1)若服务器数据集需依赖第三方插件,目前只支持 JSON 数据集和 Mysql8 数据连接,其他插件类型不适配,会导入失败。
2)权限导出插件生成的服务器数据集,不支持迁移,会导入失败。
3)服务器数据集迁移只迁移配置。驱动jar包、kerberos认证文件、JNDI 配置文件等都不会迁移,需要手动配置/放置。
请在进行服务器数据集迁移前,确认正式工程下是否提前安装依赖的相关数据集插件,否则将导致导入失败。
请在进行服务器数据集迁移前,确认正式工程下是否提前安装依赖的相关驱动,否则将导致导入的服务器数据集不可使用。
2.4 确认数据连接
服务器数据集若依赖相关数据连接,请确认将相关数据连接导入正式工程,否则导入的服务器数据集无法使用。
资源迁移数据连接的操作请参见:资源迁移数据连接
3. 测试系统下资源导出
超级管理员登录数据决策系统,选择「管理系统>智能运维>资源迁移>资源导出」,如下图所示:
设置 | 简介 |
---|---|
资源类型 | 资源类型为「服务器数据集」,服务器数据集列表可多选 导出文件到本地,文件名默认为:resource.zip 支持导出:SQL数据集、文件数据集、树数据集、JSON数据集、内置数据集、程序数据集、关联数据集、存储过程
若文件数据集的数据集来源为URL,则只导出配置,文件不导出 若文件数据集的数据集来源为文件,文件路径包含参数,则文件不导出
若导出树数据集时,未导出依赖的原数据集,则导入时可正常导入但无法使用
若导出关联数据集时,未导出依赖的原数据集,则导入时可正常导入但无法使用
权限导出插件生成的服务器数据集,不支持迁移,会导入失败
若服务器数据集需依赖第三方插件,目前只支持 JSON 数据集和 Mysql8 数据连接,其他插件类型不适配,会导入失败 |
同时导出超链跳转模板 | 迁移资源类型为「服务器数据集」时,该选项不生效 |
同时导出权限配置 | 迁移资源类型为「服务器数据集」时,该选项不生效 |
4. 正式系统下资源导入
4.1 上传文件
超级管理员登录数据决策系统,选择「管理系统>智能运维>资源迁移>资源导入」,如下图所示:
注1:资源导入前建议进行 系统备份,其中备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
注2:单次只允许上传单个压缩文件。
系统会获取导入文件所包含的资源,包含类型、平台路径、物理资源、权限信息及导入方式。
设置 | 说明 |
---|---|
类型 | 服务器数据集 |
平台路径 | 平台路径为「导出系统」的服务器数据集的名称 |
物理资源 | 一般为空 如果导入的服务器数据集为文件数据集,物理资源会显示实体文件路径 |
权限信息 | - |
导入方式 | 在导入时,系统会对资源进行检测,检测是否与系统现有资源有冲突。 冲突检验以资源的原始名与其在平台中的路径名为准。 分为直接导入和覆盖导入 直接导入:与系统中已有资源没有冲突,默认选中。 覆盖导入:与系统中已有资源有冲突,默认不选中且高亮,点击按钮可以查看到详细说明 |
冲突检测 | 平台路径:路径冲突 物理资源:路径冲突(仅限文件数据集) |
4.2 导入文件
勾选需要上传的资源,点击「导入」,点击「确定」。
若导入失败,显示失败的原因(如:导入不支持的插件类型数据连接或者导入工程没有安装插件);若导入成功,则资源即时生效。如下图所示: