DM-ROW 接口文档

Appearance

POST /dm-store/uom/importExcel ​

Content-Type: multipart/form-data

触发按钮：无

入参 ​

传递对象：MultipartFile

字段类型必填多选校验规则说明
fileMultipartFile否否-Excel 文件

出参 ​

传递对象：ResultData<ImportResultInfo><导入结果对象>

无

前端校验规则 ​

前端校验
├── 权限校验
│   └── 导入按钮权限
│       └── v-auth: 'information:uom:import:popup'
├── 文件上传校验
│   └── file
│       ├── accept: .xlsx,.xls
│       ├── 文件格式限制：仅允许 .xlsx、.xls
│       ├── 文件大小限制：小于 5MB
│       └── 上传数量限制：仅保留最后一次选择的 1 个文件
└── 提交拦截校验
    └── importFile
        ├── 未选择文件时拦截提交
        ├── 文件后缀非 .xlsx/.xls 时拦截提交
        └── 文件大小≥5MB 时拦截提交

后端逻辑 ​

业务流程：校验导入数据 -> 识别新增或更新记录 -> 生成计量单位编号 -> 批量保存计量单位
├── 解析Excel导入数据
│   └── ExcelImportHandler.execute :280-281
├── 校验并归集有效数据
│   ├── 查询未删除计量单位
│   │   └── UomServiceImpl.list :308
│   ├── 校验必填项与导入内重复:handleImportData :310-349
│   └── 存在错误数据则返回失败明细:handleImportData :352-358
├── 识别新增或更新记录
│   └── 按计量单位编码/名称匹配现有记录:handleImportData :361-375
├── 生成计量单位编号
│   ├── 新增记录生成编号:handleImportData :378-380
│   └── RedisService.getCommonSeqNo :379
└── 批量保存计量单位
    └── UomServiceImpl.saveOrUpdateBatch :386

后端校验规则 ​

后端校验
├── 业务约束校验
│   └── 校验导入数据量上限不能超过10000条:handleImportData :295-297
│       └── ExceptionCode.Ex600148
└── 业务唯一性校验
    ├── 校验导入文件内计量单位名称是否重复:handleImportData :327-329
    │   └── StoreExceptionCode.EX201044
    └── 校验导入文件内计量单位编码是否重复:handleImportData :331-333
        └── StoreExceptionCode.EX201045

涉及数据库表 ​

库名.表名mapper.statement描述
store.uomUomMapper.insertOrUpdateBatch批量新增或更新uom数据