历史版本10 :填报修改fine_conf_entity 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本
10.0

1.2 应用场景

平台中有些配置项存储在 FineDB 的 FINE_CONF_ENTITY 表中,只能通过修改表字段来进行更改。

1.3 功能简介

本文将使用一个简单的示例来演示如何通过填报的方式修改 FINE_CONF_ENTITY 的表字段。

示例:

修改 FineDB 中 FINE_CONF_ENTITY 表中的「CustomConfig.printWidget」字段,将字段值改为「true」。

步骤:

1)连接内置 FineDB 数据库,用于获取需要修改的 FINE_CONF_ENTITY 表。

2)新建一张填报模板,用于填报修改 FINE_CONF_ENTITY 的表字段。

3)修改表字段,并提交入库到 FineDB 中。

注:修改 FineDB 文件,有可能造成不可修复的 BUG,因此非必要请勿修改 FineDB 文件。

2. 备份平台配置编辑

请在修改 FINE_CONF_ENTITY 的表字段前,通过手动或自动的方式备份平台配置项,备份方式请参考:备份还原 。

以手动备份平台配置为例,管理员登录数据决策系统,在「管理系统>智能运维>备份还原>平台配置」中选中手动备份。

默认备份路径为:.../backup,备份文件储存在工程的 %FR_HOME%/webapps/webroot/backup 文件夹下,如下图所示:

3. 新建数据连接编辑

管理员登录数据决策系统,点击「管理系统>系统管理>常规」。

  • 若外接数据库显示「待配置」,则 FineDB 数据库信息可参见 FineDB 数据库简介

  • 若外接数据库显示「已配置」,点击即可查看外接finedb数据库的信息。

新建一个数据连接,数据连接名称为 FineDB,数据库相关配置信息可根据上文获取。如下图所示:

注1:「内置 FineDB 数据库」为HSQL数据库,使用时会建立内存数据库,数据量大时会占用大量内存

        因此非必要请勿在 FineReport 工程中创建「内置 FineDB 数据库」的数据连接。

注2:本文仅简介设计器连接内置 FineDB 数据库的方式,平台连接方式请参见文档: [平台] HSQL 数据连接 。

具体连接信息如下表:

设置项
数据库others
驱动器com.fr.third.org.hsqldb.jdbcDriver
URL

jdbc:hsqldb:file://${ENV_HOME}/embed/finedb/db

注:Windows/Linux/Mac 通用

用户名sa
密码无需输入

注:服务器添加 FineDB 数据连接后,务必控制 数据连接使用权限,否则存在被越权访问并修改配置数据库的风险。

4. 新建填报模板编辑

新建一张填报模板,用于填报修改 FINE_CONF_ENTITY 的表字段

4.1 数据准备

新建数据查询 ds1,选择数据连接为 FineDB,输入 SQL 语句:SELECT * FROM PUBLIC.FINE_CONF_ENTITY WHERE ID ='CustomConfig.printWidget',获取需要修改的表字段。如下图所示:

4.2 设计报表

1)设置主体内容

新建一张普通报表,设置 A2~B2 单元格纵向扩展,B2 单元格的左父格为 A2 单元格。模板样式如下图所示:

2)设置填报控件

由于需要填报修改「CustomConfig.printWidget」字段,因此需要设置 B2 单元格为文本控件。如下图所示:


4.3 设置填报属性

点击菜单栏「模板>报表填报属性>提交」,新增「内置SQL」。

1)选择数据库为「FineDB」,表为「FINE_CONF_ENTITY」。

2)将单元格与数据库表中的数据列进行绑定,并选择「ID」作为主键。如下图所示:

5. 修改表字段编辑

1)点击「保存」按钮,保存报表。点击「下拉框」,选择「填报预览」查看报表。

2)将「CustomConfig.printWidget」字段值由「false」修改为「true」。

点击「提交」,弹窗提示「成功」后,修改后的数据已经入库 FineDB。如下图所示:

6. 效果预览编辑

修改后,重启报表工程,配置生效。

刷新填报页面,「CustomConfig.printWidget」字段值已修改为「true」。如下图所示:


在数据查询 ds1 中,点击「预览」,FINE_CONF_ENTITY 表中CustomConfig.printWidget字段值已修改为「true。如下图所示:


7. 注意事项编辑

如果出现在修改 FINE_CONF_ENTITY 表字段前能够正常登录数据决策系统,修改后无法登录或无法填报预览模板的情况,可参考以下步骤重置平台配置:

注:如果用户在修改表字段前无法登录数据决策系统,使用以下步骤重置平台配置无效。

1)根据第二节设置的备份路径,找到备份文件,进行平台配置的还原。

以手动备份为例,在%FR_HOME%/webapps/webroot/backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的 config.zip 解压得到的 finedb,替换%FR _HOME%/webapps/webroot/WEB-INF/embed下的 finedb 文件。

2)重启工程。