Skip to main content

​
1. 使用场景

数据准备是宜搭低代码平台中的一项关键功能，旨在帮助企业用户在进行数据分析和应用前对原始数据进行清洗、融合和转换。数据准备采用零代码ETL（Extraction Transformation Loading）方案处理来自宜搭内应用、企业外部数据库、文件型数据以及钉钉官方数据源（支持花名册、OA、智能人事、考勤等）的数据，通过构建数据加工流程，将零散数据整合为标准化数据集，以满足可视化分析和数据化决策的需求。

​
2. 数据准备介绍

​
3. 设置公式入口

路径：应用设置 > 数据工厂 > 数据准备>新建数据准备>选择数据集，选择关联节点、聚合节点、清洗节点，均需选择公式。 查看以下视频进行设置：

​
4. 逻辑处理类

​
CASEWHEN

用法1：CASEWHEN(<条件>,<值>,<条件>,<值>…), 类同SQL中的case when语法 示例：CASEWHEN(<性别字段>=“男”,“male”,<性别字段>=“女”,“female”)，则该字段值为”男”的被替换为”male”，“女”替换为”female” 用法2：CASEWHEN(<条件>,<值>,<条件>,<值>…<值>), 类同SQL中的case when语法 示例：CASEWHEN(<性别字段>=“男”,“male”,“female”)，则该字段值为”男”的被替换为”male”，非”男”替换为”female”

​
5. 文本处理类

​
LEN

用法：LEN([字符串字段])，函数返回为字符串的长度 示例：LEN(“test”)，返回值为4；LEN(“测试”)，返回值为2，一个中文对应1个英文字符。

​
LEFT

用法:LEFT(<度量字段>,< n >), 函数返回<字段>值从左边第1个字符开始,长度为n的字符串 示例:LEFT(字段1,3) 返回值为”ABC”;字段1的值为”ABCDEF”; 用法： RIGHT(<度量字段>,< n >), 函数返回<字段>值从右往左数的长度为n的字符串 示例：RIGHT(字段1,3) 返回值为”DEF”;字段1的值为”ABCDEF”;

​
MID

用法：MID(<度量字段>, < start >, < n >), 函数返回<字段>值从从左边第start个开始, 长度为n的字符串 示例：MID(字段1, 3, 3) 返回值为”CDE”;字段1的值为”ABCDEF”;

​
POS

用法：POS(<度量字段>,<字串>), 函数返回<字串>在<文本>中的位置, 如无匹配则返回0; 示例：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等于分隔字符的数量+1)，子串位置从1（从左往右）开始计数，或者从-1（从右往左）开始计数 示例：SPLITPART(<字段1>,A,2) 返回值为”BCD”;字段1的值为”ABCDABHABC”;子串位置填写-5时，也可以取到”BCD”

​
CONCAT

用法：CONCAT(<字段>,<字段>,…), 公式会将多个字段连接为一个字符串。入参必须为字符串类型的字段 示例：CONCAT(<字段1>,<字段2>) 返回值为”ABCD”;字段1的值为”A”，字段2的值为”BCD”

​
REPLACE

用法：REPLACE([字符串], [搜索字符串], [替换字符串]), 函数返回为替换后的字符串 示例：REPLACE([字段1], [字段2], [字段3])返回值为”a12345efg”;字段1的值为”abcdefg”,字段2的值为""bcd”,字段3的值为”12345”.

​
6. 时间处理类

​
NOW

用法：NOW()，获取当前时间，会精确到秒 示例：略

​
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，格式化时，也可以将连接符号”-”、“:”改为”/”、“年”、“月”、“日”等字符。

​
DATEADD

用法：DATEADD(<时间字段>,<偏移量>,<时间粒度>)，在<时间字段>的基础上增加**<时间粒度>**的<偏移量>。
  • 时间粒度取值：
  • 偏移量是需要增加或减少的具体数字，取值为正则表示增加，取值为负则表示减少。
示例1： 假设表单中日期组件的取值为”20200901”，那么DATEADD(日期组件,10,"DAY") = 20200911。 示例2： 假设表单中日期组件的取值为”20200901”，那么DATEADD(日期控件,-1,"DAY") = 20200831。
日期展示格式默认为yyyyMMdd，如需需要修改日期的展示格式可以参考DATEFORMAT函数的示例。

​
DATEDIFF

用法：DATEDIFF(<时间字段1>,<时间字段2>,<时间粒度>),返回的结果为时间段字段1减去时间段字段2在时间粒度上的差值。 时间粒度可选值为：
  • YEAR 年
  • MONTH 月
  • DAY 日
  • HOUR 时
  • MINUTE 分
  • SECOND 秒
示例：DATEDIFF(日期组件1,日期组件2,“DAY”)，返回值为2个日期组件相差天数 注意：参数仅支持日期组件，无法在公式输入固定日期值。 假设表单中日期控件的日期值为“2020-02-14”，假设今天为“2020-02-16”，那么使用 DATEDIFF(NOW(),填写日期,“DAY”) = 2， DATEDIFF(填写日期,NOW(),“DAY”) = -2

​
FROMUNIXTIME

用法：将数字型的unix时间日期值unixtime转为日期值 函数声明：
参数说明：
  • unixtime：Bigint类型，秒数，unix格式的日期时间值，若输入为string，double，decimal类型会隐式转换为bigint后参与运算。
  • 返回值：Datetime类型的日期值，unixtime为NULL时返回NULL。
示例：

​
WEEK

用法：WEEK([日期], [起始日(可以不指定)]), 计算日期年份中的哪一周, 起始日不指定，默认一周的第一天是周一，起始日的值为：1-7 分别表示周一为第一天… 周日为第一天 示例：WEEK([日期],)返回值为”20202”;字段的值为”2020-01-08”，起始日可以不指定，默认为空。

​
QUARTER

用法：QUARTER([日期], [是否是财年(可以不指定)]), 计算日期年份中的哪一季度, 是否是财年：1表示按照财年统计(4月份), 0表示按照自然年 示例：QUARTER([字段1], 0)返回值为”1”;字段1的值为”2020-02-02”

​
7. 基础统计类

​
ROUND

用法：ROUND(<字段>,<精度>), 四舍五入地对字段进行小数位数调整 示例：ROUND(<字段1>,<精度>) 返回值为”12.33”;字段1的值为”12.33333”，精度为2

​
MOD

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

​
ParseDouble

用法：ParseDouble（<字段>），字符串或整数强转浮点数 示例：ParseDouble（＜字段＞），如果字段的值是3或“3”，则结果3.0

​
ParseInt

用法：Parselnt（＜字段>），字符串或浮点数强转整数 示例：Parselnt（＜字段＞），如果字段的值是3.2或“3.2”，则结果3

​
8. 数组类

​
ArrayToString

用法：ArrayToString(<数组字段>,[分隔符可选])，将数组转换为字符串 示例：ArrayToString(<字段1>,<字段2>) 返回值为”产品部-技术部-业务部”;字段1的值为”[产品部，技术部，业务部]“，字段2的值为”-“；若字段2的值为空，则返回”产品部,技术部,业务部”

​
StringToArray

用法：StringToArray(<数组字段>,[分隔符可选])，将字符串解析为数组 示例：StringToArray(<字段1段>,<字段2>) 返回值为”[产品部,技术部,业务部]“;字段1的值为”产品部-技术部-业务部”，字段2的值为”-”

​
ArrayLength

用法：ArrayLength(<数组字段>)，返回数组长度 示例：ArrayLength(<多选等数组字段>)返回值为”3”;字段的值为”部门”，其选项为”产品部,技术部,业务部”

​
ArrayCat

用法：ArrayCat(<数组字段1>,<数组字段2>,…)，返回多数组拼接格式 示例：ArrayCat(<多选等数组字段1>,<多选等数组字段2>,…)返回值为”产品部,技术部,业务部,产品人员,技术人员,业务人员”;字段1的值为”产品部,技术部,业务部”，字段2的值为”产品人员,技术人员,业务人员”

​
9. 常见问题