2.8 KiB
2.8 KiB
BOM 清单约定
前端在零件描述底部提供模板下载、Excel 导入和清单预览。Excel 在浏览器中解析,不上传原文件到 OSS,随保存组件的 POST / PUT JSON 请求提交解析结果。
已按最新 admin-api(3).md 使用 bomList 字段,POST / PUT 提交完整值;保存响应和 GET 详情返回该字段。实际服务器写入及回填尚未联调。
{
"bomList": [
{
"partName": "H-DOF0-R-C",
"position": "头",
"dof": 0,
"material": "POM",
"function": "摄像头",
"shape": "圆形",
"size": "—",
"torque": "—"
}
]
}
| Excel 列 | JSON 字段 | 类型 |
|---|---|---|
| 部件名称 | partName | string,非空 |
| 部位 | position | string |
| DOF | dof | 非负安全整数或 null;0 保留,空白或横线为 null |
| 材质 | material | string |
| 功能 | function | string |
| 形状 | shape | string |
| 大小 | size | string,保留单位和占位符 |
| 扭矩 | torque | string,保留单位和占位符 |
bomList接口允许 JSON 对象或数组,不接受字符串化 JSON;前端 Excel 导入生成以上八列对象数组。每次完整保存均携带该字段,显式[]表示清空;接口省略或 null 也会恢复为[]。- 详情返回其他 JSON 结构时原样保留,支持查看原始 JSON;重新导入或清空才会替换,不静默转为空数组。
- GET 详情支持 BOM 后应返回数组,未设置的组件返回
[]。列表接口不需要返回大清单。 - 支持
.xlsx,单文件不超过 10 MiB、最多 5000 条,每个文本单元格最多 2000 字符。只读第一张工作表,前 30 行定位八列表头,按列名匹配,按原始顺序导入。序号、标题和空行不提交。 - 模板含截图提供的一条示例,应替换或删除后上传。空文本字段使用空字符串,DOF 空白用 null。公式、日期等非文本/数字单元格给出行号错误,不读取缓存公式结果。
- 任一行校验失败则整份文件不覆盖已有 BOM。解析在 Worker 中执行,解析期间禁用保存,超时或卸载时终止 Worker。
- 保存响应中的 BOM 必须与请求一致。后端忽略字段或返回不一致时,页面明确提示、保留当前 BOM 和已保存记录 ID,后续重试更新该记录,避免重新新增。
- 编辑详情恢复已有 BOM,并纳入版本冲突合并。