SpreadJS在线填报:金额填错时怎么提示,提交前还要查什么?

0 阅读3分钟

在线费用表已经能填写、保存,提交后却发现类别不统一、金额不合规则、日期超出本期。要把查错提前,需要将字段规则绑定到输入区域,再连接提示和提交检查。

SpreadJS 是葡萄城的前端表格控件,可嵌入业务系统,用于在线填报开发。 通过配置数据验证、输入提示和无效值标记,开发团队可将填写要求落实到单元格中。以费用填报为例,录入校验可以从字段规则、错误提示、关联检查和提交复核四步入手。

1. 先确认口径,再绑定验证规则

先与业务人员确认:零金额是否有效,退费能否填负数,日期按发生时间还是报销时间填写。下面假设金额必须大于零、日期限定在本期:

字段规则验证方式
费用类别使用统一类别列表验证
申请金额大于零数值验证
发生日期在本期起止日期内日期验证
费用说明不超过约定长度文本长度验证

不要只限制显示格式。金额显示成两位小数,并不等于已经设置了取值规则;必填项和可留空项也要分别确认。

01-field-rules.png

以下片段假设已加载 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 接入提示界面和处理策略。上面的消息配置不能代替这一步。

02-entry-error.png

业务侧还要区分阻止提交与仅作提醒的问题。不能把警告统一当作通过,也不宜把允许解释的特殊业务全部拒绝。

3. 关联数据改动后,复查受影响字段

假设申请金额800元、可用限额500元,两个字段都是正数,整行却不符合申请额不得超过限额的规则。SpreadJS 可用公式验证表达表内关系;批量应用时要核对相对与绝对引用。

用户改动限额后,应用应复查关联金额并更新提示。后台限额可能变化时,提交还要核对最新数据,不能只相信首次加载的值。

03-related-check.png

4. 用四类输入验收完整流程

上线前至少检查:手输无效金额、粘贴错误数据、修改关联限额、整行漏填。分别记录是否识别已定义的错误、提示是否清楚、需要拦截的提交是否被阻止。

粘贴、导入、程序回填需按项目版本逐项验证;从未编辑的必填项需整表扫描。错误清单、跳转定位和提交控制由应用实现,服务端继续复核权限与业务规则。

接入 SpreadJS 后,应沿着“规则覆盖→错误定位→修改后复查→服务端复核”检查整条路径,避免只完成了一个弹窗,却漏掉批量入口和未填写的数据。