跳转至

字段赋值说明

自动化在新增或更新数据时,可对目标表单的字段值进行操作,支持三种操作:设为、清空、追加。

赋值方式-设为

自动化在新增或更新数据时,可将目标表字段值设为字段固定值公式计算参数最大/小值、求和值、最早/晚时间、合并项、拆分项

设为字段

当节点数据不为空时,可将目标表单字段设为节点数据的字段值,例如发货单客户名称来源于销售订单客户名称

设为固定值

将目标表字段设为指定值,例如发货单发货人指定为特定人员。固定值类型说明如下:

字段 固定值 固定值说明
单行文本 输入文本
多行文本 输入文本
日期 选择日期
数字 输入数字
单选框 选择选项(单选)
复选框 选择选项(多选)
下拉框 选择选项(单选) (若数据来源关联已有表单数据,则不支持固定值)
是/否 选择选项
附件 -
图片 -
地址 选择地区
位置 -
关联表单 -
关联表单多选 -
人员单选 选择人员
人员多选 选择人员
部门单选 选择部门
部门多选 选择部门
拥有者 选择人员
所属部门 选择部门

设为公式计算

目标表单字段值设为公式计算结果,例如:发货时间取 NOW(),即自动化运行时的系统时间。
若自动化配置中已存在对字段 A 赋值,且字段 B 的赋值计算公式引用字段 A(如:B = A + 100)时,仍取字段 A 更新前的值参与计算。

自动化目前支持 57 个函数:逻辑函数(4 个)、时间函数(19 个)、数据函数(15 个)、文本函数(16 个)、其他函数(3 个)。

函数类型 函数 函数说明 函数示例
逻辑函数(4 个) AND 连接多个表达式,仅当所有表达式均为 TRUE 时返回 TRUE,否则返回 FALSE 数学成绩 > 80 AND 语文成绩 > 80:若两科成绩均达标,返回 TRUE,否则返回 FALSE
OR 连接多个表达式,只要有一个表达式为 TRUE 即返回 TRUE,否则返回 FALSE 是否请假="是" OR 是否迟到="是":若请假或迟到任一发生,返回 TRUE,否则返回 FALSE
IF 判断条件是否满足,满足时返回指定值,不满足时返回另一指定值 IF(学生成绩 >= 60, "及格", "不及格"):成绩 ≥ 60 返回 "及格",否则返回 "不及格"
CASE 按顺序判断多个条件,返回首个满足条件(TRUE)对应的值,替代多层 IF 嵌套 CASE(绩效 >= 90, "优秀", 绩效 >= 80, "良好", 绩效 >= 60, "合格", 绩效 < 60, "不合格"):按绩效分段返回评级
时间函数(19 个) NOW 返回当前系统时间(含时分秒),格式为 yyyy-MM-dd hh🇲🇲ss NOW():返回当前时间,如 2025-01-01 09:00:00
TODAY 返回当前系统日期,格式为 yyyy-MM-dd TODAY():返回当天日期,如 2025-01-11
YEARS 计算两日期的年数差值(精确到两位小数) YEARS("2023-01-31", "2020-01-31"):返回 3.00
WORKDAYS 计算两日期之间的工作日天数(扣除周末) WORKDAYS("2023-08-31", "2023-08-01"):假设无节假日则返回 22
DAYS 计算两日期之间的天数差值 DAYS("2023-08-23", "2023-08-01"):返回 22
ADDDAY 对指定日期加减指定天数(负数为减) ADDDAY("2020-01-15", 5):返回 2020-01-20;ADDDAY("2020-01-15", -3):返回 2020-01-12
ADDMONTH 对指定日期加减指定月数(负数为减) ADDMONTH("2020-01-15", 5):返回 2020-06-15;ADDMONTH("2020-01-15", -2):返回 2019-11-15
ADDYEAR 对指定日期加减指定年数(负数为减) ADDYEAR("2020-01-15", 1):返回 2021-01-15;ADDYEAR("2020-01-15", -1):返回 2019-01-15
DATE 将年、月、日、时、分、秒转换为标准日期格式 DATE(2024, 4, 17, 14, 30, 0):返回 2024-04-17 14:30:00
YEAR 返回日期中的年份 YEAR("2024-04-17"):返回 2024
MONTH 返回日期中的月份(1-12) MONTH("2024-04-17"):返回 4
DAY 返回日期中的天数(1-31) DAY("2024-04-17"):返回 17
HOUR 返回时间中的小时部分(0-23) HOUR("2024-04-17 14:30:00"):返回 14
MINUTE 返回时间中的分钟部分(0-59) MINUTE("2024-04-17 14:30:00"):返回 30
QUARTER 返回日期所属季度(1-4) QUARTER("2024-04-17"):返回 2(4 月属于第 2 季度)
WEEKNUM 返回日期是一年中的第几周(1-53) WEEKNUM("2024-04-17"):返回 16(假设 2024 年 4 月 17 日为第 16 周)
WEEKDAY 返回日期为星期几 WEEKDAY("2025-04-01"):返回 2(2025-04-01 为周二)
HOURS 计算两时间的小时差值(精确到两位小数) HOURS("17:00:00", "09:00:00"):返回 8.00
MINUTES 计算两时间的分钟差值(精确到两位小数) MINUTES("10:30:00", "10:00:00"):返回 30.00
数学函数(15 个) SQRT 返回数字的正平方根(数字需 ≥ 0) SQRT(9):返回 3
POWER 返回数字的乘幂(数字 1 为底数,数字 2 为指数) POWER(3, 2):返回 9(3 的 2 次方)
LOG 返回指定底数的对数 LOG(9, 3):返回 2(以 3 为底,9 的对数)
MOD 返回两数相除的余数(数字 1 为被除数,数字 2 为除数) MOD(7, 3):返回 1(7 ÷ 3 余 1)
COS 返回角度的余弦值(参数为角度,返回值范围 [-1, 1]) COS(0):返回 1
SIN 返回角度的正弦值(参数为角度,返回值范围 [-1, 1]) SIN(30):返回 0.5(30 度的正弦值)
ABS 返回数字的绝对值 ABS(-5):返回 5
INT 将数字向下取整为最接近的整数 INT(3.9):返回 3;INT(-3.1):返回 -4
ROUND 将数字四舍五入到指定小数位数 ROUND(3.1415, 2):返回 3.14
FIXED 将数字格式化为文本,支持指定位小数位数 FIXED(123.456, 2):返回 123.46(文本格式)
CEILING 将数字向上舍入为最接近的某个值的倍数 CEILING(22.5, 3):返回 24(22.5 向上取 3 的倍数,最接近的值为 24)
FLOOR 将数字向下舍入为最接近的某个值的倍数 FLOOR(22.5, 3):返回 21(22.5 向下取 3 的倍数,最接近的值为 21)
RAND 返回 0 到 1 之间的随机实数(每一次触发计算都会变化) RAND():返回如 0.6523 的随机数
UPPERMONEY 将数值转为中文大写金额 UPPERMONEY(10000):返回 壹万元整
PI 返回圆周率 π(约 3.1415926535...) PI():返回 3.1415926535...
其他函数(3 个) NEWGUID 生成唯一不重复的随机数(通常用于唯一标识符) NEWGUID():返回如 123e4567-e89b-12d3-a456 的唯一值
GETADDRESS 将地址或位置字段的值转为文本 GETADDRESS(表单.地址控件):返回地址的文本描述,如北京市朝阳区 XX 路
ISNULL 判断字段值是否为空(空值时返回 TRUE,非空返回 FALSE) ISNULL(表单.备注):若备注字段无值,返回 TRUE
文本函数(16 个) CONTAINS 判断文本 1 是否包含文本 2(包含返回 TRUE,否则 FALSE) CONTAINS("ABCDE", "BCD"):返回 TRUE
STARTSWITH 判断文本是否以指定字符串开头(是返回 TRUE,否则 FALSE) STARTSWITH("氚云低代码", "氚云"):返回 TRUE
TRIM 删除文本首尾空格 TRIM(" 氚云 "):返回 氚云
UNION 合并多个文本数组并去重(参数可为多个主表控件或子表数组) UNION("A", "B", "A"):返回 "A", "B"(去重后)
REPLACE 按指定位置和长度替换文本中的部分内容 REPLACE("氚云应用搭建", 5, 2, "维护"):返回 氚云应用维护(从第 5 个字符开始替换 2 个字符为 "维护")
SUBSTITUTE 将文本中指定字符或字符串替换为新内容(可指定替换次数) SUBSTITUTE("氚云低代码搭建工具","低代码","应用",1):返回 氚云应用搭建工具
LEFT 从文本左侧提取指定长度的字符 LEFT("氚云应用搭建工具", 2):返回 氚云(提取左侧 2 个字符)
RIGHT 从文本右侧提取指定长度的字符 RIGHT("氚云应用搭建工具", 4):返回 搭建工具(提取右侧 4 个字符)
MID 从文本指定位置开始提取指定长度的字符 MID("氚云应用搭建工具", 5, 4):返回 搭建工具(从第 5 个字符开始提取 4 个字符)
LOWER 将文本中的大写字母转为小写 LOWER("H3YUN"):返回 h3yun
UPPER 将文本中的小写字母转为大写 UPPER("h3yun"):返回 H3YUN
TEXT 将数字转为文本格式 TEXT(123):返回 123(文本类型)
VALUE 将文本转为数字格式 VALUE("123"):返回 123(数字类型)
GETUNITNAME 返回人员或部门控件对应的名称(支持单选/多选) GETUNITNAME(表单.负责人):若负责人为 "张三",返回 张三
LEN 返回文本中的字符个数 LEN("氚云应用搭建工具"):返回 8(共 8 个字符)
SEARCH 返回文本 1 在文本 2 中的起始位置(从 1 开始计数,未找到返回 0) SEARCH("工具", "氚云应用搭建工具", 1):返回 7("工具" 在第 7 个位置开始)

设为参数

当触发事件为自定义触发,且添加了自动化参数时,字段赋值支持设为参数

参数内容可在自定义按钮中配置或在代码中预设,支持设为默认值手动填值,调用时将使用具体参数值执行自动化。

设为最大最小求和最早最晚时间

自动化新增数据时,支持对数字、日期字段设为汇总值:

  • 数字字段:求和、最大值、最小值
  • 日期字段:最早时间、最晚时间
    新增数据时,数据默认按非合并项字段分组,组内对合并项字段进行聚合运算。

设为合并项

自动化新增数据时,支持对以下字段设为合并项:

目标表单字段(多选值) 匹配类型 节点数据字段
复选框 合并值 复选框、单选框、下拉框
人员多选 合并值 人员多选、人员单选、拥有者、创建人
部门多选 合并值 部门多选、部门单选、所属部门
关联表单多选 合并值 关联表单多选、关联表单、objectID
附件 合并值 附件、图片
图片 合并值 图片

新增数据时,数据默认按非合并项字段分组,组内对合并项字段进行合并。

新增数据时,在数据分组后,对同组内数据进行合并赋值,示例如下:

触发表 目标表
关联订单:objectID 001 发货时间:2025.03.01 关联订单多选:objectID 001, objectID 002, objectID 003 发货时间:2025.03.01
关联订单:objectID 002 发货时间:2025.03.01
关联订单:objectID 003 发货时间:2025.03.01

设为拆分项

自动化新增数据时,支持对以下字段设为拆分项:

目标字段(单一值) 匹配类型 节点数据字段(多选值)
单选框、下拉框 拆分值 复选框
人员单选、拥有者、创建人 拆分值 人员多选
部门单选 拆分值 部门多选
关联表单 拆分值 关联表单多选

新增数据时,数据默认按非合并项字段分组,组内对拆分项字段进行选项值拆分。

新增数据时,将多选值字段拆分为多条数据依次执行新增操作,示例如下:

触发表 目标表
关联订单多选:objectID 001, objectID 002, objectID 003 发货时间:2025.03.01 关联订单:objectID 001 发货时间:2025.03.01
关联订单:objectID 002 发货时间:2025.03.01
关联订单:objectID 003 发货时间:2025.03.01

赋值方式-清空

  • 自动化在更新数据时,可将目标表字段值清空。例如:项目管理中,主任务负责人删除后,需清空关联子任务的对应负责人。

赋值方式-追加

  • 自动化在更新数据时,若目标表字段为多值类型,支持在原有内容上追加指定字段值。例如:客户管理中,新增跟进记录后,将 B 追加至客户意向中,客户意向由 A 变为 A 和 B。
  • 字段赋值为追加时,相同内容不再重复添加。例如:A 追加至 A,结果仍为 A。

🛑 重要
单张图片多次上传,系统识别为不同图片。

赋值方式说明