web报表工具FineReport常用函数的用法总结（报表函数）

说明：本次总结中，凡是以tableName或viewName作为参数因子的。函数在调用的时候均按照先从私有数据源中查找，然后再从公有数据源中查找的顺序。

 

CLASS

CLASS(object):返回object对象的所属的类。

 

CNMONEY

CNMONEY(number,unit)返回人民币大写。

number:需要转换的数值型的数。

unit:单位，"s","b","q","w","sw","bw","qw","y","sy","by","qy","wy"分别代表“拾”，“佰”，“仟”，“万”，“拾万”，“佰万”，“仟万”，“亿”，“拾亿”，“佰亿”，“仟亿”，“万亿”。

备注:

单位可以为空，如果为空，则直接将number转换为人民币大写，否则先将number与单位的进制相乘，然后再将相乘的结果转换为人民币大写。

示例:

CNMONEY(1200)等于壹仟贰佰圆整。

CNMONEY(12.5,"w")等于壹拾贰万伍仟圆整。

CNMONEY(56.3478,"bw")等于伍仟陆佰叁拾肆万柒仟捌佰圆整。

CNMONEY(3.4567,"y")等于叁亿肆仟伍佰陆拾柒万圆整。

 

COL

COL()返回当前单元格的列号。

示例:

如果当前单元格是A5，在A5中写入"=col()"则返回1。

如果当前单元格是C6，在C6中写入"=col()"则返回3。

 

COLCOUNT

COLCOUNT(tableData):返回tableData中列的个数。

tableData:tableData的名字，字符串形式的。

备注：

先从私有数据源中查找，然后再从公有数据源中查找，返回的是第一个查找到的tableData中列数。

示例:

以我们提供的数据源FRDemo为例

COLCOUNT("Check")等于6。

COLCOUNT("country")等于5。

 

COLNAME

COLNAME(tableData,colIndex)返回的是tableData中列序号colIndex的列名。

tableData:表示TableData的名字，字符串形式。

colIndex:表示列序号。

备注:

TableData先从私有数据源中查找，再从公有数据源中查找。

示例:

COLNAME("Check"，3)等于AcceName。

COLNAME("country"，4)等于Area。

 

EVAL

EVAL(exp):返回表达式exp计算后的结果。

exp:一个表达式形式字符串。

备注:

只要EVAL中的参数exp最终可以转化成一表达式形式的字符串，比如"sum(2,4)","2+7"等等，那么它就可以被计算。

示例:

EVAL("2+5")等于7。

EVAL("count(2,3)")等于2。

EVAL("sum"+"(2,3,5)")等于10。

EVAL(IF(true,"sum", "count") + "(1,2,3,4)")等于10。

EVAL(IF(false,"sum", "count") + "(1,2,3,4)")等于4。

 

FIELDS

FIELDS(connectionName,tableName):返回tableName这个表中的所有字段名。

示例：

数据库BASE中有个名叫task的表的内容如下：

namestart end

a2008 2009

b2009 2012

那么FIELDS("BASE","task")等于[name,start,end].

 

FORMAT

FORMAT(object,format):返回object的format格式。

object:需要被格式化对象，可以是String，数字，Object(常用的有Date, Time)。

format:格式化的样式。

备注:

此处的格式中大小写必须严格按照上面例子中的规则，月份:大写MM，年份小写:yyyy或yy，天份:小写dd.

此处作为参数因子的格式可以用' '也可以用" "引用。

示例:

Format(TODAY(),'yyyy-MM-dd')结果是2008-11-01

 

INMAP

INMAP(key,value, mapName):判断数据字典mapName中是否包含键值为key，值为value的数据对。返回值为布尔型。有返回TRUE，没有返回FALSE。

key:检测的key。

value:检测的value。

mapName:指定的数据字典名。

备注:

mapName必须为String型的。

示例:

INMAP(1,2, "customerdic")返回 Boolean.TRUE(布尔型的)。

 

ISNULL

ISNULL(object):判断对象中所有的值是否全部都是Primitive.NULL。

 

MAP

MAP(key,mapName):返回名字为mapName的数据字典中的key所对应的值。

key:与返回值相应的数据字典中的key。

mapName:指定的数据字典名，注意数据字典名要加引号

示例:

MAP(1,"customername")等于"Yixing HongdaFood Co."。

 

RECORDS

RECORDS(connection,table,field):返回数据库表table中字段名field下的所有元素。

示例：

数据库BASE中有个名叫task的表的内容如下：

namestart end

a2008 2009

b2009 2012

那么RECORDS("BASE","task","end")等于[2009,2012].

RECORDS(connection,table,field,row)返回table中field字段下的第row行的记录，field可以为列名也可以为列号。

RECORDS("BASE","task","end",2)等于2012.

RECORDS("BASE","task",2,2)等于2009.

 

REVERSE

REVERSE(value):返回与value相反的逻辑值。

示例：

REVERSE(true)等于false。

 

ROW

ROW()返回当前单元格的行号

示例:

如果当前单元格为A5，在A5中写入"=ROW()"则返回5。

如果当前单元格为B8，在B8中写入"=ROW()"则返回8。

 

ROWCOUNT

ROWCOUNT(tableData)返回tableData的行数。

tableData:TableData的名字，字符串形式的。

备注:

先从私有数据源中查找，然后再从公有数据源中查找，返回的是tableData的行数。

示例:

以我们提供的数据源FRDemo为例

ROWCOUNT("Check")等于3。

ROWCOUNT("country")等于18。

 

TABLEDATAFIELDS

TABLEDATAFIELDS(tableData):返回tableData中所有的字段名。

备注:

先从报表数据集中查找，然后再从服务器数据集中查找，返回的是tableData的列名组成的数组。

示例:

TABLEDATAFIELDS("国家")等于[名字,首都,大陆,面积,人口

 

TABLEDATES

TABLEDATAS():返回报表数据集和服务器数据集名字。]

示例：

服务器数据集有：ds1,ds2,ds3;报表数据集有dsr1,dsr2.

TABLEDATAS()等于[dsr1,dsr2,ds1,ds2,ds3].

而TABLEDATAS(0)返回服务器数据集名字；TABLEDATAS(1)返回报表数据集名字；

TABLEDATAS(0)等于[ds1,ds2,ds3];TABLEDATAS(1)等于[dsr1,dsr2].

 

TABLES

TABLEAS(connectionName):返回名为connectionName的数据库中的所有表名。

示例：

假设在FRDemo这个数据库中，有3个表：a,b,c;

那么TABLES("FRDemo")等于[a,b,c].

 

VALUE

VALUE(tableData,row,col)返回tableData中行号为row，列号为col的值。

tableData:tableData的名字，字符串形式的。

row:行号。

col:列号。

备注:

先从私有数据源中查找，然后再从公有数据源中查找，返回的是tableData的符合条件的值。

示例:

VALUE("country"，5，3)等于South America。

VALUE("Simple"，8，3)等于jonnason。