feat(mdm/mes): 基础数据物料管理/物料分类/计量单位支持Excel导出

liu

2026-09-02 1fb5fc73e8df33b25337ab34f669ab03e0d9ce06

feat(mdm/mes): 基础数据物料管理/物料分类/计量单位支持Excel导出

- MdmItemController / MdmUnitMeasureController / MesMdItemTypeController 新增 /export-excel 导出接口，支持按列表筛选条件导出全部数据
- 新增 MdmItemExcelVO / MdmUnitMeasureExcelVO / MesMdItemTypeExcelVO 导出模板
- 物料导出复用列表查询填充逻辑，保证导出内容与列表展示一致
- MesMdItemTypeController 导入模板接口补充 mes:md-item-type:import 权限校验
- MdmItemServiceImpl 物料导入的分类编码改为按 MES 物料分类解析（与物料表单分类下拉数据源一致）

Co-Authored-By: Claude <noreply@anthropic.com>

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/controller/admin/item/MdmItemController.java

@@ -1,9 +1,12 @@
package cn.iocoder.yudao.module.mdm.controller.admin.item;

import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
import cn.iocoder.yudao.module.mdm.controller.admin.item.vo.MdmItemExcelVO;
import cn.iocoder.yudao.module.mdm.controller.admin.item.vo.MdmItemImportExcelVO;
import cn.iocoder.yudao.module.mdm.controller.admin.item.vo.MdmItemImportRespVO;
import cn.iocoder.yudao.module.mdm.controller.admin.item.vo.MdmItemPageReqVO;
@@ -15,6 +18,7 @@
import cn.iocoder.yudao.module.mdm.dal.dataobject.item.MdmItemBatchConfigDO;
import cn.iocoder.yudao.module.mdm.dal.dataobject.item.MdmItemDO;
import cn.iocoder.yudao.module.mdm.dal.dataobject.unit.MdmUnitMeasureDO;
import cn.iocoder.yudao.module.mdm.enums.MdmItemTypeEnum;
import cn.iocoder.yudao.module.mdm.service.brand.MdmBrandService;
import cn.iocoder.yudao.module.mdm.service.category.MdmItemCategoryService;
import cn.iocoder.yudao.module.mdm.service.item.MdmItemBatchConfigService;
@@ -39,6 +43,7 @@
import java.util.*;
import java.util.stream.Collectors;

import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;

@@ -136,14 +141,48 @@
    @PreAuthorize("@ss.hasPermission('mdm:item:query')")
    public CommonResult<PageResult<MdmItemRespVO>> getItemPage(@Valid MdmItemPageReqVO pageReqVO) {
        PageResult<MdmItemDO> pageResult = itemService.getItemPage(pageReqVO);
        // è½¬æ¢å¹¶è¡¥é½å…³è”名称
        List<MdmItemRespVO> respList = convertAndEnrichItemList(pageResult.getList());
        return success(new PageResult<>(respList, pageResult.getTotal()));
    }

    @GetMapping("/export-excel")
    @Operation(summary = "导出物料 Excel")
    @PreAuthorize("@ss.hasPermission('mdm:item:export')")
    @ApiAccessLog(operateType = EXPORT)
    public void exportItemExcel(@Valid MdmItemPageReqVO pageReqVO,
                                HttpServletResponse response) throws IOException {
        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
        // å¤ç”¨åˆ†é¡µæŸ¥è¯¢çš„过滤与关联填充逻辑，保证导出数据与列表一致
        List<MdmItemRespVO> respList = convertAndEnrichItemList(itemService.getItemPage(pageReqVO).getList());
        List<MdmItemExcelVO> excelList = new ArrayList<>();
        for (MdmItemRespVO resp : respList) {
            MdmItemExcelVO excelVO = BeanUtils.toBean(resp, MdmItemExcelVO.class);
            MdmItemTypeEnum itemType = MdmItemTypeEnum.fromType(resp.getItemType());
            excelVO.setItemTypeName(itemType != null ? itemType.getName() : null);
            excelList.add(excelVO);
        }
        // å¯¼å‡º Excel
        ExcelUtils.write(response, "物料数据.xls", "物料", MdmItemExcelVO.class, excelList);
    }

    /**
     * å°†ç‰©æ–™ DO åˆ—表转换为已补齐关联名称（分类、主/辅计量单位、默认仓库）及同步状态的 RespVO åˆ—表
     *
     * åˆ†é¡µæŸ¥è¯¢ä¸Ž Excel å¯¼å‡ºå…±ç”¨ï¼Œä¿è¯å¯¼å‡ºå†…容与列表展示一致
     */
    private List<MdmItemRespVO> convertAndEnrichItemList(List<MdmItemDO> itemList) {
        if (itemList == null || itemList.isEmpty()) {
            return Collections.emptyList();
        }
        // å…³è”查询分类名称
        Map<Long, MdmItemCategoryDO> categoryMap = itemCategoryService.getItemCategoryMap(
                convertSet(pageResult.getList(), MdmItemDO::getCategoryId));
                convertSet(itemList, MdmItemDO::getCategoryId));
        // å…³è”查询计量单位名称
        Map<Long, MdmUnitMeasureDO> unitMap = unitMeasureService.getUnitMeasureMap(
                convertSet(pageResult.getList(), MdmItemDO::getUnitMeasureId));
                convertSet(itemList, MdmItemDO::getUnitMeasureId));
        // è½¬æ¢
        List<MdmItemRespVO> respList = BeanUtils.toBean(pageResult.getList(), MdmItemRespVO.class);
        List<MdmItemRespVO> respList = BeanUtils.toBean(itemList, MdmItemRespVO.class);
        // æ‰¹é‡æŸ¥è¯¢åŒæ­¥çŠ¶æ€
        Set<Long> allIds = convertSet(respList, MdmItemRespVO::getId);
        Set<Long> syncedIds = mesMdItemApi.getSyncedMdmItemIds(allIds);
@@ -189,7 +228,7 @@
            // åŒæ­¥çŠ¶æ€
            resp.setSyncedMes(syncedIds.contains(resp.getId()));
        });
        return success(new PageResult<>(respList, pageResult.getTotal()));
        return respList;
    }

    @GetMapping("/list-by-ids")
@@ -277,6 +316,7 @@

    @GetMapping("/get-import-template")
    @Operation(summary = "获得导入物料模板")
    @PreAuthorize("@ss.hasPermission('mdm:item:import')")
    public void importTemplate(HttpServletResponse response) throws IOException {
        List<MdmItemImportExcelVO> list = Arrays.asList(
                MdmItemImportExcelVO.builder().code("ITEM001").name("示例物料").specification("规格").status(0).isBatchManaged(false).build()

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/controller/admin/item/vo/MdmItemExcelVO.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,89 @@
package cn.iocoder.yudao.module.mdm.controller.admin.item.vo;

import cn.idev.excel.annotation.ExcelProperty;
import lombok.Data;

import java.math.BigDecimal;
import java.time.LocalDateTime;

/**
 * MDM ç‰©æ–™å¯¼å‡º Excel VO
 *
 * @author è¶…级管理员
 */
@Data
public class MdmItemExcelVO {

    @ExcelProperty("物料编码")
    private String code;

    @ExcelProperty("物料名称")
    private String name;

    @ExcelProperty("物料条码")
    private String barCode;

    @ExcelProperty("规格型号")
    private String specification;

    @ExcelProperty("物料类型")
    private String itemTypeName;

    @ExcelProperty("物料分类")
    private String categoryName;

    @ExcelProperty("主计量单位")
    private String unitMeasureName;

    @ExcelProperty("辅单位1")
    private String unitMeasureName2;

    @ExcelProperty("辅单位1换算比率")
    private BigDecimal unitMeasureRate1;

    @ExcelProperty("辅单位2")
    private String unitMeasureName3;

    @ExcelProperty("辅单位2换算比率")
    private BigDecimal unitMeasureRate2;

    @ExcelProperty("默认仓库")
    private String warehouseName;

    @ExcelProperty("状态")
    private Integer status;

    @ExcelProperty("是否批次管理")
    private Boolean isBatchManaged;

    @ExcelProperty("重量(kg)")
    private BigDecimal weight;

    @ExcelProperty("采购价")
    private BigDecimal purchasePrice;

    @ExcelProperty("销售价")
    private BigDecimal salesPrice;

    @ExcelProperty("成本价")
    private BigDecimal costPrice;

    @ExcelProperty("安全库存")
    private BigDecimal safetyStock;

    @ExcelProperty("最低库存")
    private BigDecimal minStock;

    @ExcelProperty("最高库存")
    private BigDecimal maxStock;

    @ExcelProperty("保质期(天)")
    private Integer expiryDay;

    @ExcelProperty("备注")
    private String remark;

    @ExcelProperty("创建时间")
    private LocalDateTime createTime;

}

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/controller/admin/unit/MdmUnitMeasureController.java

@@ -1,9 +1,12 @@
package cn.iocoder.yudao.module.mdm.controller.admin.unit;

import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
import cn.iocoder.yudao.module.mdm.controller.admin.unit.vo.MdmUnitMeasureExcelVO;
import cn.iocoder.yudao.module.mdm.controller.admin.unit.vo.MdmUnitMeasureImportExcelVO;
import cn.iocoder.yudao.module.mdm.controller.admin.unit.vo.MdmUnitMeasureImportRespVO;
import cn.iocoder.yudao.module.mdm.controller.admin.unit.vo.MdmUnitMeasurePageReqVO;
@@ -23,9 +26,13 @@
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;

@Tag(name = "管理后台 - MDM è®¡é‡å•ä½")
@@ -101,8 +108,37 @@
        return success(unitMeasureService.getUnitMeasureList(ids));
    }

    @GetMapping("/export-excel")
    @Operation(summary = "导出计量单位 Excel")
    @PreAuthorize("@ss.hasPermission('mdm:unit-measure:export')")
    @ApiAccessLog(operateType = EXPORT)
    public void exportUnitMeasureExcel(@Valid MdmUnitMeasurePageReqVO pageReqVO,
                                       HttpServletResponse response) throws IOException {
        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
        List<MdmUnitMeasureDO> list = unitMeasureService.getUnitMeasurePage(pageReqVO).getList();
        // ä¸»å•ä½ç¼–码映射：一次查询全部计量单位，用于解析 primaryId -> ç¼–码
        MdmUnitMeasurePageReqVO allReqVO = new MdmUnitMeasurePageReqVO();
        allReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
        Map<Long, String> unitCodeMap = new HashMap<>();
        for (MdmUnitMeasureDO unit : unitMeasureService.getUnitMeasurePage(allReqVO).getList()) {
            unitCodeMap.put(unit.getId(), unit.getCode());
        }
        // ç»„装导出 VO（主单位编码从 DO.primaryId è§£æžï¼‰
        List<MdmUnitMeasureExcelVO> excelList = new ArrayList<>();
        for (MdmUnitMeasureDO unit : list) {
            MdmUnitMeasureExcelVO excelVO = BeanUtils.toBean(unit, MdmUnitMeasureExcelVO.class);
            if (unit.getPrimaryId() != null) {
                excelVO.setPrimaryCode(unitCodeMap.get(unit.getPrimaryId()));
            }
            excelList.add(excelVO);
        }
        // å¯¼å‡º Excel
        ExcelUtils.write(response, "计量单位数据.xls", "计量单位", MdmUnitMeasureExcelVO.class, excelList);
    }

    @GetMapping("/get-import-template")
    @Operation(summary = "获得导入计量单位模板")
    @PreAuthorize("@ss.hasPermission('mdm:unit-measure:import')")
    public void importTemplate(HttpServletResponse response) throws IOException {
        List<MdmUnitMeasureImportExcelVO> list = Arrays.asList(
                MdmUnitMeasureImportExcelVO.builder().code("PC").name("片").primaryFlag(true).changeRate(new java.math.BigDecimal("1")).status(0).remark("示例：主单位").build(),

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/controller/admin/unit/vo/MdmUnitMeasureExcelVO.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,41 @@
package cn.iocoder.yudao.module.mdm.controller.admin.unit.vo;

import cn.idev.excel.annotation.ExcelProperty;
import lombok.Data;

import java.math.BigDecimal;
import java.time.LocalDateTime;

/**
 * MDM è®¡é‡å•ä½å¯¼å‡º Excel VO
 *
 * @author è¶…级管理员
 */
@Data
public class MdmUnitMeasureExcelVO {

    @ExcelProperty("单位编码")
    private String code;

    @ExcelProperty("单位名称")
    private String name;

    @ExcelProperty("是否主单位")
    private Boolean primaryFlag;

    @ExcelProperty("主单位编码")
    private String primaryCode;

    @ExcelProperty("与主单位换算比例")
    private BigDecimal changeRate;

    @ExcelProperty("状态")
    private Integer status;

    @ExcelProperty("备注")
    private String remark;

    @ExcelProperty("创建时间")
    private LocalDateTime createTime;

}

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/service/item/MdmItemServiceImpl.java

@@ -15,7 +15,6 @@
import cn.iocoder.yudao.module.mdm.dal.dataobject.item.MdmItemBatchConfigDO;
import cn.iocoder.yudao.module.mdm.dal.dataobject.item.MdmItemDO;
import cn.iocoder.yudao.module.mdm.dal.dataobject.unit.MdmUnitMeasureDO;
import cn.iocoder.yudao.module.mdm.dal.mysql.category.MdmItemCategoryMapper;
import cn.iocoder.yudao.module.mdm.dal.mysql.item.MdmItemBatchConfigMapper;
import cn.iocoder.yudao.module.mdm.dal.mysql.item.MdmItemMapper;
import cn.iocoder.yudao.module.mdm.dal.mysql.unit.MdmUnitMeasureMapper;
@@ -65,9 +64,6 @@
    private MesMdItemApi mesMdItemApi;
    @Resource
    private MdmItemBatchConfigMapper itemBatchConfigMapper;

    @Resource
    private MdmItemCategoryMapper itemCategoryMapper;

    @Resource
    private MdmUnitMeasureMapper unitMeasureMapper;
@@ -443,11 +439,13 @@
                .createList(new ArrayList<>()).updateList(new ArrayList<>())
                .failureList(new LinkedHashMap<>()).build();

        // 1. é¢„热：分类编码 -> ID、单位编码 -> ID
        // 1. é¢„热：分类编码 -> ID（MES ç‰©æ–™åˆ†ç±»ï¼Œä¸Žç‰©æ–™è¡¨å•ä¸‹æ‹‰æ•°æ®æºä¸€è‡´ï¼‰ã€å•ä½ç¼–码 -> ID
        Map<String, Long> categoryCodeIdMap = new HashMap<>();
        for (MdmItemCategoryDO category : itemCategoryMapper.selectList()) {
            if (category.getCode() != null) {
                categoryCodeIdMap.put(category.getCode(), category.getId());
        for (String categoryCode : importList.stream()
                .map(MdmItemImportExcelVO::getCategoryCode).filter(StrUtil::isNotBlank).distinct().toList()) {
            CommonResult<MesMdItemTypeRespDTO> categoryResult = mesMdItemTypeApi.getItemTypeByCode(categoryCode);
            if (categoryResult != null && categoryResult.getData() != null) {
                categoryCodeIdMap.put(categoryCode, categoryResult.getData().getId());
            }
        }
        Map<String, Long> unitCodeIdMap = new HashMap<>();

 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/md/item/MesMdItemTypeController.java

@@ -1,9 +1,11 @@
package cn.iocoder.yudao.module.mes.controller.admin.md.item;

import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.type.MesMdItemTypeExcelVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.type.MesMdItemTypeImportExcelVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.type.MesMdItemTypeImportRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.type.MesMdItemTypeListReqVO;
@@ -24,9 +26,13 @@
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;

@@ -91,8 +97,57 @@
                .setItemOrProduct(itemType.getItemOrProduct())));
    }

    @GetMapping("/export-excel")
    @Operation(summary = "导出物料产品分类 Excel")
    @PreAuthorize("@ss.hasPermission('mes:md-item-type:export')")
    @ApiAccessLog(operateType = EXPORT)
    public void exportItemTypeExcel(@Valid MesMdItemTypeListReqVO listReqVO,
                                    HttpServletResponse response) throws IOException {
        List<MesMdItemTypeDO> list = itemTypeService.getItemTypeList(listReqVO);
        // å…¨é‡åˆ†ç±»ï¼Œç”¨äºŽè§£æžä¸Šçº§åˆ†ç±»ï¼ˆçˆ¶åˆ†ç±»å¯èƒ½ä¸åœ¨ç­›é€‰ç»“果内）
        Map<Long, String> parentCodeMap = new HashMap<>();
        Map<Long, String> parentNameMap = new HashMap<>();
        for (MesMdItemTypeDO type : itemTypeService.getItemTypeList(new MesMdItemTypeListReqVO())) {
            parentCodeMap.put(type.getId(), type.getCode());
            parentNameMap.put(type.getId(), type.getName());
        }
        // ç»„装导出 VO（补齐上级分类编码/名称、物料产品中文标识）
        List<MesMdItemTypeExcelVO> excelList = new ArrayList<>();
        for (MesMdItemTypeDO type : list) {
            MesMdItemTypeExcelVO excelVO = BeanUtils.toBean(type, MesMdItemTypeExcelVO.class);
            if (type.getParentId() != null && !MesMdItemTypeDO.PARENT_ID_ROOT.equals(type.getParentId())) {
                excelVO.setParentCode(parentCodeMap.get(type.getParentId()));
                excelVO.setParentName(parentNameMap.get(type.getParentId()));
            }
            excelVO.setItemOrProduct(convertItemOrProductToText(type.getItemOrProduct()));
            excelList.add(excelVO);
        }
        // å¯¼å‡º Excel
        ExcelUtils.write(response, "物料分类数据.xls", "物料分类", MesMdItemTypeExcelVO.class, excelList);
    }

    /**
     * å°†ç‰©æ–™/产品标识转换为中文名称
     *
     * @param itemOrProduct å­—典值：ITEM=物料，PRODUCT=产品
     * @return ä¸­æ–‡åç§°
     */
    private String convertItemOrProductToText(String itemOrProduct) {
        if (itemOrProduct == null) {
            return null;
        }
        if ("ITEM".equals(itemOrProduct)) {
            return "物料";
        }
        if ("PRODUCT".equals(itemOrProduct)) {
            return "产品";
        }
        return itemOrProduct;
    }

    @GetMapping("/get-import-template")
    @Operation(summary = "获得导入物料产品分类模板")
    @PreAuthorize("@ss.hasPermission('mes:md-item-type:import')")
    public void importTemplate(HttpServletResponse response) throws IOException {
        List<MesMdItemTypeImportExcelVO> list = Arrays.asList(
                MesMdItemTypeImportExcelVO.builder().code("RAW").name("原材料").itemOrProduct("ITEM").sort(1).status(0).remark("示例：顶级分类").build(),

 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/md/item/vo/type/MesMdItemTypeExcelVO.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,38 @@
package cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.type;

import cn.idev.excel.annotation.ExcelProperty;
import lombok.Data;

/**
 * MES ç‰©æ–™äº§å“åˆ†ç±»å¯¼å‡º Excel VO
 *
 * @author è¶…级管理员
 */
@Data
public class MesMdItemTypeExcelVO {

    @ExcelProperty("分类编码")
    private String code;

    @ExcelProperty("分类名称")
    private String name;

    @ExcelProperty("上级分类编码")
    private String parentCode;

    @ExcelProperty("上级分类名称")
    private String parentName;

    @ExcelProperty("物料/产品")
    private String itemOrProduct;

    @ExcelProperty("排序")
    private Integer sort;

    @ExcelProperty("状态")
    private Integer status;

    @ExcelProperty("备注")
    private String remark;

}