HarmonyHR Cloud - 企业级人力资源管理系统自研-智能Excel导入导出-CSDN博客

上一篇文章地址：https://blog.csdn.net/qq_60870118/article/details/155672039?fromshare=blogdetail&sharetype=blogdetail&sharerId=155672039&sharerefer=PC&sharesource=qq_60870118&sharefrom=from_link

✨ 功能亮点：智能Excel导入导出

智能Excel导入导出

功能概述

系统提供完善的员工数据Excel导入导出功能，支持批量数据处理、智能字段匹配、错误提示等特性，大幅提升HR工作效率。

核心特性

特性	说明
📥 模板下载	提供标准化导入模板，包含所有必填字段说明
📤 批量导出	支持按条件筛选导出员工数据到Excel
🔄 智能匹配	自动匹配部门、职位、职称等关联字段（支持模糊匹配）
⚠️ 错误提示	详细的字段匹配失败提示，精确到行号和具体原因
🔢 自动生成	自动生成工号、计算合同期限、设置默认在职状态
📊 导入统计	实时显示导入成功/失败数量及详细错误列表

导入流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  下载模板    │ -> │  填写数据    │ -> │  上传文件    │ -> │  查看结果    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

智能字段匹配

系统支持以下字段的智能名称匹配：

字段类型	匹配规则	示例
部门	精确匹配 + 路径匹配	“研发部” 或 “总公司/研发部”
职位	精确匹配 + 模糊匹配	“Java开发工程师” 或 “Java开发”
职称	精确匹配 + 模糊匹配	“高级工程师” 或 “高级”
民族	精确匹配	“汉族”、“回族” 等
政治面貌	精确匹配	“群众”、“党员” 等

自动数据处理

处理项	规则说明
工号生成	自动按顺序生成8位工号（如：00000001）
合同期限	根据合同起止日期自动计算，或默认3年
在职状态	未填写时默认设置为"在职"

错误处理机制

当导入数据存在问题时，系统会：

继续导入有效数据 - 不会因部分错误中断整个导入
收集错误信息 - 记录每行的具体错误原因
前端展示详情 - 以表格形式展示错误行号、员工姓名、错误原因

错误提示示例：

第2行 - 张三：部门[研发中心]不存在；职位[Java架构师]不存在
第5行 - 李四：政治面貌[民主党派]不存在

技术实现

后端架构：
├── ExcelUtils.java              # Excel解析工具类
│   ├── importEmployeesWithErrors()  # 带错误收集的导入方法
│   ├── exportEmployees()            # 员工数据导出
│   ├── generateImportTemplate()     # 生成导入模板
│   ├── buildDepartmentMap()         # 构建部门名称映射
│   └── lookupId()                   # 智能ID查找（支持模糊匹配）
├── EmployeeExcelController.java # 导入导出控制器
├── EmployeeService.java         # 员工业务服务
│   └── addEmployees()               # 批量导入（自动生成工号/合同期限）
└── ExcelImportResult.java       # 导入结果DTO

前端架构：
├── Import.vue                   # 导入页面组件
│   ├── 步骤引导                     # 下载模板 -> 填写数据 -> 上传文件 -> 查看结果
│   ├── 拖拽上传                     # 支持拖拽或点击上传
│   ├── 进度显示                     # 实时上传进度
│   └── 结果展示                     # 成功数量 + 错误详情表格
└── api.ts                       # API接口封装

使用注意事项

注意项	说明
📋 使用标准模板	请使用系统提供的模板，不要修改表头
📅 日期格式	统一使用 `YYYY-MM-DD` 格式（如：2025-01-01）
🏢 部门名称	必须与系统中的部门名称一致（支持模糊匹配）
👤 职位职称	建议先在系统中确认可用的职位和职称名称
📦 数据量限制	单次导入建议不超过1000条数据