计算
1. 简介
1.1 功能简介
计算字段,可以基于用户定义的公式自动计算结果。当公式中引用的字段值发生变化时,计算字段的值也会实时更新。支持引用的字段包括:
- 当前表单字段
- 关联表 字段
1.2 应用场景
应用场景 | 描述 | 优势 |
人事管理 | 导入员工档案时,根据记录中的职级等信息自动计算薪资。 | 自动触发计算(导入/智能助手等造成的数据变更,也会触发计算字段值的更新) |
库存管理 | 根据产品表的初始库存及出入库记录,动态计算实时库存。 | 实时跨表计算(需基于 关联关系) |
财务管理 | 在合同表中汇总已回款金额,并根据回款比例标记状态(未回款/部分回款/全部回款)。 | 直观标明状态,帮助识别信息 |
1.3 版本说明
本功能为付费高级功能,需简道云标准版及以上版本可用(试用版可进行试用),详情可参见:官网定价。
1.4 预期效果
以计算产品库存为例,可在产品表中通过「计算」字段,对初始库存以及相关联的入库、出库记录进行汇总计算,得到实时库存。效果如下:
1)此前,「产品表」中车载冰箱的「当前库存」为 5 台。
2)在「出库表」中出库 2 台车载冰箱后,「产品表」中车载冰箱的「当前库存」已自动更新为 3 台。
2. 设置步骤
2.1 设置入口
进入表单编辑页面,从字段选择面板中点击或拖拽添加计算字段后,即可在右侧「字段属性」处进行相关设置。
注:
1)计算字段的数量限制如下:
- 每张表单中,最多支持添加 100 个计算字段;
- 单个应用内,最多支持存在 100 个含有计算字段的表单。
2)计算字段不支持添加为子字段,不可拖入子表单。
2.2 选择计算结果类型
计算字段支持输出以下 2 类计算结果:
- 数字
- 文本
注:
1)切换计算结果类型时,将会清空已有的公式设置。
2)保存表单后,将不再支持切换计算结果类型。
2.3 编辑公式
点击「设置」进入公式编辑页面,根据业务需求进行公式设置即可。如下图所示:
2.3.1 可用变量
编辑公式时,支持引用以下两类字段变量进行公式运算,可自由组合:
变量类型 | 说明 |
普通变量 | 即当前表单字段,支持选择单行文本、多行文本、数字、单选按钮组、复选框组、下拉框、下拉复选框、成员单选/多选、部门单选/多选、地址、定位、流水号、手机、计算类型的主字段。 |
聚合变量 | 带有聚合设置的关联表中数字类型的主字段或数据条数变量。选中聚合变量时,可以修改其聚合设置,包括:
|
注:
1)计算字段可作为普通变量,参与当前表单中其他计算字段的公式设置。
2)计算字段之间不可互相引用。以 A 字段的公式中引用了 B 字段为例,设置 B 的公式时,不可再引用 A。
3)单张表单内,所有计算字段公式中引用的关联表总数不得超过 20 张。
4)单个计算字段的公式中,最多支持选用 20 张关联表中的字段来配置聚合变量。其中,对于每张关联表,最多可以参与 10 个聚合变量的配置。
5)聚合条件的具体说明可参考本文第 5.2 节,且对于每个聚合变量,最多可以设置 10 个聚合条件。
2.3.2 公式说明
1)编辑公式时,支持的运算符及函数如下:
- 运算符:+、-、*、/、==、<、>、<=、>=、!=
- 其他:()
- 函数:如下表所示:
函数类型 | 支持情况 | 说明 |
全部支持 | —— | |
不支持 | ||
部分支持 | 不支持 GETUSERNAME、MAPX、RECNO、TEXTDEPT、TEXTUSER、UUID 函数。 | |
部分支持 | 不支持 AVERAGE、COUNT、COUNTIF、LARGE、FIXED、PRODUCT、RAND、SMALL、SUM、SUMIF、SUMIFS、SUMPRODUCT 函数。 | |
部分支持 | 1)不支持 IP 函数。 2)使用 TEXT 函数时,第一个参数不可为日期时间字段,仅可为数字。 |
注:公式中均不支持引用日期时间和子表单字段。
2)系统会对公式中的运算符和函数参数进行严格校验,且参数不可多传、漏传:
- 运算符
- + 不可用于连接字符串(如"一年级"+"二班"),可改用 CONCATENATE 函数连接;
- 比较运算符仅支持数字类型,不支持比较字符串(如文本1==文本2),可改用 EXACT 函数比较。
- 函数参数
函数要求的参数为 | 校验说明 | 错误示例 | 正确用法 |
布尔值 | 不可使用数字 1/0 代替 true/false | IF(1, A, B) | IF(true, A, B) |
字符串 | 数字不可用作字符串 | CONCATENATE(1,2) | CONCATENATE("1","2") |
数字 | 字符串不可用作数字 | LEFT("321","2") | LEFT("321",2) |
整数类 | 参数必须为符合要求的整数,否则会直接返回空值。例如:
|
2.4 设置格式(选做)
计算结果类型为「数字」时,可以设置数字的格式,包括:
- 数值格式:支持保留小数位数和显示千分符。数字较长的数据可以设置千分符用于识别和区分。
- 百分比格式:支持保留小数位数。一般通过公式计算得出的数字需要保留小数位数。
3. 全量计算
新增计算字段,或是修改了已有计算字段的公式后,系统会在保存表单时进行一次全量计算,确保数据的准确性。
若遇到未全量计算的情况,则需要到「应用后台 >> 计算」处,找到表单并重新执行一次全量计算。如下图所示:
4. 字段能力
计算字段支持在以下场景中使用:
场景类型 | 具体场景 | 设置说明 |
表单设置 | 显示字段设置 | |
| ||
—— | ||
| ||
| ||
| ||
表单扩展功能 | 自定义标题 | |
简报字段 | ||
提醒文字 | ||
| ||
作为推送字段 | ||
支持在如下节点中引用计算字段:
| ||
表单发布 |
| |
外链权限配置(仅能设置可见权限) | ||
| ||
流程设定 | 仅能设置可见权限 | |
可选字段 | ||
—— | ||
数据查看与管理 | 视图 | 显示字段、筛选、搜索、排序、汇总 |
—— | ||
批量打印: | ||
数据分析 | 仪表盘 | |
数据工厂 | 可视做数字类型字段被数据工厂调用:
| |
API | —— |
5. 注意事项
5.1 通用说明
1)计算字段的值以提交后的自动计算结果为准,填报时的预览值仅供参考。
2)计算字段的值会存储到表单中,且字段值的每次变更也会记录在数据日志中。
3)计算字段不支持对关联表中的子表单字段进行计算。
4)计算字段不支持添加为子字段,无法拖入子表单。
5)计算字段值的变更不会触发智能助手、智能助手Pro 及 Webhook。
5.2 过滤条件说明
1)点击「添加过滤条件」后,需要设置的内容如下所示:
- 关联表字段:支持选取关联表中的如下字段:
- 表单主字段:单行文本、多行文本、数字、日期时间、单选按钮组、复选框组、下拉框、下拉复选框、成员单选/多选、部门单选/多选、图片、附件、定位、地址、手写签名、手机;
- 系统字段:提交时间、微信昵称、微信 OpenID、扩展字段;
- 过滤关系:根据关联表字段类型,设置不同的字段关系,如等于/不等于、包含/不包含、为空/不为空等。
- 过滤值:由关联表字段和过滤关系决定,可能是选项或文本,也可能不需要填写。
2)多个过滤条件间的关系为「且」,仅会对满足所有过滤条件的数据进行计算。