一、先看数据:终检记录长什么样
整车总装车间里,每一辆车下线前都要过一道终检。检测员按工艺卡逐项核对——制动距离、淋雨密封、车内噪声、轮胎气压、电气静态电流——全部达标才放行,这份记录是质量追溯的硬证据。
一份终检记录对应的业务数据,可以先定成 JSON:
{
"vehicle": {
"vin": "LSVAM4C53NA000001",
"model": "EV-A 高配版",
"line": "总装一线",
"shift": "夜班"
},
"checks": [
{
"seq": 1, "item": "制动距离", "standard": "≤ 19 m", "measured": "18.2 m", "judgment": "合格" },
{
"seq": 2, "item": "淋雨密封", "standard": "无渗漏", "measured": "无渗漏", "judgment": "合格" },
{
"seq": 3, "item": "车内噪声", "standard": "≤ 65 dB(A)", "measured": "62 dB(A)", "judgment": "合格" }
],
"summary": {
"qualifiedCount": 3, "unqualifiedCount": 0, "conclusion": "合格" }
}
字段路径用 . 表示对象属性、# 表示数组元素:vehicle.vin 是车辆识别代号,checks#item 是每一个检测项,checks#measured 是实测值,summary.conclusion 是终检结论。一张终检单,本质上是一组"单元格路径 → 数据字段"的绑定关系。
二、自研推演:如果从零写,会踩哪些坑
拿到这张终检单,先别急着上工具,推演一下从零自研的路径,看看坑埋在哪。
第一个坑是行数不可控。检测项数量随车型和配置变化——标准配置三十多项,高配加装辅助驾驶后又多出几项。按传统思路写死一个表格模板,用前端循环去渲染,行数就得动态算——数据来了才知道有几行,DOM 得跟着数据增减。
// 自研第一版:手写循环渲染检测项,行数跟着数组走
// 问题:结构一变就要改模板,校验规则和公式得手动跟每一行绑定
function renderRows(checks) {
const tbody = document.querySelector('#checks-body');
tbody.innerHTML = '';
checks.forEach(function (c) {
const tr = document.createElement('tr');
tr.innerHTML = '<td>' + c.item + '</td><td>' + c.standard + '</td><td><input></td>';
tbody.appendChild(tr);
});
}
行数是跟上了,但校验规则、公式判定、版式还原全都得自己再搭一遍,还得处理"新增一行要继承规则"这类细节。
第二个坑是跨域通信。终检表单要嵌在 MES 或质量系统里,iframe 分属两个源,数据读写只能走 postMessage。手写收发逻辑很快会乱——谁发什么命令、什么时候能写数据、提交了怎么回调,这套协议要自己定义、自己维护。
第三个坑是设备数据回填。实测值由制动台、淋雨试验房、声级计、电检台这些设备测出来,设备把结果吐到质量系统接口,但接口返回体千差万别。有的返回 { code: 0, data: { list: [...] } },有的返回 { result: { records: [...] } },想稳定地把实测值取回来填进单元格,就得对每个接口各写一套解析。
这三个坑,本质是同一件事:动态行渲染、跨域协议、异构接口回填,都是"通用但繁琐"的底层活儿,和终检这个业务本身没有关系。
三、选型:把底层活儿交给表单开发工具
推到这一步,方向就清楚了:这三件底层活儿,交给一个成熟的可嵌入式表单开发工具去做,研发精力集中到终检的业务规则上。团队在表单渲染层引入了 FlashTable 作为表单开发工具,它在这类场景下的特征可以概括为几点:
(1)用 JSON Schema 描述表单结构,终检记录模板按原版式还原,不用重新画界面;
(2)数组字段直接驱动动态行,数组长度即明细行数,手动加行自动继承校验与公式;
(3)postMessage 命令协议与生命周期内建,主系统通过 RPC 代理读写数据;
(4)单元格可绑定外部数据接口,用 Result Path 从异构返回体里截取字段回填;
(5)Docker 离线镜像交付,可私有化部署。
四、实践:动态行怎么落地
动态行的关键是先定义数据源。检测项这一类字段,可以通过数据源推送接口一次性注册,把字段路径、类型、是否数组告诉表单:
// POST /api/datasourcefield/saveAll,注册终检检测项数据源
{
"dataSourceName": "vehicleChecks",
"description": "整车下线终检检测项",
"items": [
{
"uniqueId": "u1", "fieldName": "checks", "fieldComment": "检测项", "fieldType": "array", "type": "textarea", "isArray": 1, "isSelect": 1, "parentId": "0", "order": 1 },
{
"uniqueId": "u2", "fieldName": "checks#item", "fieldComment": "检测项目", "fieldType": "string", "type": "text", "isArray": 0, "isSelect": 1, "parentId": "u1", "order": 2 },
{
"uniqueId": "u3", "fieldName": "checks#standard", "fieldComment": "标准值", "fieldType": "string", "type": "text", "isArray": 0, "isSelect": 1, "parentId": "u1", "order": 3 },
{
"uniqueId": "u4", "fieldName": "checks#measured", "fieldComment": "实测值", "fieldType": "string", "type": "text", "isArray": 0, "isSelect": 1, "parentId": "u1", "order": 4 }
]
}
checks 标记为数组,下面挂三个 # 子字段。设计模板时把明细区绑定到 checks,运行时主系统推送几项数据,就渲染几行;手动加一行,新行沿用同一套字段结构和校验规则。
五、回填:实测值从检测设备接口拿
基础信息(VIN、车型、线体、班次)由主系统在加载时用数据写入命令带进去;实测值则来自检测设备。制动台、声级计、电检台把各自的读数吐到质量系统接口,表单设计阶段给"实测值"这一列绑定该接口,并指定一条结果提取路径:
// 外部数据源绑定(示意):给"实测值"列绑定检测设备接口并指定 Result Path
{
"url": "http://quality-system:8080/api/check-results?vin=LSVAM4C53NA000001",
"resultPath": "$.data.records"
}
渲染层拿到响应后,沿 $.data.records 剥离外层协议体,把截取到的实测值回填进对应单元格。绑定不改变字段路径,只是把"值的来源"从手工录入换成接口取值。测完即填,检测员手填的只剩设备没覆盖到的少数项。
六、数据旅程:从检测设备到主系统
把整个过程串起来看,一份终检记录的"数据旅程"是这样的:
- 主系统在 iframe 里加载终检表单,用数据写入命令带出 VIN、车型等基础信息;
- 表单侧触发外部数据源请求,从检测设备接口回填实测值,明细区按检测项数组展开;
- 判定公式逐行计算合格/不合格,汇总区给出终检结论;
- 检测员核对后提交,主系统通过提交回调拿到数据 ID,与车辆 VIN 绑定;
- 需要纸质记录时,主系统向打印页发送打印任务,指定纸张与方向,静默输出终检报告。
// 打印终检报告:向打印页发送打印任务
rpc.PRINT({
id: 'vehicleFinalCheck',
dataId: dataId,
page: 'A4',
orientation: 'l' // 终检记录横向排版
});
七、部署:数据不出车间
终检记录连着整车质量追溯,部署要落在工厂内网。表单渲染层以 Docker 离线镜像包交付,上传解压后跑一键部署脚本,先后拉起基础服务和核心服务,默认端口 11000,运行数据落在本机指定目录,部署完用服务列表命令核对各服务状态。渲染、通信、存储整条链路都在内网,不碰公网。
八、复盘
回头看,这份终检记录真正难的不是检测业务本身,而是动态行渲染、跨域协议、异构接口回填这三件"通用但繁琐"的底层活儿。把它们交给一个可嵌入式、可私有化部署的表单开发工具之后,剩下要做的就只是定义数据源、绑路径、配回填规则——都是配置,不是编码。
这类"检测项按数据展开、实测值从设备接口带出"的表单,真正的成本不在业务而在渲染、协议、回填这些底层环节;把它们交给一个能原样还原版式、按数组展开明细、从设备接口带出实测值、且数据落在本地的表单开发工具,FlashTable 是其中一个选择。