自定义函数

编辑
文档创建者:royide (71779 )     浏览次数:1770次     编辑次数:7次     最近更新:doreen0813 于 2018-08-21     

目录:

1、描述编辑

FineBI已经提供了大量的自带函数,在正常情况下足够满足用户的模板制作需求,但是在一些特殊领域,可能需要一些特殊的函数,在这种情况下,FineBI提供了自定义函数机制,可以由用户根据业务需要自己来定义一些函数,但这些函数必须满足FineBI函数定义规则。

FineBI函数定义规则:Functionname(Para,Para,...),其中Functionname为函数名,Para为参数。
在FineBI中,每一个函数都被定义成一个类,这个类必须要实现Function这个接口,在运算的时候首先通过函数名反射取得这个类,然后调用它的run(Object[] agrs)方法。下面以StringCat这个函数(自定义拼接字符串函数)为例。

2、实现步骤编辑

2.1 编写自定义函数
下面以一个简单的自定义函数例子来说明使用自定义函数。我们定义一个函数StringCat,他的作用是把所有的参数以字符串的形式连接起来。
StringCat函数使用规则为StringCat(Para,Para,Para…….);
其中Para为该函数的参数,个数不限。
由概述可知AbstractFunction实现了Function这个接口,因此StringCat可以直接继承AbstractFunction类,完整代码如下:
package com.fr.function; import com.fr.script.AbstractFunction; public class StringCat extends AbstractFunction { public Object run(Object[] args) { String result = ""; Object para; for (int i = 0; i < args.length; i++) { para = args[i]; result += para.toString(); } return result; } }
说明: 使用函数StringCat(Para,Para,Para…..)时,根据函数名取得运算该函数的类StringCat,并将参数传入类中的args对象数组中,执行该类的run函数。
注:在FineBI中使用时,若要在前端获取函数的描述信息需要通过getCN()函数,具体getCN()函数使用如下所示:
@Override public String getCN() { return "StringCat()函数用常于对字符串进行拼接,可支持用户进行多个字符串拼接。"; }
2.2 编译自定义函数
将编译后的StringCat.class放到FineBI的安装目录WEB-INF下面的classes目录(需要手动新建目录)下,因为StringCat.java属于包com.fr.function,所以StringCat.class需要放到%FineBI_HOME%\WebReport\WEB-INF\classes\com\fr\function目录下
2.3 注册自定义函数
生成该函数的类后需要在设计器中进行注册,才可以使用该函数。打开服务器>函数管理器,(首先在FineReport设计器切换工作目录到FineBI\webapps\WebReport\WEB-INF)选择刚刚定义好了StringCat类,如下图

222
函数名称可以自定义,如这边定义为StringCat;
同时可以添加该函数的使用说明,如上图所示的描述。

3、调用自定义函数编辑

编译保存好StringCat函数之后,重启FineBI,在业务包中对某张数据表做ETL新增公式列操作,在其他函数中便能看到刚刚自定义成功的StringCat函数了。
222

附件列表


主题: 专题总结
标签: 暂无标签 编辑/添加标签
如果您认为本文档还有待完善,请编辑

文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

本文档是否有用?