1.1 预期效果

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

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

1.2 实现思路

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

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

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

1.3 函数简介

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

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

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 节。