Files
ccdi/docs/reports/implementation/2026-05-06-base-staff-import-template-text-format.md

1.6 KiB
Raw Blame History

员工信息维护导入模板文本格式实施记录

背景

  • 员工信息维护导入模板中,“身份证号”“电话”列需要使用文本单元格格式,避免 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
  • 不改变导入字段、字段顺序、导入校验规则和前端页面逻辑。

验证情况

  • 已执行定向模板单测:
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 列均已执行文本格式设置。
  • 本次未启动前端或后端进程,无需额外清理运行进程。