1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.31 | 新增参数$fine_role_id，避免角色重命名导致权限配置失效 |
1.2 应用场景
程序开发语言中涉及到一些关键字，编程中自定义变量是禁止使用这些关键字的。
出于特定需求，FineReport 在设计时会给出特定的系统参数。
用户自定义参数时，需避免使用这些系统参数，否则可能会因为变量冲突而导致一系列的错误。
2. 系统参数
| 参数名 | 定义 | 具体应用参考 |
|---|---|---|
| $page_number | 报表当前访问的页码 | 具体应用请参考： |
| $totalPage_number | 报表的总页数 | |
| $fine_username | 在使用权限时保存用户名的参数 | 具体应用请参考： |
| $fine_role | 在使用权限时保存角色的参数 | |
| $fine_role_id | 获取登录系统的角色ID | |
| $fine_position | 在使用权限时保存用户所属的组织机构集合的参数 注：参数面板不支持获取$fine_position | |
| $fine_password | 在使用权限时保存用户登录密码的参数 注：使用 $fine_password 获取值时，值不会显示出来 | |
| $fine_display_name | 在使用权限时保存姓名的参数 | |
| $__count__ | 内置参数，表示总数 | 结果集筛选分栏 |
| NULL | 空值参数，表示不可用或不存在的数据 | 通俗的说，就是数据没有值，是不区分大小写的，使用范围广泛 |
| NOFILTER | 是专门用来比较的变量，且只可用作比较。 任何值与 NOFILTER 比较均返回 true。 | 这里的比较包括「大于，等于，小于，大于等于，小于等于」等等，不区分大小写 |
| reportname | 普通报表在工程reportlets文件夹中的存放路径 | 例如：doc/Form/FreeFrom/自由填报模板.cpt |
| formletname | 决策报表在工程reportlets文件夹中的存放路径 | 例如：doc/Form/FreeFrom/自由填报模板.frm |
| address | websocket 用于获取远程地址的参数 | |
| ENTRYID | 开启「超级链接继承权限」功能，基本无用户使用场景，这里列出主要是提醒用户定义参数时避免使用此名称。 | - |
| 注：以下参数应用均以 http://localhost:8075/webroot/decision/view/report?viewlet=workbook1.cpt 为例 | ||
| servletURL | 获取报表的相对路径 servletURL 意指 /webroot/decision/view/report | 具体应用请参考： |
| serverSchema | 协议名称。 serverSchema 意指 http | |
| serverName | 服务器地址或名称。 serverName 意指 localhost，即 IP。 | |
| serverPort | 访问的端口。 serverPort 意指 8075 | |
| serverURL | 访问服务的 URL serverURL 意指 http://localhost:8075 | |
| contextPath | 绝对路径的服务器别名，即虚拟目录。 contextPath 意指 /webroot | |
| sessionID | 在创建会话时，服务器会为每一个会话生成一个单独的标识，会话标识以长字符串数据类型返回。sessionID 等于本次会话 ID 的记录。 | sessionID 多用于 WEB 页面的统计 |
| 注：以下参数均为帆软内部定义的参数，用户应避免使用 | ||
| widgetVersion | 帆软内部定义的参数 | - |
| cid | 帆软内部定义的参数 | - |
_PAPERHEIGHT | 帆软内部定义的参数 | - |
| _PAPERWIDTH | 帆软内部定义的参数 | - |
