目录

  • 报表命名规范
  • 数据集命名规则
  • 参数命名规则
  • 条件属性命名规则
  • 超链接命名规范
  • 决策报表组件命名规则
  • 普通报表悬浮元素命名规则
  • 用户权限
  • 模版版本管理
  • FineDB
  • 内置数据库
  • 外置数据库
  • 配置外接数据库
  • 新建数据库
  • 外接数据库配置入口
  • 配置外接数据库
  • 数据表
  • 权限控制：用户-部门职位-角色
  • 系统管理：配置


报表命名规范

参见： 报表开发规范手册

数据集命名规则

  • 参数面板数据集：以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 外接数据库

新建数据库
  • 新建一个数据库，用于存储平台相关数据。
外接数据库配置入口
  • 管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库>待配置」，可为系统第一次配置外接数据库。
配置外接数据库

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

帆软批量导入提示session closed_数据库

  • 勾选「迁移数据至要启用的数据库」，新外接数据库为空
    点击「启用新数据库」后，会将原 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 存储配置类中的数据