编辑 | blame | 历史 | 原始文档

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)),保存时传中文原文,不要传编码或数字。
  • 该字段必填,为空时接口返回参数校验错误「类型不能为空」。
  • 计量单位被物料引用后仍可修改类型,无级联限制。