33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
|
# 员工信息维护导入模板文本格式实施记录
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
|
|||
|
|
- 员工信息维护导入模板中，“身份证号”“电话”列需要使用文本单元格格式，避免 Excel 将长数字或手机号自动识别为数值格式。
|
|||
|
|
- 当前模板生成链路已支持 `@TextFormat` 注解并由 `TextFormatWriteHandler` 统一处理，但员工信息 Sheet 的对应字段未标注该注解。
|
|||
|
|
|
|||
|
|
## 修改内容
|
|||
|
|
|
|||
|
|
- 在 `CcdiBaseStaffExcel` 中为“身份证号”字段增加 `@TextFormat`。
|
|||
|
|
- 在 `CcdiBaseStaffExcel` 中为“电话”字段增加 `@TextFormat`。
|
|||
|
|
- 更新 `EasyExcelUtilTemplateTest`，在员工信息模板测试中断言第 3 列“身份证号”和第 4 列“电话”的默认列格式均为文本格式 `@`。
|
|||
|
|
|
|||
|
|
## 影响范围
|
|||
|
|
|
|||
|
|
- 影响接口：`/ccdi/baseStaff/importTemplate`。
|
|||
|
|
- 影响文件：
|
|||
|
|
- `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/domain/excel/CcdiBaseStaffExcel.java`
|
|||
|
|
- `ccdi-info-collection/src/test/java/com/ruoyi/info/collection/utils/EasyExcelUtilTemplateTest.java`
|
|||
|
|
- 不改变导入字段、字段顺序、导入校验规则和前端页面逻辑。
|
|||
|
|
|
|||
|
|
## 验证情况
|
|||
|
|
|
|||
|
|
- 已执行定向模板单测：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
MAVEN_OPTS="-javaagent:$HOME/.m2/repository/net/bytebuddy/byte-buddy-agent/1.17.8/byte-buddy-agent-1.17.8.jar" mvn -pl ccdi-info-collection -am -Dtest=EasyExcelUtilTemplateTest -Dsurefire.failIfNoSpecifiedTests=false test
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- 验证结果：通过，`EasyExcelUtilTemplateTest` 共 5 个用例，0 失败，0 错误。
|
|||
|
|
- 测试日志确认员工信息 Sheet 第 3 列、第 4 列均已执行文本格式设置。
|
|||
|
|
- 本次未启动前端或后端进程，无需额外清理运行进程。
|