FineReport使用

报表命名规范

参见 报表开发规范手册

数据集命名规则

• 参数面板数据集以para_开头
  例如地区选择下拉框的数据集para_area

• 数据字典数据集以dic_开头
  例如产品映射字典数据集dic_product

• 报表主体数据集以report_开头
  例如客户销售数据report_customerSaleData

• 图表数据集以chart_开头
  例如产品占比图表chart_productRatio

参数命名规则

• 不能以数字、$ 符号开头。

• 变量名只能是字母 (a-z A-Z)、数字 (0-9)、下划线(_)、(@) 或中文的组合并且之间不能包含空格。

• 变量名中不能含有 ? * . - +/等字符和空格。

• 变量名是不区分大小写的, 但不能用保留字
  比如true、falseFALSE、TRUE因为写公式引用的时候容易搞错跟保留字冲突

• 全局参数以g开头
  例如gSaleGroupgProductgPerson

• 模板参数以p开头
  例如pDatepCurrencypUnit

• 数据集参数以s开头
  例如sCompanysProject

条件属性命名规则

• 建议使用简短的中文命名方便业务和开发

• 格式条件类型_具体功能
  例如列宽_隐藏projguid列

超链接命名规范

• 建议使用简短的中文命名方便业务和开发

• 格式超链接类型_具体功能
  例如网络报表_跳转到明细

决策报表组件命名规则

• 不允许使用复制组件自动填充的名称
  例如report0_c、report0_c_c

• 每个组件应按照组件类型+序号的形式方便后期维护调整
  例如report0、report1、chart0

• 每个组件名称中加上实际用途
  例如report0_sale_detail、chart0_sale_summary_column_chart

普通报表悬浮元素命名规则

• 每个悬浮元素名称中加上实际用途方便后期维护调整
  例如Float0_sale_detail_line_chart

用户权限

参见 权限细粒度控制

• 获取登录系统的用户名$fine_username
  例如登录用户名为 Anna
  $fine_username=Anna

• 获取登录系统的姓名用户名$fine_display_name
  例如登录用户名为 安娜(Anna)
  fine_display_name=安娜(Anna)

• 获取登录系统的姓名用户名$user_name
  例如登录用户名为 安娜(Anna)
  $user_name=安娜

  注此为新增服务器参数公示
  LEFT($fine_display_name, FIND(“(”, $fine_display_name) - 1)

• 获取登录系统的角色$fine_role
  1若登录用户为超级管理员
  $fine_role=superusers
  2若登录用户角色为角色数据架构师
  $fine_role=数据架构师
  3若登录用户无角色
  该参数值为空

• 获取部门职位$fine_position
  返回值为一个由部门和职位组成的数组
  1若登录用户为「人力资源-部长」
  $fine_position={“departments”:“人力资源”,“jobTitle”:“部长”}
  2若登录用户为「人力资源-部长」兼「领导部-部长」
  $fine_position={“departments”:“人力资源”,“jobTitle”:“部长”},{“departments”:“领导部”,“jobTitle”:“部长”}
  3若登录用户无部门职位
  该参数值为空

模版版本管理

参见 模板版本管理

• 开启版本功能在「文件>选项>常用」中「版本管理」设置中勾选「保存自动生成版本」默认为勾选状态
  
• 不勾选「保存自动生成版本」时则关闭版本功能版本选项灰化不可操作
  
• 每［ ］分钟每个用户同个模板最多保留一个版本
  勾选在规定周期内自动删除前一个版本只保留当前版本
  不勾选则每个版本都会保留
• 设置备注的版本不会被自动清理
  勾选设置备注的版本不会被删除其余不变
  不勾选则设置备注的版本与无备注的版本一致
• 模板版本控制存储优化
  勾选设计器在这两种情况下可进行模板版本控制存储优化
  1设计器启动时运行一次对模板版本控制存储的优化
  2点击「立即清理」按钮点击后立即进行模板版本控制存储优化并弹出正在优化进度提示框优化完成后提示已减小版本文件大小xxxKB。
  不勾选设计器不可定期对模板版本控制存储进行优化「立即清理」选项灰化不可操作
• 版本还原还原版本的时候会将目前没保存的模板自动生成一个版本所以无需担心未保存模板意外丢失的问题。

FineDB

参见 FineDB 数据库简介

内置数据库

• FineReport 报表工程内置了一个 HSQL 数据库作为 FineDB 数据库
• 内置 FineDB 数据库」为HSQL数据库使用时会建立内存数据库数据量大时会占用大量内存因此配置完外接数据库后请检查数据连接中是否存在「内置 FineDB 数据库」的数据连接。若存在相关数据连接请及时删除否则会持续占用服务器内存。
• 非必要请勿在 FineReport 工程中创建「内置 FineDB 数据库」的数据连接。
• 保存在 %FR_Home%/webapps/WEB-INF/embed 目录下
• 设计器连接 FineDB
  

外置数据库

配置外接数据库

参见FineDB 外接数据库

新建数据库

• 新建一个数据库用于存储平台相关数据。

外接数据库配置入口

• 管理员登录数据决策系统点击「管理系统>系统管理>常规>外接数据库>待配置」可为系统第一次配置外接数据库。
  

配置外接数据库

进入到外接数据库配置界面后选择数据库类型输入实际数据库相应的信息即可

• 勾选「迁移数据至要启用的数据库」新外接数据库为空
  点击「启用新数据库」后会将原 finedb 数据库的平台数据迁移到新外接数据库中。
• 勾选「迁移数据至要启用的数据库」新外接数据库中已存在平台数据
  点击「启用新数据库」后跳出提示「该数据库已存在平台数据导入数据前将清空原有平台数据确认连接该数据库」。
  点击「确定」将清空原有平台数据将原 finedb 数据库的平台数据迁移到新外接数据库中。
• 不勾选「迁移数据至要启用的数据库」新外接数据库为空
  点击「启用新数据库」后跳出提示「目标数据库为新数据库将当前数据迁移至目标数据库后方能使用」。
  点击「确定」将原 finedb 数据库的平台数据迁移到新外接数据库中。
• 不勾选「迁移数据至要启用的数据库」新外接数据库中已存在平台数据
  点击「启用新数据库」后工程会自动检测目标数据库中数据对应的 JAR 包版本和当前工程的 JAR 包版本是否一致。

数据表

参见FineDB 表结构
注下述所列数据表为常用数据表不是全部的

权限控制用户-部门职位-角色

• FINE_USER 用户表
• FINE_DEPARTMENT 部门表
• FINE_POST 职位表
• FINE_DEP_ROLE 部门职位的中间表用户通过该表关联部门与职务
• FINE_CUSTOM_ROLE 自定义角色表
• FINE_USER_ROLE_MIDDLE 用户角色的中间表用户通过该表关联到自定义角色和部门职务角色

系统管理配置

• FINE_CONF_ENTITY 存储配置类中的数据