在线费用表已经能填写、保存,提交后却发现类别不统一、金额不合规则、日期超出本期。要把查错提前,需要将字段规则绑定到输入区域,再连接提示和提交检查。
SpreadJS 是葡萄城的前端表格控件,可嵌入业务系统,用于在线填报开发。 通过配置数据验证、输入提示和无效值标记,开发团队可将填写要求落实到单元格中。以费用填报为例,录入校验可以从字段规则、错误提示、关联检查和提交复核四步入手。
1. 先确认口径,再绑定验证规则
先与业务人员确认:零金额是否有效,退费能否填负数,日期按发生时间还是报销时间填写。下面假设金额必须大于零、日期限定在本期:
| 字段 | 规则 | 验证方式 |
|---|---|---|
| 费用类别 | 使用统一类别 | 列表验证 |
| 申请金额 | 大于零 | 数值验证 |
| 发生日期 | 在本期起止日期内 | 日期验证 |
| 费用说明 | 不超过约定长度 | 文本长度验证 |
不要只限制显示格式。金额显示成两位小数,并不等于已经设置了取值规则;必填项和可留空项也要分别确认。
以下片段假设已加载 SpreadJS,并取得 spread、sheet 实例,为B2设置正数验证。它只说明配置方式,未做运行验证:
const dv = GC.Spread.Sheets.DataValidation.createNumberValidator(
GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.greaterThan,
0
);
dv.showInputMessage(true);
dv.inputMessage("金额单位为元,且须大于0");
dv.showErrorMessage(true);
dv.errorMessage("申请金额须大于0,请核对后重新填写");
spread.options.highlightInvalidData = true;
sheet.setDataValidator(1, 1, dv);
批量配置时,应按实际输入区域设置验证器,确认新增行也覆盖规则,不能只验证示例中的一个格子。
2. 验证失败后,接入具体提示
输入提示负责告诉用户怎么填,无效值标记负责指出位置,错误文案负责解释原因。比如输入-10后,提示“申请金额须大于0”,比笼统的“数据错误”更便于修正。
SpreadJS 的录入校验针对单元格输入确认,不表示每敲一个字符都弹窗。提示还取决于组件:Designer可配置内置验证弹窗;仅使用SpreadSheets表格组件时,需通过 ValidationError 接入提示界面和处理策略。上面的消息配置不能代替这一步。
业务侧还要区分阻止提交与仅作提醒的问题。不能把警告统一当作通过,也不宜把允许解释的特殊业务全部拒绝。
3. 关联数据改动后,复查受影响字段
假设申请金额800元、可用限额500元,两个字段都是正数,整行却不符合申请额不得超过限额的规则。SpreadJS 可用公式验证表达表内关系;批量应用时要核对相对与绝对引用。
用户改动限额后,应用应复查关联金额并更新提示。后台限额可能变化时,提交还要核对最新数据,不能只相信首次加载的值。
4. 用四类输入验收完整流程
上线前至少检查:手输无效金额、粘贴错误数据、修改关联限额、整行漏填。分别记录是否识别已定义的错误、提示是否清楚、需要拦截的提交是否被阻止。
粘贴、导入、程序回填需按项目版本逐项验证;从未编辑的必填项需整表扫描。错误清单、跳转定位和提交控制由应用实现,服务端继续复核权限与业务规则。
接入 SpreadJS 后,应沿着“规则覆盖→错误定位→修改后复查→服务端复核”检查整条路径,避免只完成了一个弹窗,却漏掉批量入口和未填写的数据。