一、自定字段-函数说明

有时候，原始表单中的数据，我们需要经过一些自定义的处理之后才能展示。例如：

• 表单中的数据是每个员工填写的，而报表中希望展示每天填写表单的员工人数，这个就需要使用到COUNT()函数计算之后作为结果来进行展示了
• 用户希望在表单中新增一些自定义的字段，然后通过这些字段关联超链接来做页面跳转，这样的需求也可以使用到这里的自定义公式字段的功能

为了实现上述需求，我们需要先来了解一下，目前宜搭平台对于报表都提供了哪些公式，主要分为下面两大类：

• 字符串处理类
• 聚合类

下面是自定义公式的操作入口，表单设计页-》选择数据集-》选择列字段fx，此时会弹出一个“设置计算公式”的弹窗，可以通过点击或者搜索的方式选择我们需要使用的函数以及需要处理的原表单字段，相关的公式内容会显示在“自定义字段”内，并且下面会提供函数的说明，还可以点击示例进一步学习相关的用法。

二、逻辑判断类

条件判断：
!=

空值判断：
[字段名称] IS NULL
[字段名称] IS NOT NULL

逻辑判断：
AND
OR
NOT

三、字符串处理类

LEN

用法：LEN([字符串字段])，函数返回为字符串的长度
示例：LEN(“test”)，返回值为4；LEN(“测试”)，返回值为6，因为一个中文对应3个英文字符，如果要计数中文的个数，需要再除以3。

LEFT

用法: LEFT(<度量字段>,< n >), 函数返回<字段>值从左边第1个字符开始,长度为n的字符串

示例: LEFT(字段1,3) 返回值为”ABC”;字段1的值为”ABCDEF”;

RIGHT

用法: RIGHT(<度量字段>,< n >), 函数返回<字段>值从右往左数的长度为n的字符串

示例: RIGHT(字段1,3) 返回值为”DEF”;字段1的值为”ABCDEF”;

MID

用法: MID(<度量字段>, < start >, < n >), 函数返回<字段>值从从左边第start个开始, 长度为n的字符串

示例: MID(字段1, 3, 3) 返回值为”CDE”;字段1的值为”ABCDEF”;

POS

用法: POS(<度量字段>,<字串>), 函数返回<字串>在<文本>中的位置, 如无匹配则返回-1;

示例: POS(字段1,”DE”) 返回值为4;字段1的值为”ABCDEF”;

UPPER

用法: UPPER(<度量字段>), 将<字段>的值转换成大写;

示例: UPPER(字段1) 返回值为”ABCDEF”;字段1的值为”AbcdeF”;

LOWER

用法: LOWER(<度量字段>), 将<字段>的值转换成小写;

示例: LOWER(字段1) 返回值为”abcdef”;字段1的值为”AbcdeF”;

VAL

用法: VAL(<度量字段>), 将<字段>文本类型转换成数值类型

示例: VAL(字段1) 返回值为 123;字段1的值为”123”;

LEFTTRIM

用法: LEFTTRIM(<度量字段>), 去掉<字段>左边的空格后返回

示例: LEFTTRIM(字段1) 返回值为”ABC”;字段1的值为” ABC”;

RIGHTTRIM

用法: RIGHTTRIM(<度量字段>), 去掉<字段>右边的空格后返回

示例: RIGTTRIM(字段1) 返回值为”ABC”;字段1的值为”ABC “;

NUMBERTOSTRING

用法: NUMBERTOSTRING(<数值>), 数值类型的数据转换成字符串

示例: NUMBERTOSTRING(字段1) 返回值为”12345”;字段1的值为”12345 “;

SPLITPART

用法: SPLITPART(<字符串字段>,分隔字符，子串位置), 公式会将一个字符串按照“分隔字符”将其分为N个子串(N等于分隔字符的数量*2+1)，子串位置从1（从左往右）开始计数，或者从-1（从右往左）开始计数

示例: SPLITPART(<字段1>,A,2) 返回值为”BCD”;字段1的值为”ABCDABHABC”;子串位置填写-5时，也可以取到”BCD”

CONCAT

用法: CONCAT(<字段>,<字段>,…..), 公式会将多个字段连接为一个字符串。入参必须为字符串类型的字段

示例: CONCAT(<字段1>,<字段2>) 返回值为”ABCD”;字段1的值为”A”，字段2的值为”BCD”

ROUND

用法: ROUND(<字段>,<精度>), 四舍五入地对字段进行小数位数调整

示例: ROUND(<字段1>,<精度>) 返回值为”12.33”;字段1的值为”12.33333”，精度为2

MOD

用法: MOD(<字段>,<字段>), 取模（取余）运算 ，返回取模值（或余数）。
说明：若要获得除法的商，可使用/ 四则运算符，比如 6/4 得到 商1余2。
示例: MOD(<字段1>,<字段2>) 字段1的值为”6”，字段2的值为”4”，返回值为”2”;

CASEWHEN

用法1: CASEWHEN(<条件>,<值>,<条件>,<值>…..), 类同SQL中的case when语法

示例: CASEWHEN(<性别字段>=”男”,”male”,<性别字段>=”女”,”female”)，则该字段值为”男”的被替换为”male”，”女”替换为”female”

用法2:CASEWHEN(<条件>,<值>,<条件>,<值>…..<值>), 类同SQL中的case when语法

示例: CASEWHEN(<性别字段>=”男”,”male”,”female”)，则该字段值为”男”的被替换为”male”，非”男”替换为”female”

STRINGTODATE

用法: STRINGTODATE(<字段>,<格式>), 字符串转时间

示例: STRINGTODATE(“1989-09-27”,”yyyy-MM”)返回值为”198909”

以上两个函数的format格式目前统一为java 中格式化保持一致，支持格式类型如下：

yyyy：年

MM：月

dd：日

hh：1~12小时制(1-12)

HH：24小时制(0-23)

mm：分

ss：秒

TODAY()

用法：TODAY()，获取当天日期
示例：略

NOW

用法: NOW()，获取当前时间，会精确到秒

示例: 略

DATEADD

用法: DATEADD(<时间字段>,<偏移量>,<时间粒度>),在<时间字段>的基础上增加”时间粒度”乘以”数量”的时间偏移量

时间粒度可选值为：

• YEAR 年
• MONTH 月
• DAY 日
• HOUR 时
• MINUTE 分
• SECOND 秒

示例1:
假设表单中日期控件的取值为”20200901”，那么
DATEADD(日期控件,10,”DAY”) = 20200911

示例2:
DATEADD(日期控件,-1,”DAY”) = 20200831

备注：日期默认的展示格式就是“yyyyMMdd”，需要修改日期的展示格式可以参考DATEFORMAT函数的示例。

DATEDIFF

用法: DATEDIFF(<时间字段1>,<时间字段2>,<时间粒度>),返回的结果为时间段字段1减去时间段字段2在时间粒度上的差值。

时间粒度可选值为：

• YEAR 年
• MONTH 月
• DAY 日
• HOUR 时
• MINUTE 分
• SECOND 秒

示例: DATEDIFF(“2020-09-11”,”2020-09-1”,”DAY”)，返回值为10

假设表单中日期控件的日期值为“2020-02-14”，假设今天为“2020-02-16”，那么使用
DATEDIFF(TODAY(),填写日期,”DAY”) = 2，
DATEDIFF(填写日期,TODAY(),”DAY”) = -2

DATEFORMAT

用法: DATEFORMAT(<日期字段>,<时间格式>),将日期格式化成字符串

以上两个函数的format格式目前统一为java 中格式化保持一致，支持格式类型如下：

• yyyy：年
• MM：月
• dd：日
• hh：1~12小时制(1-12)
• HH：24小时制(0-23)
• mm：分
• ss：秒

示例1:
DATEFORMAT(<日期字段>,”yyyy-MM-dd”)，若日期字段有个值为1989年8月4日，则返回值为1989-08-04，格式化时，也可以将”-“改为”/“等字符。

示例2:
DATEFORMAT(<日期字段>,”yyyy-MM-dd HH:mm:ss”)，若日期字段有个值为2020年9月1日下午1点30分整，则返回值为2020-09-01 13:30:00，格式化时，也可以将连接符号”-“、“:”改为”/“、“年”、“月”、“日”等字符。

四、聚合类

为了便于演示聚合类字段的使用效果，这里以一个实际的案例来辅助介绍。

首先，假设我们通过多个表单收集到了如下的两个数据集“示例数据集1”和“示例数据集2”。

示例数据集1

数据集

表格

示例数据集2

数据集

表格

SUM

用法:SUM(<度量字段>,[条件],[排除字段]) 返回合乎[条件]下, 对<字段>进行求和的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集1

部门团建费=SUM(费用, 预算类型=”团建费”) :

表格结果

BU团建费=SUM(费用, 预算类型=”团建费”, 部门) :

表格结果

AVG

用法:AVG(<度量字段>,[条件],[排除字段])返回合乎[条件]下, 对<字段>进行求平均的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集1

部门平均团建费=AVG(费用, 预算类型=”团建费”,部门):

表格结果

所有平均团建费=AVG(费用, 预算类型=’团建费’,部门,BU) :

表格结果

MAX

用法: MAX(<度量字段>,[条件],[排除字段])返回合乎[条件]下, 对<字段>求最大值的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集1

部门最高团建费=MAX(费用, 预算类型=’团建费’) :

表格结果

BU最高团建费=MAX(费用, 预算类型=”团建费”, 部门) :

表格结果

MIN

用法: MIN(<度量字段>,[条件],[排除字段])返回合乎[条件]下, 对<字段>求最小值的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集1

部门最低团建费=MIN(费用, 预算类型=”团建费”) :

表格结果

BU最低团建费=MIN(费用, 预算类型=”团建费”, 部门) :

表格结果

COUNT

用法:COUNT(<度量字段>,[条件],[排除字段])返回合乎[条件]下, 对<字段>进行计数的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集2

部门预算条数 = COUNT(部门, 费用>0,预算类型)

表格结果

COUNTDISTINCT

用法: COUNTDISTINCT(<度量字段>,[条件],[排除字段])返回合乎[条件]下, 对<字段>进行去重计数的结果, [排除字段] 不参与求和的交叉计算;

示例:使用示例数据集2

BU部门数量 = COUNTDISTINCT(部门, 费用>0,预算类型)

表格结果

五、常见问题

Q1：我需要在表格中设置几个字段，点击之后可以跳转到其他的表单页应该怎么做？

然后再到“链接”中添加待跳转的页面的链接。

备注：一般选择外部链接（标准），专题是同一个报表里面的页面。