汇总字段用于从当前表单的关联记录中聚合值。当主记录需要展示子记录或关联记录的统计结果时,可以使用汇总字段。
子记录数量、订单总额、平均评分、最新活动时间、合并标签、关联项是否全部满足条件等场景,都适合使用汇总字段。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签,必填;名称应清楚表达汇总结果 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称,必填 |
| 必填 | 保存记录前要求计算结果存在 |
| 只读 | 展示计算结果,但不允许手动编辑 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存计算结果,但不在常规表单页面展示 |
汇总字段配置
| 配置项 | 说明 |
|---|
| 关联表 | 指向当前表单的关联表或字段;它决定哪些记录会参与汇总 |
| 汇总函数 | 用于计算结果的聚合规则 |
| 目标字段 | 汇总函数使用的关联记录字段;部分函数要求目标字段是特定类型 |
| 排序字段 | 当函数需要取第一条或最后一条记录时,用于给关联记录排序 |
| 精度 | 数字类汇总结果保留的小数位数 |
| 前缀 | 展示在汇总结果前面的文本,例如货币符号 |
| 后缀 | 展示在汇总结果后面的文本,例如单位或百分号 |
| 颜色 | 设置字段展示颜色 |
| 帮助文案 | 展示在字段附近的辅助说明;可用于说明汇总了什么 |
汇总函数
| 函数 | 说明 |
|---|
| 计数 | 统计关联记录数量;不需要目标字段 |
| 去重计数 | 统计目标字段的去重值数量 |
| 第一条 | 按排序字段排序后,返回第一条记录的目标字段值;需要排序字段 |
| 最后一条 | 按排序字段排序后,返回最后一条记录的目标字段值;需要排序字段 |
| 众数 | 返回出现次数最多的目标字段值 |
| 求和 | 对数字目标字段求和 |
| 最大值 | 返回数字目标字段的最大值 |
| 最小值 | 返回数字目标字段的最小值 |
| 平均值 | 返回数字目标字段的平均值 |
| 中位数 | 返回数字目标字段的中位数 |
| 极差 | 返回数字目标字段最大值和最小值的差 |
| 全部满足 | 只有所有布尔目标字段值都为真时返回真 |
| 任一满足 | 任一布尔目标字段值为真时返回真 |
| 文本合并 | 把目标字段值合并成文本 |
| 数组汇总 | 把目标字段值汇总成数组 |
函数要求
| 函数组 | 要求 |
|---|
| 计数 | 不需要目标字段 |
| 去重计数、众数、文本合并、数组汇总 | 需要目标字段 |
| 求和、最大值、最小值、平均值、中位数、极差 | 需要数字目标字段 |
| 全部满足、任一满足 | 需要布尔目标字段 |
| 第一条、最后一条 | 需要目标字段和排序字段 |
常见示例
| 场景 | 关联表 | 函数 |
|---|
| 客户展示订单数 | 指向客户的订单 | 计数 |
| 订单展示明细总额 | 指向订单的订单明细 | 求和 |
| 项目展示最新任务更新时间 | 指向项目的任务 | 最后一条 |
| 主任务展示子任务是否全部完成 | 指向任务的子任务 | 全部满足 |
配置建议
| 建议 | 说明 |
|---|
| 先确认关联表 | 关联表选错后,后续汇总设置都会基于错误数据计算 |
| 匹配函数和目标类型 | 数字函数需要数字字段,布尔函数需要布尔字段 |
| 用前缀和后缀说明展示 | 金额、百分比、数量、单位类结果更容易读 |
| 帮助文案写具体 | 例如“已审批订单明细金额合计”,说明来源记录和计算规则 |