MDM 计量单位新增「类型」字段 - 前端联调方案
涉及页面
- 基础数据 > MDM > 计量单位(列表、新增/编辑弹窗)
API
接口路径不变,仅请求/响应体新增 type 字段。
| 方法 |
路径 |
说明 |
| POST |
/mdm/unit/create |
创建计量单位(请求体新增 type) |
| PUT |
/mdm/unit/update |
更新计量单位(请求体新增 type) |
| GET |
/mdm/unit/get |
获得计量单位(响应新增 type) |
| GET |
/mdm/unit/page |
获得计量单位分页(响应新增 type) |
| GET |
/mdm/unit/list |
获得计量单位列表(响应新增 type) |
请求参数(新增):
| 参数 |
类型 |
必填 |
说明 |
| type |
String |
是 |
类型,单选,可选值固定为:48千克、100千克、吨(三选一,直接存文本;后端 @NotBlank 校验) |
响应字段(新增):
| 字段 |
类型 |
说明 |
| type |
String |
类型,历史数据为 null |
响应示例:
{
"code": 0,
"data": {
"id": 1,
"code": "BAG",
"name": "袋",
"type": "48千克",
"status": 0
}
}
前端修改点说明(已随本次后端改动一并完成,供核对)
| 位置 |
要求 |
| 新增/编辑弹窗表单 |
增加「类型」下拉选择,选项固定三项:48千克 / 100千克 / 吨,单选、必填 |
| 列表表格 |
增加「类型」列展示,空值显示为 - |
| 查询表单 |
暂不提供类型筛选(后端分页接口未加该过滤条件) |
业务规则说明
| 场景 |
规则 |
| 存量数据 |
老记录 type 为空,列表展示 -;编辑老记录时必须补选类型后才能保存(后端强校验) |
| 选项来源 |
选项为前端写死三项文本,不建数据字典;提交的 value 即中文文本本身 |
| 后端校验 |
@NotBlank 必填校验;取值范围不限制,前端下拉需保证只会提交三个固定值 |
注意事项
type 为文本字段(VARCHAR(20)),保存时传中文原文,不要传编码或数字。
- 该字段必填,为空时接口返回参数校验错误「类型不能为空」。
- 计量单位被物料引用后仍可修改类型,无级联限制。