历史版本8 :自定义函数实现字符串拼接 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 预期效果

能够在 BI 中使用 StringCat 函数进行拼接字符串,例如要将「合同事实表」下的「合同ID」和「合同付款类型」拼接成一个字段,如下图所示:

1612229884767356.png

注:公式框中的函数、字段都需要点击左侧的选择区域选择,不能手动输入。

1.2 实现思路

 AbstractFunction 实现了 Function 接口,因此 StringCat 可以直接继承 AbstractFunction 类。

使用函数 StringCat(Para,Para,Para…..) 时,根据函数名取得运算该函数的类 StringCat,并将参数传入类中的 args 对象数组中,执行该类的 run 函数。 而在 run 函数中即实现了将传入的参数以字符串的形式连接起来。并返回最终形成的字符串。

注:自定义函数定义规则、注意事项详情参见:自定义函数简介

1.3 函数简介

函数 StringCat :作用是把所有的参数以字符串的形式连接起来。

StringCat 函数使用规则为 StringCat(Para,Para,Para…….);其中 Para 为该函数的参数,个数不限。

2. 示例:方法一编辑

2.1 编写 Java 文件

编写StringCat.java, 函数代码如下:

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;
}
}

2.2 编译 class 文件

2.2.1 编译环境准备

详情参见:编译Java程序

2.2.2 生成 class 文件

编译 StringCat.java,生成类 StringCat.class 。

2.2.3 导入 class 文件

将编译后的StringCat.class放到 FineBI 的安装目录%FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function下,如下图所示:

注:若 WEB-INF 下没有对应目录则新建即可。

2.3 使用自定义函数

重启 FineBI后便可直接使用,使用方法与内置的函数是相同的。

比如在添加计算指标中,其他函数下面可以看到之前自定义的函数 Stringcat,点击该函数可添加到公式中使用,如下图所示:

将「合同事实表」下的「合同ID」和「合同付款类型」拼接成一个字段,输入公式:StringCat(合同ID," ",合同付款类型),如下图所示:

注:公式框中的函数、字段都需要点击左侧的选择区域选择,不能手动输入。

2.5 效果查看

详情参见本文 1.1 节。

3. 示例:方法二编辑

参照本文 2.1 2.2.1 2.2.2 编译生成 StringCat.class 文件。

3.1 导入 Class 文件

将 StringCat.class 文件存放至 %FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function 目录下,如下图所示:

文件可存放在 FineBI 工程目录的任何位置,但是要和 java文件里 package 下的位置相对应,例如本示例为:

package com.fr.function;

因此需要将 class 文件存放至 %FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function 文件下。

如果代码为:

package com;

则可将文件存放至%FineBI%\webapps\webroot\WEB-INF\classes\com 下。

3.2 注册自定义函数

生成该函数的类后需要在 FineReport 设计器中进行注册,才可以使用该函数。

使用 FineReport 设计器远程连接 FineBI 工程  ,打开服务器>函数管理器,添加函数并命名为「StringCat」,选择定义好的 StringCat 类,并保存,如下图所示:

3.3 使用自定义函数

重启 FineBI后便可直接使用,使用方法与内置的函数是相同的。

注:注册后取消远程连接,自定义函数仍可使用。

3.4 效果查看

详情参见本文 1.1 节。