轻易云数据集成平台的自定义函数使用教程

轻易云数据集成平台的函数使用MySQL函数，控制流程。用户可以像使用MySQL一样编写每个字段的属性值进行特殊处理。自定义函数必须以_function开头。

动态值在函数中的应用

在使用过程中，需要用到动态值变量，通过{value}插入。如果处理字符串，则需要加上单引号，如：'{value}'。
示例1：计算单价乘以数量得到金额：

_function{price}*{qty}

示例2：计算结果保留两位小数，四舍五入：

_functionROUND({price}*{qty},2)

示例3：替换字符串中的特定字符：

_functionREPLACE('{customer_name}','张三','李四')
//将客户名称中的“张三”替换为“李四”。使用字符串时需加引号。

常用函数集合

字段值用户可自行编写自定义函数。同时，轻易云集成平台提供大量预设函数供快速复用。

在字段属性配置页面有【函数助手】功能，提供大量预设函数支持。

向上取整

传入一个可计算变量%v，返回大于或等于x的最小整数。

_functionCEIL(%v)

向下取整

传入一个可计算变量%v，返回小于或等于x的最大整数。

_functionFLOOR(%v)

四舍五入

传入一个可计算变量%v，同时第二个参数输入保留的小数位。

_functionROUND(%v,2)

字符串长度

传入一个字符串变量%v，返回字符串长度。

_functionLENGTH('%v')

字符串转小写

将字符串转换为小写：

_functionLOWER('%v')

字符串转大写

将字符串转换为大写：

_functionUPPER('%v')

……待补充内容……

IF逻辑判断

MySQL IF 语句允许根据表达式条件执行不同操作。表达式可以结合文字、变量、运算符甚至其他函数来组合，并返回TRUE、FALSE或NULL之一。语法如下：

IF(expr,v1,v2)

其中，当表达式expr为真时返回v1，否则返回v2。
示例1：当单价大于100时，将单价设置为0。

_functionIF({price}>=100,0,{price})

CASE搜索

除了IF功能，还提供了CASE条件语句，使代码更加可读和高效。有两种形式：简单CASE和可搜索CASE。

简单CASE语句

检查表达式的值与一组唯一值匹配。语法如下：

CASE <表达式>
    WHEN <值1> THEN <操作>
    WHEN <值2> THEN <操作>
    ...
    ELSE <操作>
END CASE;

表达式可以是任意有效表达式，与每个WHEN子句中的值比较。如果匹配，则执行相应操作；若无匹配项且省略ELSE子句，会引发错误。

可搜索CASE语句

用于更复杂匹配，如范围匹配，更加可读。语法如下：

CASE 
    WHEN <条件1> THEN <命令>
    WHEN <条件2> THEN <命令>
    ...
    ELSE commands 
END CASE;

MySQL依次计算WHEN子句中的每个条件，直到找到TRUE的条件并执行THEN子句中的命令；若无TRUE条件且省略ELSE子句，会发出错误消息。如不想处理ELSE逻辑，可在ELSE放置空BEGIN END块避免错误。