动态计算字段用于根据公式表达式计算字段值。公式可以引用当前表单字段,以及支持的关联表单字段。
当字段值应该由其他字段推导出来时,可以使用动态计算字段。例如状态文本、风险等级、逾期状态、格式化编码、计算日期。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签,必填;名称应清楚表达计算结果 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称,必填 |
| 必填 | 保存记录前要求计算结果存在 |
| 只读 | 展示计算结果,但不允许手动编辑 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存计算结果,但不在常规表单页面展示 |
动态计算配置
| 配置项 | 说明 |
|---|
| 结果类型 | 公式返回值的类型;它会影响校验、展示和最终存储的数据类型 |
| 显示配置来源字段 | 复用同类型字段的展示配置;结果类型为单选或时间时会显示该配置 |
| 公式表达式 | 用于计算字段值的表达式 |
| 插入函数 | 向公式表达式中插入支持的公式函数 |
| 插入字段 | 向公式表达式中插入字段引用 |
| 公式试算 | 选择当前表单中的一条记录,测试公式返回结果 |
结果类型
| 结果类型 | 用途 |
|---|
| 字符串 | 标签、描述、编码、状态文本等文本结果 |
| 数字 | 分值、金额、比例、计数等数值结果 |
| 布尔 | 标记、规则判断等真/假结果 |
| 日期 | 日期结果 |
| 日期时间 | 日期时间结果 |
| 时间 | 一天内时间结果 |
| 周 | 周期为周的结果 |
| 月 | 周期为月的结果 |
| 季度 | 周期为季度的结果 |
| 年 | 周期为年的结果 |
| 单选 | 类似选项的字符串结果,需要复用单选下拉或单选字段的展示配置 |
显示配置来源字段
显示配置来源字段只在结果类型依赖其他字段展示配置时需要。
| 结果类型 | 作用 |
|---|
| 单选 | 复用单选下拉或单选字段的选项标签、选项值和展示方式 |
| 时间 | 复用时间字段的时间展示配置 |
公式建议
| 建议 | 说明 |
|---|
| 匹配结果类型和表达式 | 公式返回值必须和配置的结果类型一致 |
| 使用插入字段 | 通过编辑器插入字段,避免手写 API 名称出错 |
| 保存前先试算 | 用真实记录测试公式是否返回预期结果 |
| 保持公式可读 | 如果一个表达式过长,可以拆成多个字段承载中间结果 |
命令中的校验
通过系统命令创建或更新公式配置时,config.dynamicFormula.formulaExpression 必须是非空表达式;缺少表达式时返回 FORMS_FIELD_FORMULA_EXPRESSION_REQUIRED。