财务填报最令人焦虑的不是出现错误,而是提交前不知道错误在哪里。SpreadJS 可以在浏览器工作表中计算公式、读取错误结果,并把输入校验、公式校验和业务校验定位到具体单元格。可靠的填报表还要把错误原因、修复动作和提交状态说清楚;前端提示不能替代后端审批。

一张红色单元格,可能对应三种问题

第一种是输入错误:金额为空、日期格式不对、部门不在允许范围内。第二种是计算错误:公式除以零、引用被删除或函数参数类型不正确。第三种是业务错误:本期收入小于已确认成本、已审批单据缺少附件、填报人不属于该组织。

这三类错误的处理方式不同。输入错误应该在编辑时尽早提示;公式错误要保留原始错误类型,方便开发排查;业务错误要给出制度规定的修复动作,并在提交时由服务端再次确认。把所有问题只显示成“格式不正确”,用户无法判断下一步该做什么。

Image

实测说明:示例在浏览器中加载 SpreadJS 19.1,页面显示“3 条待处理(1 输入 · 1 公式 · 1 业务)”,并分别标出 E3、G4、D5。截图来自评估环境,带有 SpreadJS 评估水印,正式发布前请在合法授权环境重新截图。

先设计错误对象,再设计颜色

建议每条错误至少包含单元格地址、错误层级、错误代码、用户提示、修复建议和是否阻止提交。例如:B3 的金额为空属于 INPUT_REQUIRED,提示“请输入本期金额”;F4 的利润率公式出现除零属于 FORMULA_DIV0,提示“收入为 0,请确认是否适用”;D5 的状态与附件不一致属于 BUSINESS_ATTACHMENT,提示“补充附件后再提交”。

颜色只是视觉载体。红色表示阻止提交,橙色表示需要确认,蓝色表示信息提示。页面还应有错误汇总区,显示总数并支持点击定位;只在单元格角落画一个红点,用户很容易漏掉隐藏行或滚动区域中的问题。

使用 SpreadJS 读取公式结果

SpreadJS 的 Worksheet.setFormula() 可写入公式,getValue() 可读取计算结果。不要把 IFERROR 统一包在所有公式外面然后返回 0,这会把真正的异常变成看似正常的数据。对于填报场景,更适合保留错误或返回明确的“待核对”状态。

sheet.setFormula(1, 5, '=E2-F2');
sheet.setFormula(1, 6, '=IFERROR(G2/E2,"待核对")');

const profit = sheet.getValue(1, 6);
if (typeof profit === 'string' && profit.indexOf('#') === 0) {
  errors.push({ cell: 'G2', level: 'formula', code: 'FORMULA_ERROR',
    message: '利润率计算失败,请检查收入和成本' });
}

读取到错误后,应用层可以把错误对象放入汇总区,同时给目标单元格设置醒目样式。公式文本、错误值和显示提示是三个不同层次,不能只保存最后一段中文提示,否则开发者无法复现问题。

输入校验要在用户提交前发生

示例中把部门、金额和日期作为填报字段。金额应是数值且大于等于零,日期不能晚于当前填报期间,部门必须来自授权列表。规则扫描可以在失焦、单元格变更或点击“校验”按钮时触发;大量数据则应采用批量校验,避免每次输入都重算整张表。

function validateInput(sheet, row, errors) {
  const amount = sheet.getValue(row, 4);
  const department = sheet.getValue(row, 2);
  const date = sheet.getValue(row, 1);
  if (amount === null || amount === '') {
    errors.push({ cell: `E${row + 1}`, level: 'input', code: 'INPUT_REQUIRED', message: '请输入金额' });
  } else if (typeof amount !== 'number' || amount < 0) {
    errors.push({ cell: `E${row + 1}`, level: 'input', code: 'INPUT_AMOUNT', message: '金额必须是非负数' });
  }
  if (!department) errors.push({ cell: `C${row + 1}`, level: 'input', code: 'INPUT_DEPARTMENT', message: '请选择部门' });
  if (!(date instanceof Date)) errors.push({ cell: `B${row + 1}`, level: 'input', code: 'INPUT_DATE', message: '请输入有效日期' });
}

数据验证下拉框可以减少枚举错误,但不能代替服务端授权。用户仍可能通过导入文件、接口请求或浏览器调试绕过前端控件,因此后端必须重新检查数据类型、组织范围和填报期间。

业务校验要表达关系,而不只是格式

假设本期收入在 E 列、成本在 F 列,利润在 G 列。收入小于成本并不一定是录入错误,可能代表亏损;因此规则要区分“允许但提示”和“禁止提交”。例如收入为空应阻止提交,利润为负可以允许保存草稿但要求说明,已审批状态缺少附件则阻止正式提交。

可以把校验结果分成草稿可保存、提交需修复和发布需复核三档。这样用户不会因为一个非关键提醒而丢失所有输入,也不会把带有致命错误的表格误提交。状态变化时重新运行受影响的规则,并记录触发的规则版本。

实际示例:在工作表中定位错误

下面的 HTML 示例使用 SpreadJS 19.1,准备一行正常数据、一行空金额和一行除零场景。页面右侧显示错误汇总,工作表中对问题单元格着色:

const errors = [];
const styleError = new GC.Spread.Sheets.Style();
styleError.backColor = '#fee2e2';
styleError.foreColor = '#b42318';

for (let row = 1; row <= 3; row++) {
  validateInput(sheet, row, errors);
  const value = sheet.getValue(row, 6);
  if (typeof value === 'string' && value.indexOf('#') === 0) {
    errors.push({ cell: `G${row + 1}`, level: 'formula', code: 'FORMULA_ERROR', message: '公式计算失败' });
    sheet.getRange(row, 6, 1, 1).backColor('#fee2e2').foreColor('#b42318');
  }
}
document.getElementById('errorCount').textContent = `${errors.length} 条待处理`;

示例中的样式只改变浏览器显示,不会修改公式或绕过计算引擎。正式应用应把错误对象提交到后端校验服务,并在服务端返回可定位的字段标识;不要只传一段已经渲染好的错误文本。

Image

错误提示要能帮助用户修复

“数据错误”不是好提示。好的提示包含对象、原因和动作,例如“E3 金额为空,请填写本期含税金额”;“G4 利润率无法计算,收入为 0,请确认该期间是否适用”;“D5 已审批单据缺少附件,请上传后再提交”。错误汇总可以按输入、公式和业务分组,用户先处理阻止提交的问题,再处理提醒项。

移动端或窄屏布局中,错误列表比悬浮气泡更可靠;键盘用户需要能够从错误列表跳转到目标单元格。批量导入时,应提供下载错误明细的能力,保留行号、字段名和原始值,避免用户重新寻找问题记录。

Image

上线前要验证失败路径

Image

测试不仅覆盖“输入正确后显示结果”,还要覆盖空工作簿、空金额、文本金额、除数为零、删除引用列、重复提交、网络超时和权限变化。每个用例记录输入、预期错误代码、界面提示、是否允许保存草稿和是否允许正式提交。

SpreadJS 负责浏览器表格、公式计算和错误定位;后端负责身份、业务规则、复核、持久化和审计;数据库保存权威数据。MCP 用于开发阶段核验 19.1 文档,不进入填报页面运行链路;AI 插件和 AI Agent 也不是公式校验的替代品。读者可通过 SpreadJS 在线示例 体验表格能力。

结语

财务填报的错误提示不是给单元格涂红色,而是把错误分层、定位、解释并连接到可执行的修复动作。SpreadJS 提供工作表和公式运行基础,应用规则负责把技术错误翻译成业务语言,后端复核负责守住提交边界。三层校验形成闭环,填报人员才知道哪里错、为什么错以及怎样改。


葡萄城技术团队
2.8k 声望34k 粉丝

葡萄城是专业的软件开发技术和低代码平台提供商,聚焦软件开发技术,以“赋能开发者”为使命,致力于通过表格控件、低代码和BI等各类软件开发工具和服务,一站式满足开发者需求,帮助企业提升开发效率并创新开发模式。