<< Click to Display Table of Contents >> 内置参数的使用复制链接 |
1. 值已确定的内置参数
这些参数直接引用即可,一部分参数根据登录用户来获取值(比如_USER_,_IP_等),一部分参数根据当前时间来获取值(比如_LAST_YEAR_,_THIS_MONTH_等),可以用于过滤,填报,参数值显示等任何需要用到内置参数的场景。
参数名称 |
说明 |
_USER_ |
返回当前的用户名称 |
_GROUP_ |
返回当前用户所在的组名 |
_GROUPS_ |
返回当前用户所在的组名(多个组) |
_ROLE_ |
返回当前用户所承担的角色 |
_ROLES_ |
返回当前用户所承担的角色(多个角色) |
_BLANK_ |
返回数据中的空值。参见_BLANK_示例 |
_USER_ALIAS_ |
返回当前登录用户的昵称 |
_NOW_ |
返回当前时间(类型为时间戳) |
_IP_ |
返回当前登陆用户的IP |
_NOW_LONG_ |
返回当前时间(类型为数值) |
_LAST_YEAR_ |
返回当前时间的上一年年份,值为整数,如今年是2013年,则返回值为2012 |
_THIS_YEAR_ |
返回今年的年份,值为整数 |
_NEXT_YEAR_ |
返回下一年的年份,值为整数 |
_LAST_QUARTER_ |
返回当前季度的上一季度值,值为整数 |
_THIS_QUARTER_ |
返回当前季度值,值为整数 |
_NEXT_QUARTER_ |
返回当前季度的下一季度值,值为整数 |
_LAST_MONTH_ |
返回当前月份的上一月份值,值为整数 |
_THIS_MONTH_ |
返回当前月份值,值为整数 |
_NEXT_MONTH_ |
返回当前月份的下一月份值,值为整数 |
_LAST_WEEK_ |
返回在一年中当前周的上一周值,值为整数,如今天是2013-01-18,是2013年中的第3周,则返回值为2 |
_THIS_WEEK_ |
返回当前日期是今年的第几周,值为整数,如今天是2013-01-18,是2013年中的第3周,则返回值为3 |
_NEXT_WEEK_ |
返回在一年中当前周的下一周值,值为整数,如今天是2013-01-18,是2013年中的第3周,则返回值为4 |
_LAST_DAY_ |
返回当前日期的前一天是几号,值为整数,如今天是2013-01-18,则返回值为17 |
_THIS_DAY_ |
返回当前日期是几号,值为整数,如今天是2013-01-18,则返回值为18 |
_NEXT_DAY_ |
返回当前日期的下一天是几号,值为整数,如今天是2013-01-18,则返回值为19 |
_LAST_YEAR_QUARTER_ |
返回当前季度的上一季度的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-01-01 |
_THIS_YEAR_QUARTER_ |
返回当前季度第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-01 |
_NEXT_YEAR_QUARTER_ |
返回当前季度的下一季度的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-07-01 |
_LAST_YEAR_MONTH_ |
返回当前月份的上一月份的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-03-01 |
_THIS_YEAR_MONTH_ |
返回当前月份的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-01 |
_NEXT_YEAR_MONTH_ |
返回当前月份的下一月份的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-05-01 |
_LAST_YEAR_WEEK_ |
返回当前周的上一周的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-07。注意星期是根据java提供的规范进行计算的,把周日当做一周的起点 |
_THIS_YEAR_WEEK_ |
返回当前周的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-14 |
_NEXT_YEAR_WEEK_ |
返回当前周的下一周的第一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-21 |
_LAST_FULL_DAY_ |
返回当前日期的前一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-17 |
_THIS_FULL_DAY_ |
返回当前日期,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-18 |
_NEXT_FULL_DAY_ |
返回当前日期的后一天,返回值为日期类型,如今天是2013-04-18,则返回值为2013-04-19 |
_LAST_WEEKDAY_ |
返回当前日期的前一天是周几,返回值为整数,如今天是2013-04-18,则返回值为4。注意星期是根据java提供的规范进行计算的,把周日当做一周的起点 |
_THIS_WEEKDAY_ |
返回当前日期的是周几,返回值为整数,如今天是2013-04-18,则返回值为5 |
_NEXT_WEEKDAY_ |
返回当前日期的后一天是周几,返回值为整数,如今天是2013-04-18,则返回值为6 |
_CURRENT_LOCALE_ |
返回当前环境的区域和语言 |
_EXECUTION_ID_ |
返回流程审批获取当前流程的分支id。 |
_INSTANCE_ID_ |
返回流程审批中获取当前流程id。 |
_P_ |
返回当前预览页面页码 |
_PT_ |
返回当前报告总页数 |
•_BLANK_示例
假设数据库表中的数据如下:
过滤里定义条件:string 是 = ?{_BLANK_},则过滤出string为空字符串的数据,也就是上图数据库表里的最后一行数据。
如果过滤里定义条件:string 是 空,则过滤出string为null,空的数据,也就是上图的数据库表里的第一行数据。
•内置日期参数示例
比如文本组件输入?{_THIS_FULL_DAY_}可以显示当前最新日期。
过滤里选择日期列,输入?{_THIS_FULL_DAY_}参数,可以过滤出对应列当天的数据。
参数名称 |
数据类型 |
说明 |
_RESULT_NOT_EMPTY_ |
Boolean |
报表实时刷新时,如果执行的结果为空时,从缓存获取数据,以免组件上出现空数据的现象 |
_WARNING2HINT_ |
Boolean |
当报表出现错误弹框时,报表不弹出dialog进行提示(弹出后需要手动点击),改为hint进行提示 |
_MAX_ROWS_ |
String/Integer |
控制报表中组件的显示行数,导出数据也受控制 |
_M_REFRESH_ |
Boolean |
控制同步到集市的数据集,预览数据和再次物化数据集时是通过集市处理还是数据库处理 |
_REFRESH_ |
Boolean |
控制每次打开数据集和报表是否刷新数据 |
_DISABLE_AUTO_LINK_ |
Boolean |
控制是否识别数据内容为超链接 |
_EXCEL_EXPORT_TYPE_ |
String/Integer |
导出excel时sheet页配置 0:同时导出Dashboard页和所有细节表 1:只导出Dashboard页,不导出细节表 2:只导出所有组件的细节表,不导出Dashboard的整体页面 |
_EXCEL_EXPORT_SHEETNAME_ |
String |
自定义导出Excel时Dashboard页的名称 |
_KEEP_EXCEL_DATA_SPAN_ |
Boolean |
控制导出excel时,数据是否带有合并单元格。为true时,导出详细数据也保留合并单元格。默认为false不会合并单元格 |
_SELF_CTRL_PAGE_ |
Boolean |
控制详细表格设置分页后,查看时是否以真分页方式获取数据。当前Oracle、Oracle、SQL Server 、MySQL、DB2已经自动支持真分页,对于暂未支持的数据库类型,数据集SQL语句如下: select * from coffee <_PAGE_> where ID BETWEEN (?{@_PAGE_} - 1) </_PAGE_> <_PAGE_LIMIT_> * ?{@_PAGE_LIMIT_} AND </_PAGE_LIMIT_> <_PAGE_> ?{@_PAGE_} </_PAGE_> <_PAGE_LIMIT_>* ?{@_PAGE_LIMIT_} </_PAGE_LIMIT_> 结合_SELF_CTRL_PAGE_可以实现真分页,有以下两种方式: •在编辑参数中添加_SELF_CTRL_PAGE_=true,对报告中所有的普通表实现真分页。 •在脚本中添加图表1.innerParam["_SELF_CTRL_PAGE_"] = true,只对当前设置的普通表实现真分页。 |
_PAGE_COUNT_AYSN_ |
Boolean |
配合参数_SELF_CTRL_PAGE_一起使用,还未实现真分页的数据库设置了上述真分页,总条数和第一页数据会在一个请求返回,设置为true后,会分开发请求返回数据。 |