FineReport使用

报表命名规范

参见： 报表开发规范手册

数据集命名规则

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

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

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

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

参数命名规则

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

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

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

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

• 全局参数：以g开头
  例如：gSaleGroup，gProduct，gPerson

• 模板参数：以p开头
  例如：pDate，pCurrency，pUnit

• 数据集参数：以s开头
  例如：sCompany，sProject

条件属性命名规则

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

• 格式：条件类型_具体功能
  例如：列宽_隐藏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 存储配置类中的数据